ContentDisposition クラス

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

ContentDisposition クラス

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

MIME プロトコルの Content-Disposition ヘッダーを表します。

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

Visual Basic (宣言)

Public Class ContentDisposition

Visual Basic (使用法)

Dim instance As ContentDisposition

C#

public class ContentDisposition

C++

public ref class ContentDisposition

J#

public class ContentDisposition

JScript

public class ContentDisposition

解説

電子メール メッセージが送信先に送信されるとき、添付データを格納している電子メール メッセージに ContentDisposition クラスの情報が関連付けられます。電子メールを表示するソフトウェアは ContentDisposition の情報を使用して、電子メールの添付データを差出人が意図した方法で表示します。

電子メール メッセージは、MailMessage クラスのインスタンスを使用して作成します。Attachment クラスのインスタンスは、添付データを電子メール メッセージに追加するために使用されます。添付データに対する ContentDisposition を変更するには、Attachment.ContentDisposition プロパティからそのインスタンスを取得します。

メッセージ本文の一部として表示されるコンテンツの配置タイプは、Inline です。表示されずに別ファイルとして添付されているコンテンツの配置タイプは、Attachment です。Inline プロパティを使用して、ContentDisposition のインスタンスに関連付けられた添付データの配置タイプを制御します。

添付ファイルについては、ContentDisposition のプロパティを使用して、ファイル サイズ、ファイルの作成日付、最終読み取り日付、および最終変更日付を設定できます。すべての添付データに対して、受信側のコンピュータで添付データが格納される場合に推奨するファイル名を設定できます。

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

使用例

添付データを含んだ電子メール メッセージを作成し、インラインで表示するコード例を次に示します。

C#

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

    // Attach the message string to this e-mail message.
    Attachment data = new Attachment(textMessage, MediaTypeNames.Text.Plain);
    // Send textMessage as part of the e-mail body.
    message.Attachments.Add(data);
    ContentDisposition disposition = data.ContentDisposition;
    disposition.Inline = true;
    //Send the message.
    // Include credentials if the server requires them.
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    client.Send(message);
    data.Dispose();
}

継承階層

System.Object
  System.Net.Mime.ContentDisposition

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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 メンバ
System.Net.Mime 名前空間