MailAddress 클래스

정의

네임스페이스:

System.Net.Mail

어셈블리:

System.Net.Mail.dll

어셈블리:

System.dll

어셈블리:

netstandard.dll

전자 메일의 보낸 사람 또는 받는 사람 주소를 나타냅니다.

public ref class MailAddress

public class MailAddress

type MailAddress = class

Public Class MailAddress

상속

Object

MailAddress

예제

다음 코드 예제에서는 , MailAddress및 MailMessage 클래스를 사용하여 SmtpClient전자 메일 메시지를 보내는 방법을 보여 줍니다.

static void CreateCopyMessage( 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 = "Using the SmtpClient class.";
   message->Subject = L"Using the SmtpClient class.";
   message->Body = L"Using this feature, you can send an email message from an application very easily.";
   
   // Add a carbon copy recipient.
   MailAddress^ copy = gcnew MailAddress( L"Notification_List@contoso.com" );
   message->CC->Add( copy );
   SmtpClient^ client = gcnew SmtpClient( server );
   
   // Include credentials if the server requires them.
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   Console::WriteLine( L"Sending an email message to {0} by using the SMTP host {1}.", to->Address, client->Host );
   client->Send( message );
   client->~SmtpClient();
}

public static void CreateCopyMessage(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.Subject = "Using the SmtpClient class.";
    message.Body = @"Using this feature, you can send an email message from an application very easily.";
    // Add a carbon copy recipient.
    MailAddress copy = new MailAddress("Notification_List@contoso.com");
    message.CC.Add(copy);
    SmtpClient client = new SmtpClient(server);
    // Include credentials if the server requires them.
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    Console.WriteLine("Sending an email message to {0} by using the SMTP host {1}.",
         to.Address, client.Host);

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

설명

MailAddress 클래스는 전자 메일 메시지에 대 한 SmtpClient 주소 정보를 저장 하는 클래스에서 MailMessage 사용 됩니다.

메일 주소는 User 이름, Host 이름 및 선택적으로 DisplayName. DisplayName 인코딩하는 경우 ASCII가 아닌 문자를 포함할 수 있습니다.

클래스는 MailAddress 다음 메일 주소 형식을 지원합니다.

• 의 간단한 주소 형식입니다 user@host. DisplayName 설정되지 않은 경우 생성된 메일 주소 형식입니다.

• 표준 따옴표로 묶인 표시 이름 형식입니다 "display name" <user@host>. DisplayName 설정된 경우 생성된 형식입니다.

• 이러한 항목이 포함되지 않은 경우 이름 및 Host 이름 주위에 User 꺾쇠 괄호가 추가됩니다. 예를 들어 . "display name" user@host "display name" <user@host>

• 따옴표는 포함되지 않은 경우 주위에 DisplayName추가됩니다. 예를 들어 . display name <user@host> "display name" <user@host>

• 유니코드 문자는 속성에서 DisplayName 지원됩니다.

• User 따옴표가 있는 이름입니다. 예들 들어 "user name"@host입니다.

• 사용자 이름에 연속 및 후행 점이 있습니다. 예들 들어 user...name..@host입니다.

• 대괄호로 묶인 도메인 리터럴입니다. 예들 들어 <user@[my domain]>입니다.

• 설명. 예들 들어 (comment)"display name"(comment)<(comment)user(comment)@(comment)domain(comment)>(comment)입니다. 주석은 전송 전에 제거됩니다.

쉼표는 메일 주소 목록의 요소를 구분하는 데 사용됩니다. 따라서 목록의 따옴표가 지정되지 않은 표시 이름에는 쉼표를 사용하면 안 됩니다. 다음 메일 주소가 허용됩니다.

"John, Doe" <user@host>, "Bob, Smith" <user2@host>

다음 메일 주소는 허용되지 않습니다.

John, Doe <user@host>, Bob, Smith <user2@host>

따옴표는 따옴표 붙은 문자열에 포함할 수 있지만 이스케이프해야 합니다. 다음 메일 주소가 허용됩니다.

"John \"Jr\" Doe" <user@host>

"\"John \\\"Jr\\\" Doe\" <user@host>"

다음 메일 주소는 허용되지 않습니다.

"John "Jr" Doe" <user@host>

사용자 이름을 따옴표로 묶지 않으면 문자열의 시작 부분(또는 쉼표)과 주소 사이의 모든 텍스트가 주석을 포함하여 해당 항목의 DisplayName일부로 간주됩니다. 예를 들면 다음과 같습니다.

(non comment) unquoted display (non comment) name (non comment) <user@host>

수업에서 MailAddress 메일 주소를 유효한 것으로 허용하지만 다른 메일 서버는 메일 주소를 수락하지 않을 수 있습니다.

클래스는 MailAddress 다음 메일 주소 형식을 지원하지 않습니다.

• 따옴표와 따옴표가 없는 표시 이름이 혼합되어 있습니다. 예들 들어 display "name" <user@host>입니다.

• IETF에서 게시한 RFC 2822 섹션 3.4에 정의된 그룹입니다.

• 또는 .의 "user"."name"@host``user."name"@host "user".name@host사용되지 않는 사용자 이름 형식입니다.

생성자

MailAddress(String)	지정된 주소를 사용하여 MailAddress 클래스의 새 인스턴스를 초기화합니다.
MailAddress(String, String)	지정된 주소 및 표시 이름을 사용하여 MailAddress 클래스의 새 인스턴스를 초기화합니다.
MailAddress(String, String, Encoding)	지정된 주소, 표시 이름 및 인코딩을 사용하여 MailAddress 클래스의 새 인스턴스를 초기화합니다.

속성

Address	이 인스턴스가 만들어질 때 지정된 이메일 주소를 가져옵니다.
DisplayName	이 인스턴스가 만들어질 때 지정된 표시 이름 및 주소 정보에서 구성된 표시 이름을 가져옵니다.
Host	이 인스턴스가 만들어질 때 지정된 주소의 호스트 부분을 가져옵니다.
User	이 인스턴스가 만들어질 때 지정된 주소에서 사용자 정보를 가져옵니다.

메서드

Equals(Object)	두 개의 메일 주소를 비교합니다.
GetHashCode()	메일 주소에 대한 해시 값을 반환합니다.
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
ToString()	이 인스턴스의 문자열 표현을 반환합니다.
TryCreate(String, MailAddress)	새 MailAddress를 만듭니다. 개체를 만들 수 없는 경우 예외를 throw하지 않습니다.
TryCreate(String, String, Encoding, MailAddress)	새 MailAddress를 만듭니다. 개체를 만들 수 없는 경우 예외를 throw하지 않습니다.
TryCreate(String, String, MailAddress)	새 MailAddress를 만듭니다. 개체를 만들 수 없는 경우 예외를 throw하지 않습니다.