Attachment クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Attachment クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

電子メールに添付するデータを表します。

名前空間: System.Net.Mail
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Class Attachment
    Inherits AttachmentBase

Visual Basic (使用法)

Dim instance As Attachment

public class Attachment : AttachmentBase

C++

public ref class Attachment : public
 AttachmentBase

public class Attachment extends AttachmentBase

JScript

public class Attachment extends
 AttachmentBase

解説

Attachment クラスは、MailMessage クラスと共に使用されます。すべてのメッセージには、メッセージの内容を格納している Body が含まれます。本文に加えて、追加のファイルを送信することもできます。これらは添付データとして送信され、Attachment のインスタンスとして表されます。添付データを電子メールメッセージに追加するには、そのファイルを MailMessage.Attachments コレクションに追加します。

添付データの内容には、String、Stream、またはファイル名が指定できます。添付データの内容は、いずれかの Attachment コンストラクタを使用して指定できます。

添付データの MIME の Content-Type ヘッダー情報は、ContentType プロパティによって表されます。Content-Type ヘッダーでは、メディアタイプ、サブタイプ、および関連付けられたパラメータを指定します。添付データに関連付けられているインスタンスを取得するには、ContentType を使用します。

MIME の Content-Disposition ヘッダーは、ContentDisposition プロパティによって表されます。Content-Disposition ヘッダーでは、添付データの表示方法とファイルのタイムスタンプを指定します。Content-Disposition ヘッダーは、添付データがファイルの場合にだけ送信されます。添付データに関連付けられているインスタンスを取得するには、ContentDisposition プロパティを使用します。

MIME の Content-Transfer-Encoding ヘッダーは、TransferEncoding プロパティによって表されます。

使用例

電子メールメッセージにファイルを添付するコード例を次に示します。

public static void CreateMessageWithAttachment(string
 server)
{
    // Specify the file to be attached and sent.
    // This example assumes that a file named Data.xls exists in the
    // current working directory.
    string file = "data.xls";
    // Create a message and set up the recipients.
    MailMessage message = new MailMessage(
       "jane@contoso.com",
       "ben@contoso.com",
       "Quarterly data report.",
       "See the attached spreadsheet.");

    // Create  the file attachment for this e-mail message.
    Attachment data = new Attachment(file, MediaTypeNames.Application.Octet);
    // Add time stamp information for the file.
    ContentDisposition disposition = data.ContentDisposition;
    disposition.CreationDate = System.IO.File.GetCreationTime(file);
    disposition.ModificationDate = System.IO.File.GetLastWriteTime(file);
    disposition.ReadDate = System.IO.File.GetLastAccessTime(file);
    // Add the file attachment to this e-mail message.
    message.Attachments.Add(data);
    //Send the message.
    SmtpClient client = new SmtpClient(server);
    // Add credentials if the SMTP server requires them.
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    client.Send(message);
    // Display the values in the ContentDisposition for the attachment.
    ContentDisposition cd = data.ContentDisposition;
    Console.WriteLine("Content disposition");
    Console.WriteLine(cd.ToString());
    Console.WriteLine("File {0}", cd.FileName);
    Console.WriteLine("Size {0}", cd.Size);
    Console.WriteLine("Creation {0}", cd.CreationDate);
    Console.WriteLine("Modification {0}", cd.ModificationDate);
    Console.WriteLine("Read {0}", cd.ReadDate);
    Console.WriteLine("Inline {0}", cd.Inline);
    Console.WriteLine("Parameters: {0}", cd.Parameters.Count);
    foreach (DictionaryEntry d in cd.Parameters)
    {
        Console.WriteLine("{0} = {1}", d.Key, d.Value);
    }
    data.Dispose();
}