MailAddress コンストラクター

リファレンス

定義

名前空間:: System.Net.Mail

アセンブリ:: System.Net.Mail.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

オーバーロード

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

MailAddress(String)

ソース:: MailAddress.cs

ソース:: MailAddress.cs

ソース:: 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 が、認識される形式ではありません。

例

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

static void CreateBccTestMessage( String^ server )
{
   MailAddress^ from = gcnew MailAddress( L"ben@contoso.com",L"Ben Miller" );
   MailAddress^ to = gcnew MailAddress( L"jane@contoso.com",L"Jane Clayton" );
   MailMessage^ message = gcnew MailMessage( from,to );
   message->Subject = L"Using the SmtpClient class.";
   message->Body = L"Using this feature, you can send an email message from an application very easily.";
   MailAddress^ bcc = gcnew MailAddress( L"manager1@contoso.com" );
   message->Bcc->Add( bcc );
   SmtpClient^ client = gcnew SmtpClient( server );
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   Console::WriteLine( L"Sending an email message to {0} and {1}.", to->DisplayName, message->Bcc );
   try
   { 
       client->Send( message );
   }
   catch ( Exception^ ex )
   {
       Console::WriteLine(L"Exception caught in CreateBccTestMessage(): {0}", 
                     ex->ToString() );
   }
   client->~SmtpClient();
}

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.cs

ソース:: MailAddress.cs

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

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

public MailAddress (string address, 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 します。

static void CreateBccTestMessage( String^ server )
{
   MailAddress^ from = gcnew MailAddress( L"ben@contoso.com",L"Ben Miller" );
   MailAddress^ to = gcnew MailAddress( L"jane@contoso.com",L"Jane Clayton" );
   MailMessage^ message = gcnew MailMessage( from,to );
   message->Subject = L"Using the SmtpClient class.";
   message->Body = L"Using this feature, you can send an email message from an application very easily.";
   MailAddress^ bcc = gcnew MailAddress( L"manager1@contoso.com" );
   message->Bcc->Add( bcc );
   SmtpClient^ client = gcnew SmtpClient( server );
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   Console::WriteLine( L"Sending an email message to {0} and {1}.", to->DisplayName, message->Bcc );
   try
   { 
       client->Send( message );
   }
   catch ( Exception^ ex )
   {
       Console::WriteLine(L"Exception caught in CreateBccTestMessage(): {0}", 
                     ex->ToString() );
   }
   client->~SmtpClient();
}

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

注釈

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

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

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

適用対象

MailAddress(String, String, Encoding)

ソース:: MailAddress.cs

ソース:: MailAddress.cs

ソース:: 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);

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 = gcnew MailAddress("jane@contoso.com",
    "Jane " + (wchar_t)0xD8 + " Clayton",
    System::Text::Encoding::UTF8);

// 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)

注釈

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

パラメーターがMailAddress有効な場合、メソッドはdisplayNameチェックされません。このメソッドは、プロパティで表示されない周囲の引用符を DisplayName 削除します。引用符は、パラメーターでまたは Unicode が指定されている場合ASCIIを除き、送信前にdisplayNameEncoding追加されます。パラメーターでdisplayNameEncoding指定されたエンコードは、送信ASCII Unicode前に DisplayName プロパティに適用されるか、 displayNameEncoding パラメーターで指定されます。 UTF8 は、何も指定されていない場合の既定のエンコードです。

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

適用対象

次の方法で共有

MailAddress コンストラクター

定義

オーバーロード

MailAddress(String)

パラメーター

例外

例

注釈

適用対象

MailAddress(String, String)

パラメーター

例外

例

注釈

適用対象

MailAddress(String, String, Encoding)

パラメーター

例外

例

注釈

適用対象

その他のリソース