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)

Source:: MailAddress.cs

Source:: MailAddress.cs

Source:: 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)

Source:: MailAddress.cs

Source:: MailAddress.cs

Source:: 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)

Source:: MailAddress.cs

Source:: MailAddress.cs

Source:: 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)

설명

표시 이름의 선행 공백과 후행 공백은 유지됩니다.

에 표시 이름이 포함되어 있고 displayName 가 이 아니 null 고 와 같지 displayNameString.Empty않은 경우 address 에 address지정된 값을 재정의합니다.

매개 변수가 MailAddress 유효한 경우 메서드는 displayName 검사 않습니다. 이 메서드는 속성에 의해 표시되지 DisplayName 않는 주변 따옴표를 제거합니다. 매개 변수에 또는 Unicode 가 지정된 경우 ASCII 를 제외하고 전송 전에 따옴표가 displayNameEncoding 추가됩니다. 매개 변수에 displayNameEncoding 지정된 인코딩은 전송 ASCII Unicode 전에 속성에 DisplayName 적용되거나 매개 변수에 displayNameEncoding 지정됩니다. UTF8 가 지정되지 않은 경우 기본 인코딩입니다.

지원되는 메일 주소 형식에 대한 자세한 내용은 를 참조하세요 MailAddress.

적용 대상

다음을 통해 공유

MailAddress 생성자

정의

오버로드

MailAddress(String)

매개 변수

예외

예제

설명

적용 대상

MailAddress(String, String)

매개 변수

예외

예제

설명

적용 대상

MailAddress(String, String, Encoding)

매개 변수

예외

예제

설명

적용 대상

추가 리소스