MailAddress Konstruktor

Definisi

Ruang nama:

System.Net.Mail

Rakitan:

System.Net.Mail.dll

Menginisialisasi instans baru kelas MailAddress.

Overload

MailAddress(String)	Menginisialisasi instans MailAddress baru kelas menggunakan alamat yang ditentukan.
MailAddress(String, String)	Menginisialisasi instans MailAddress baru kelas menggunakan alamat dan nama tampilan yang ditentukan.
MailAddress(String, String, Encoding)	Menginisialisasi instans MailAddress baru kelas menggunakan alamat, nama tampilan, dan pengodean yang ditentukan.

MailAddress(String)

Sumber:

MailAddress.cs

Menginisialisasi instans MailAddress baru kelas menggunakan alamat yang ditentukan.

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)

Parameter

address

String

Yang String berisi alamat email.

Pengecualian

ArgumentNullException

addressadalah null.

ArgumentException

address adalah Empty ("").

FormatException

address tidak dalam format yang dikenali.

Contoh

Contoh kode berikut menggunakan konstruktor ini untuk membuat MailAddress objek untuk Bcc penerima pesan email.

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

Keterangan

Parameter address dapat berisi nama tampilan dan alamat email terkait jika Anda mengapit alamat dalam tanda kurung sudut. Contohnya:

"Tom Smith <tsmith@contoso.com>"

Spasi kosong diizinkan antara nama tampilan dan tanda kurung sudut.

Tabel berikut ini memperlihatkan nilai properti untuk objek yang MailAddress dibangun menggunakan alamat contoh sebelumnya.

Properti	Nilai
DisplayName	"Tom Smith"
Host	"contoso.com"
User	"tsmith"
Address	"tsmith@contoso.com"

MailAddress(String, String)

Sumber:

MailAddress.cs

Menginisialisasi instans MailAddress baru kelas menggunakan alamat dan nama tampilan yang ditentukan.

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)

Parameter

address

String

Yang String berisi alamat email.

displayName

String

String yang berisi nama tampilan yang terkait dengan address. Parameter ini dapat berupa null.

Pengecualian

ArgumentNullException

addressadalah null.

ArgumentException

address adalah Empty ("").

FormatException

address tidak dalam format yang dikenali.

-atau-

address berisi karakter non-ASCII.

Contoh

Contoh kode berikut menggunakan konstruktor ini untuk membuat MailAddress instans untuk pengirim dan penerima pesan email.

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

Keterangan

Spasi putih di awal dan akhir dalam nama tampilan dipertahankan.

Jika displayName berisi karakter non-ASCII, set karakter iso-8859-1 digunakan untuk displayName pengodean. Pengodean karakter non-ASCII dibahas dalam RFC 1522, yang tersedia di https://www.ietf.org/.

Jika address berisi nama tampilan, dan displayName tidak dan tidak null sama dengan String.Empty, displayName mengambil alih nilai yang ditentukan dalam address.

MailAddress(String, String, Encoding)

Sumber:

MailAddress.cs

Menginisialisasi instans MailAddress baru kelas menggunakan alamat, nama tampilan, dan pengodean yang ditentukan.

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)

Parameter

address

String

Yang String berisi alamat email.

displayName

String

String yang berisi nama tampilan yang terkait dengan address.

displayNameEncoding

Encoding

Encoding yang mendefinisikan set karakter yang digunakan untuk displayName.

Pengecualian

ArgumentNullException

addressadalah null.

-atau-

displayNameadalah null.

ArgumentException

address adalah Empty ("").

-atau-

displayName adalah Empty ("").

FormatException

address tidak dalam format yang dikenali.

-atau-

address berisi karakter non-ASCII.

Contoh

Contoh kode berikut menggunakan konstruktor ini untuk membuat MailAddress instans untuk pengirim pesan email.

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

Keterangan

Spasi putih di awal dan akhir dalam nama tampilan dipertahankan.

Jika address berisi nama tampilan, dan displayName tidak dan tidak null sama dengan String.Empty, displayName mengambil alih nilai yang ditentukan dalam address.

Metode MailAddress ini tidak memeriksa apakah displayName parameter valid. Metode ini menghapus tanda kutip di sekitarnya yang tidak ditampilkan oleh DisplayName properti . Tanda kutip akan ditambahkan sebelum transmisi, kecuali di mana ASCII atau Unicode ditentukan dalam displayNameEncoding parameter . Pengodean yang ditentukan dalam displayNameEncoding parameter akan diterapkan ke DisplayName properti sebelum transmisi ASCII atau Unicode ditentukan dalam displayNameEncoding parameter . UTF8 adalah pengodean default jika tidak ada yang ditentukan.

Untuk informasi selengkapnya tentang format alamat email yang didukung, lihat MailAddress.