Attachment コンストラクタ

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

Attachment コンストラクタ (String)

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

コンテンツの文字列を指定して、Attachment クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    fileName As String _
)

Visual Basic (使用法)

Dim fileName As String

Dim instance As New Attachment(fileName)

C#

public Attachment (
    string fileName
)

C++

public:
Attachment (
    String^ fileName
)

J#

public Attachment (
    String fileName
)

JScript

public function Attachment (
    fileName : String
)

パラメータ

fileName

この添付データを作成するために使用するファイル パスを格納している String。

例外

例外の種類	条件
ArgumentNullException	fileName が null 参照 (Visual Basic では Nothing) です。
ArgumentException	fileName が空です。

解説

このプロパティは次のように設定されます。

プロパティ	値
MediaType	Plain
TransferEncoding	QuotedPrintable

使用例

このコンストラクタを呼び出す方法を次のコード例に示します。

C#

public static void CreateMessageInlineAttachment2(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);
    // Send textMessage as part of the e-mail body.
    message.Attachments.Add(data);
    ContentType content = data.ContentType;
    content.MediaType = MediaTypeNames.Text.Plain;
    //Send the message.
    // Include credentials if the server requires them.
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    client.Send(message);
    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

参照

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

Attachment コンストラクタ (Stream, String, String)

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

ストリーム、名前、および MIME タイプの情報を指定して、Attachment クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    contentStream As Stream, _
    name As String, _
    mediaType As String _
)

Visual Basic (使用法)

Dim contentStream As Stream
Dim name As String
Dim mediaType As String

Dim instance As New Attachment(contentStream,
 name, mediaType)

C#

public Attachment (
    Stream contentStream,
    string name,
    string mediaType
)

C++

public:
Attachment (
    Stream^ contentStream, 
    String^ name, 
    String^ mediaType
)

J#

public Attachment (
    Stream contentStream, 
    String name, 
    String mediaType
)

JScript

public function Attachment (
    contentStream : Stream, 
    name : String, 
    mediaType : String
)

パラメータ

contentStream

この添付の内容を格納している読み取り可能な Stream。

name

この添付データに関連付けられている ContentType の Name プロパティの値を格納している String。この値は、null 参照 (Visual Basic では Nothing) の場合もあります。

mediaType

この添付データの MIME コンテンツ ヘッダー情報を格納している String。この値は、null 参照 (Visual Basic では Nothing) の場合もあります。

例外

例外の種類	条件
ArgumentNullException	stream が null 参照 (Visual Basic では Nothing) です。
FormatException	mediaType の形式が正しくありません。

解説

mediaType が null 参照 (Visual Basic では Nothing) でないか、String.Empty ("") と等しい場合は、この添付データに関連付けられた ContentType クラスの構築に使用されます。

mediaType と name の両方に Name 情報が格納されている場合、name で指定された値が使用されます。TransferEncoding プロパティが Base64 に設定されています。

ストリームの CanSeek プロパティが false の場合、添付データとそのデータを格納している MailMessage は再利用できません。添付データを再利用するには、検索できるストリームを指定する必要があります。

使用例

このコンストラクタを呼び出す方法を次のコード例に示します。

C#

// The following example sends a summary of a log file as the message
// and the log as an e-mail attachment.
public static void SendNamedAndTypedErrorLog(string
 server, string recipientList)
{
    // Create a message from logMailer@contoso.com to recipientList.
    MailMessage message = new MailMessage(
       "logMailer@contoso.com", recipientList);

    message.Subject = "Error Log report";
    string fileName = "log.txt";
    // Get the file stream for the error log.
    // Requires the System.IO namespace.
    FileStream fs = new FileStream(fileName, FileMode.Open, FileAccess.Read);
    StreamReader s = new StreamReader(fs);
    int errors = 0;
    while (s.ReadLine() != null)
    {
        // Process each line from the log file here.
        errors++;
    }
    // The e-mail message summarizes the data found in the log.
    message.Body = String.Format("{0} errors in log as of
 {1}",
        errors, DateTime.Now);
    // Close the stream reader. This also closes the file.
    s.Close();
    // Re-open the file at the beginning to make the attachment.
    fs = new FileStream(fileName, FileMode.Open, FileAccess.Read);
    // Create a name for the log data file.
    string name = "log" + DateTime.Now.ToString() +
 ".txt";
    // Create the attachment, name it, and specify the MIME type.
    Attachment data = new Attachment(fs, name, MediaTypeNames.Text.Plain);
    // Add the attachment to the message.
    message.Attachments.Add(data);
    // Send the message.
    // Include credentials if the server requires them.
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    client.Send(message);
    data.Dispose();
    // Close the log file.
    fs.Close();
}

プラットフォーム

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

参照

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

Attachment コンストラクタ (Stream, String)

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

ストリームと名前を指定して、Attachment クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    contentStream As Stream, _
    name As String _
)

Visual Basic (使用法)

Dim contentStream As Stream
Dim name As String

Dim instance As New Attachment(contentStream,
 name)

C#

public Attachment (
    Stream contentStream,
    string name
)

C++

public:
Attachment (
    Stream^ contentStream, 
    String^ name
)

J#

public Attachment (
    Stream contentStream, 
    String name
)

JScript

public function Attachment (
    contentStream : Stream, 
    name : String
)

パラメータ

contentStream

この添付の内容を格納している読み取り可能な Stream。

name

この添付データに関連付けられている ContentType の Name プロパティの値を格納している String。この値は、null 参照 (Visual Basic では Nothing) の場合もあります。

例外

例外の種類	条件
ArgumentNullException	contentStream が null 参照 (Visual Basic では Nothing) です。

解説

name が null 参照 (Visual Basic では Nothing) でないか、String.Empty ("") と等しい場合、この添付データの ContentType は name に設定されている Name プロパティを使用して生成されます。TransferEncoding プロパティが Base64 に設定されています。

ストリームの CanSeek プロパティが false の場合、添付データとそのデータを格納している MailMessage は再利用できません。添付データを再利用するには、検索できるストリームを指定する必要があります。

使用例

このコンストラクタを呼び出す方法を次のコード例に示します。

C#

// The following example sends a summary of a log file as the message
// and the log as an e-mail attachment.
public static void SendNamedErrorLog(string
 server, string recipientList)
{
    // Create a message from logMailer@contoso.com to recipientList.
    MailMessage message = new MailMessage(
       "logMailer@contoso.com", recipientList);

    message.Subject = "Error Log report";
    string fileName = "log.txt";
    // Get the file stream for the error log.
    // Requires the System.IO namespace.
    FileStream fs = new FileStream(fileName, FileMode.Open, FileAccess.Read);
    StreamReader s = new StreamReader(fs);
    int errors = 0;
    while (s.ReadLine() != null)
    {
        // Process each line from the log file here.
        errors++;
    }
    // The e-mail message summarizes the data found in the log.
    message.Body = String.Format("{0} errors in log as of
 {1}",
        errors, DateTime.Now);
    // Close the stream reader. This also closes the file.
    s.Close();
    // Re-open the file at the beginning to make the attachment.
    fs = new FileStream(fileName, FileMode.Open, FileAccess.Read);
    // Make a ContentType indicating that the log data
    // that is attached is plain text and is named.
    ContentType ct = new ContentType();
    ct.MediaType = MediaTypeNames.Text.Plain;
    ct.Name = "log" + DateTime.Now.ToString() + ".txt";
    // Create the attachment.
    Attachment data = new Attachment(fs, ct);
    // Add the attachment to the message.
    message.Attachments.Add(data);
    // Send the message.
    // Include credentials if the server requires them.
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    client.Send(message);
    data.Dispose();
    // Close the log file.
    fs.Close();
    return;
}

プラットフォーム

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

参照

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

Attachment コンストラクタ (String, String)

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

コンテンツの文字列と MIME タイプの情報を指定して、Attachment クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    fileName As String, _
    mediaType As String _
)

Visual Basic (使用法)

Dim fileName As String
Dim mediaType As String

Dim instance As New Attachment(fileName,
 mediaType)

C#

public Attachment (
    string fileName,
    string mediaType
)

C++

public:
Attachment (
    String^ fileName, 
    String^ mediaType
)

J#

public Attachment (
    String fileName, 
    String mediaType
)

JScript

public function Attachment (
    fileName : String, 
    mediaType : String
)

パラメータ

fileName

この添付の内容を格納している String。

mediaType

この添付データの MIME コンテンツ ヘッダー情報を格納している String。この値は、null 参照 (Visual Basic では Nothing) の場合もあります。

例外

例外の種類	条件
ArgumentNullException	fileName が null 参照 (Visual Basic では Nothing) です。
FormatException	mediaType の形式が正しくありません。

解説

mediaType が null 参照 (Visual Basic では Nothing) か、または String.Empty ("") と等しい場合、この添付データの MediaType プロパティは Plain に設定されます。mediaType が null 参照 (Visual Basic では Nothing) でなく、長さが 0 の文字列でもない場合は、この添付データに関連付けられた ContentType の生成に使用されます。

使用例

このコンストラクタを呼び出す方法を次のコード例に示します。

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();
}

プラットフォーム

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

参照

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

Attachment コンストラクタ (Stream, ContentType)

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

ストリームとコンテンツ タイプを指定して、Attachment クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    contentStream As Stream, _
    contentType As ContentType _
)

Visual Basic (使用法)

Dim contentStream As Stream
Dim contentType As ContentType

Dim instance As New Attachment(contentStream,
 contentType)

C#

public Attachment (
    Stream contentStream,
    ContentType contentType
)

C++

public:
Attachment (
    Stream^ contentStream, 
    ContentType^ contentType
)

J#

public Attachment (
    Stream contentStream, 
    ContentType contentType
)

JScript

public function Attachment (
    contentStream : Stream, 
    contentType : ContentType
)

パラメータ

contentStream

この添付の内容を格納している読み取り可能な Stream。

contentType

stream 内のデータを説明する ContentType。

例外

例外の種類	条件
ArgumentNullException	contentType が null 参照 (Visual Basic では Nothing) です。 または contentStream が null 参照 (Visual Basic では Nothing) です。

解説

TransferEncoding プロパティが Base64 に設定されています。

ストリームの CanSeek プロパティが false の場合、添付データとそのデータを格納している MailMessage は再利用できません。添付データを再利用するには、検索できるストリームを指定する必要があります。

使用例

このコンストラクタを呼び出す方法を次のコード例に示します。

C#

// The following example sends a summary of a log file as the message
// and the log as an e-mail attachment.
public static void SendErrorLog(string
 server, string recipientList)
{
    // Create a message from logMailer@contoso.com to recipientList.
    MailMessage message = new MailMessage(
       "logMailer@contoso.com", recipientList);

    message.Subject = "Error Log report";
    string fileName = "log.txt";
    // Get the file stream for the error log.
    // Requires the System.IO namespace.
    FileStream fs = new FileStream(fileName, FileMode.Open, FileAccess.Read);
    StreamReader s = new StreamReader(fs);
    int errors = 0;
    while (s.ReadLine() != null)
    {
        // Process each line from the log file here.
        errors++;
    }
    // The e-mail message summarizes the data found in the log.
    message.Body = String.Format("{0} errors in log as of
 {1}",
        errors, DateTime.Now);
    // Close the stream reader. This also closes the file.
    s.Close();
    // Re-open the file at the beginning to make the attachment.
    fs = new FileStream(fileName, FileMode.Open, FileAccess.Read);
    // Make a contentType indicating that the log data
    // that is attached is plain text.
    ContentType ct = new ContentType(MediaTypeNames.Text.Plain);
    // Attach the log file stream to the e-mail message.
    Attachment data = new Attachment(fs, ct);
    ContentDisposition disposition = data.ContentDisposition;
    // Suggest a file name for the attachment.
    disposition.FileName = "log" + DateTime.Now.ToString() + ".txt";
    // Add the attachment to the message.
    message.Attachments.Add(data);
    // Send the message.
    // Include credentials if the server requires them.
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    client.Send(message);
    data.Dispose();
    // Close the log file.
    fs.Close();
}

プラットフォーム

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

参照

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

Attachment コンストラクタ (String, ContentType)

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

コンテンツの文字列と ContentType を指定して、Attachment クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    fileName As String, _
    contentType As ContentType _
)

Visual Basic (使用法)

Dim fileName As String
Dim contentType As ContentType

Dim instance As New Attachment(fileName,
 contentType)

C#

public Attachment (
    string fileName,
    ContentType contentType
)

C++

public:
Attachment (
    String^ fileName, 
    ContentType^ contentType
)

J#

public Attachment (
    String fileName, 
    ContentType contentType
)

JScript

public function Attachment (
    fileName : String, 
    contentType : ContentType
)

パラメータ

fileName

この添付データを作成するために使用するファイル パスを格納している String。

contentType

string 内のデータを説明する ContentType。

例外

例外の種類	条件
ArgumentNullException	fileName が null 参照 (Visual Basic では Nothing) です。
ArgumentException	mediaType の形式が正しくありません。

プラットフォーム

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

参照

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

Attachment コンストラクタ

Attachment クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
Attachment (String)	コンテンツの文字列を指定して、Attachment クラスの新しいインスタンスを初期化します。
Attachment (Stream, ContentType)	ストリームとコンテンツ タイプを指定して、Attachment クラスの新しいインスタンスを初期化します。
Attachment (Stream, String)	ストリームと名前を指定して、Attachment クラスの新しいインスタンスを初期化します。
Attachment (String, ContentType)	コンテンツの文字列と ContentType を指定して、Attachment クラスの新しいインスタンスを初期化します。
Attachment (String, String)	コンテンツの文字列と MIME タイプの情報を指定して、Attachment クラスの新しいインスタンスを初期化します。
Attachment (Stream, String, String)	ストリーム、名前、および MIME タイプの情報を指定して、Attachment クラスの新しいインスタンスを初期化します。

参照

関連項目

Attachment クラス
Attachment メンバ
System.Net.Mail 名前空間