ContentDisposition.FileName プロパティ

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

ContentDisposition.FileName プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

電子メールの添付データに割り当てられているファイル名を取得または設定します。

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

Visual Basic (宣言)

Public Property FileName As
 String

Visual Basic (使用法)

Dim instance As ContentDisposition
Dim value As String

value = instance.FileName

instance.FileName = value

C#

public string FileName { get;
 set; }

C++

public:
property String^ FileName {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_FileName ()

/** @property */
public void set_FileName (String value)

JScript

public function get FileName
 () : String

public function set FileName
 (value : String)

プロパティ値
ファイル名を格納している String。

解説

FileName プロパティによって、差出人は、電子メールの添付データが受信者のコンピュータに格納されるときに使用される名前を割り当てることができます。この名前は単に推奨値であり、受信側のシステムはこの値を無視できます。この名前にパス情報を含むことはできません。このような情報は受信側のコンピュータによって無視されます。

ファイル名情報を削除するには、このプロパティを null 参照 (Visual Basic では Nothing) または空の文字列 ("") に設定します。

Content-Disposition ヘッダーは、RFC 2183 (http://www.ietf.org を参照) に記述されています。

使用例

このプロパティの値を設定する方法を次のコード例に示します。

C#

public static void CreateMessageAttachment1(string
 server, string textMessage)
{
    // Create a message and set up the recipients.
    MailMessage message = new MailMessage(
       "jane@contoso.com",
       "ben@contoso.com",
       "A text message for you.",
       "Message: ");

    // Attach the message string to this e-mail message.
    Attachment data = new Attachment(textMessage, MediaTypeNames.Text.Plain);
    ContentDisposition disposition = data.ContentDisposition;
    // Suggest a file name for the attachment.
    disposition.FileName = "message" + DateTime.Now.ToString();
    message.Attachments.Add(data);
    //Send the message.
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    client.Send(message);
    // Display the values in the ContentDisposition for the attachment.
    Console.WriteLine("Content disposition");
    Console.WriteLine(disposition.ToString());
    Console.WriteLine("File {0}", disposition.FileName);
    Console.WriteLine("Size {0}", disposition.Size);
    Console.WriteLine("Creation {0}", disposition.CreationDate);
    Console.WriteLine("Modification {0}", disposition.ModificationDate);
    Console.WriteLine("Read {0}", disposition.ReadDate);
    Console.WriteLine("Inline {0}", disposition.Inline);
    Console.WriteLine("Parameters: {0}", disposition.Parameters.Count);
    foreach (DictionaryEntry d in disposition.Parameters)
    {
        Console.WriteLine("{0} = {1}", d.Key, d.Value);
    }
    data.Dispose();
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ContentDisposition クラス
ContentDisposition メンバ
System.Net.Mime 名前空間