ContentDisposition.DispositionType プロパティ

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

ContentDisposition.DispositionType プロパティ

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

電子メールの添付データの配置タイプを取得または設定します。

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

Visual Basic (宣言)

Public Property DispositionType As
 String

Visual Basic (使用法)

Dim instance As ContentDisposition
Dim value As String

value = instance.DispositionType

instance.DispositionType = value

C#

public string DispositionType { get;
 set; }

C++

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

J#

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

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

JScript

public function get DispositionType
 () : String

public function set DispositionType
 (value : String)

プロパティ値
配置タイプを格納している String。値の制限はありませんが、通常、いずれかの DispositionType 値です。

例外

例外の種類	条件
ArgumentNullException	設定操作として指定した値が null 参照 (Visual Basic では Nothing) です。
ArgumentException	設定操作として指定した値が String.Empty ("") です。

解説

電子メールを表示するソフトウェアは DispositionType プロパティ値を使用して、電子メールの添付データを表示する正しい方法を決定することもあります。Inline 添付データは、通常、ユーザーが電子メールを開いたときに表示されます。Attachment 添付データは、通常、ユーザーが添付データを表すアイコンをクリックするなどのアクションを実行するまで開きません。

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

使用例

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

C#

public static void CreateMessageWithAttachment4(string
 server, string to)
{
    // Specify the file to be attached and sent.
    // This example uses a file on a UNC share.
    string file = @"\\share3\c$\reports\data.xls";
    // Create a message and set up the recipients.
    MailMessage message = new MailMessage(
       "ReportMailer@contoso.com",
       to,
       "Quarterly data report",
       "See the attached spreadsheet.");

    // Create  the file attachment for this e-mail message.
    Attachment data = new Attachment("qtr3.xls", 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);
    disposition.DispositionType = DispositionTypeNames.Attachment;
    // 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 = (ICredentialsByHost)CredentialCache.DefaultNetworkCredentials;
    client.Send(message);
    // Display the message headers.
    string[] keys = message.Headers.AllKeys;
    Console.WriteLine("Headers");
    foreach (string s in
 keys)
    {
        Console.WriteLine("{0}:", s);
        Console.WriteLine("    {0}", message.Headers[s]);
    }
    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 名前空間