次の方法で共有


MailAddress コンストラクター

定義

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

例外

addressnullです。

addressEmpty ("") です。

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 に設定できます。

例外

addressnullです。

addressEmpty ("") です。

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

例外

addressnullです。

または

displayNamenullです。

addressEmpty ("") です。

または

displayNameEmpty ("") です。

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)

注釈

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

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

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

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

適用対象