MailAddress コンストラクター

定義

名前空間:

System.Net.Mail

アセンブリ:

netstandard.dll, System.Net.Mail.dll

MailAddress クラスの新しいインスタンスを初期化します。

オーバーロード

名前	説明
MailAddress(String)	指定したアドレスを使用して、 MailAddress クラスの新しいインスタンスを初期化します。
MailAddress(String, String)	指定したアドレスと表示名を使用して、 MailAddress クラスの新しいインスタンスを初期化します。
MailAddress(String, String, Encoding)	指定したアドレス、表示名、およびエンコードを使用して、 MailAddress クラスの新しいインスタンスを初期化します。

MailAddress(String)

ソース:

MailAddress.cs

指定したアドレスを使用して、 MailAddress クラスの新しいインスタンスを初期化します。

public:
 MailAddress(System::String ^ address);

public MailAddress(string address);

new System.Net.Mail.MailAddress : string -> System.Net.Mail.MailAddress

Public Sub New (address As String)

パラメーター

address

String

電子メール アドレスを含む String 。

例外

ArgumentNullException

address は nullです。

ArgumentException

address は Empty ("") です。

FormatException

address が認識された形式ではありません。

例

次のコード例では、このコンストラクターを使用して、電子メール メッセージのBcc受信者のMailAddress オブジェクトを作成します。

public static void CreateBccTestMessage(string server)
{
    MailAddress from = new MailAddress("ben@contoso.com", "Ben Miller");
    MailAddress to = new MailAddress("jane@contoso.com", "Jane Clayton");
    MailMessage message = new MailMessage(from, to);
    message.Subject = "Using the SmtpClient class.";
    message.Body = @"Using this feature, you can send an email message from an application very easily.";
    MailAddress bcc = new MailAddress("manager1@contoso.com");
    message.Bcc.Add(bcc);
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    Console.WriteLine("Sending an email message to {0} and {1}.",
        to.DisplayName, message.Bcc.ToString());

    try
    {
        client.Send(message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Exception caught in CreateBccTestMessage(): {0}",
            ex.ToString());
    }
}

注釈

アドレスを山かっこで囲む場合、 address パラメーターには表示名と関連付けられている電子メール アドレスを含めることができます。 例えば次が挙げられます。

"Tom Smith <tsmith@contoso.com>"

表示名と山かっこの間には空白を使用できます。

次の表は、前の例のアドレスを使用して構築された MailAddress オブジェクトのプロパティ値を示しています。

プロパティ	価値
DisplayName	"Tom Smith"
Host	"contoso.com"
User	"tsmith"
Address	"tsmith@contoso.com"

MailAddress(String, String)

ソース:

MailAddress.cs

指定したアドレスと表示名を使用して、 MailAddress クラスの新しいインスタンスを初期化します。

public:
 MailAddress(System::String ^ address, System::String ^ displayName);

public MailAddress(string address, string? displayName);

new System.Net.Mail.MailAddress : string * string -> System.Net.Mail.MailAddress

Public Sub New (address As String, displayName As String)

パラメーター

address

String

電子メール アドレスを含む String 。

displayName

String

addressに関連付けられた表示名を含むString。 このパラメーターは、null に設定できます。

例外

ArgumentNullException

address は nullです。

ArgumentException

address は Empty ("") です。

FormatException

address が認識された形式ではありません。

-又は-

address には、ASCII 以外の文字が含まれています。

例

次のコード例では、このコンストラクターを使用して、電子メール メッセージの送信者と受信者の MailAddress インスタンスを作成します。

public static void CreateBccTestMessage(string server)
{
    MailAddress from = new MailAddress("ben@contoso.com", "Ben Miller");
    MailAddress to = new MailAddress("jane@contoso.com", "Jane Clayton");
    MailMessage message = new MailMessage(from, to);
    message.Subject = "Using the SmtpClient class.";
    message.Body = @"Using this feature, you can send an email message from an application very easily.";
    MailAddress bcc = new MailAddress("manager1@contoso.com");
    message.Bcc.Add(bcc);
    SmtpClient client = new SmtpClient(server);
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    Console.WriteLine("Sending an email message to {0} and {1}.",
        to.DisplayName, message.Bcc.ToString());

    try
    {
        client.Send(message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Exception caught in CreateBccTestMessage(): {0}",
            ex.ToString());
    }
}

注釈

表示名の先頭と末尾の空白は保持されます。

displayNameに ASCII 以外の文字が含まれている場合、displayName エンコードには iso-8859-1 文字セットが使用されます。 非 ASCII 文字のエンコードについては、RFC 1522 で説明 https://www.ietf.org/。

addressに表示名が含まれており、displayNameがnullされず、String.Emptyと等しくない場合、displayNameはaddressで指定された値をオーバーライドします。

MailAddress(String, String) コンストラクターは、displayName パラメーターが有効かどうかを確認しません。 このメソッドは、 DisplayName プロパティによって表示されない囲み引用符を削除します。 送信前に引用符が追加されます。 UTF8 エンコードは、転送前に DisplayName プロパティに適用されます。

MailAddress(String, String, Encoding)

ソース:

MailAddress.cs

指定したアドレス、表示名、およびエンコードを使用して、 MailAddress クラスの新しいインスタンスを初期化します。

public:
 MailAddress(System::String ^ address, System::String ^ displayName, System::Text::Encoding ^ displayNameEncoding);

public MailAddress(string address, string? displayName, System.Text.Encoding? displayNameEncoding);

new System.Net.Mail.MailAddress : string * string * System.Text.Encoding -> System.Net.Mail.MailAddress

Public Sub New (address As String, displayName As String, displayNameEncoding As Encoding)

パラメーター

address

String

電子メール アドレスを含む String 。

displayName

String

addressに関連付けられた表示名を含むString。

displayNameEncoding

Encoding

displayNameに使用される文字セットを定義するEncoding。

例外

ArgumentNullException

address は nullです。

-又は-

displayName は nullです。

ArgumentException

address は Empty ("") です。

-又は-

displayName は Empty ("") です。

FormatException

address が認識された形式ではありません。

-又は-

address には、ASCII 以外の文字が含まれています。

例

次のコード例では、このコンストラクターを使用して、電子メール メッセージの送信者の MailAddress インスタンスを作成します。

// Create a mailing address that includes a UTF8 character
// in the display name.
MailAddress from = new MailAddress("jane@contoso.com",
   "Jane " + (char)0xD8+ " Clayton",
System.Text.Encoding.UTF8);

' Create a mailing address that includes a UTF8 character
' in the display name.
Dim mailFrom As New MailAddress("jane@contoso.com", "Jane " & ChrW(&HD8) & " Clayton", System.Text.Encoding.UTF8)

注釈

表示名の先頭と末尾の空白は保持されます。

addressに表示名が含まれており、displayNameがnullされず、String.Emptyと等しくない場合、displayNameはaddressで指定された値をオーバーライドします。

MailAddress(String, String, Encoding) コンストラクターは、displayName パラメーターが有効かどうかを確認しません。 このメソッドは、 DisplayName プロパティによって表示されない囲み引用符を削除します。 displayNameEncoding パラメーターにASCIIまたはUnicodeが指定されている場合を除き、送信前に引用符が追加されます。 displayNameEncoding パラメーターで指定されたエンコードは、転送ASCIIまたはUnicodeが displayNameEncoding パラメーターで指定される前に、DisplayName プロパティに適用されます。 UTF8 は、何も指定されていない場合の既定のエンコードです。

サポートされているメール アドレス形式の詳細については、「 MailAddress」を参照してください。