다음을 통해 공유


MailAddress 클래스

정의

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

public ref class MailAddress
public class MailAddress
type MailAddress = class
Public Class MailAddress
상속
MailAddress

예제

다음 코드 예제에서는 , MailAddressMailMessage 클래스를 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());
    }
}

설명

클래스는 MailAddressMailMessage 클래스에서 SmtpClient 전자 메일 메시지의 주소 정보를 저장하는 데 사용됩니다.

메일 주소는 이름, Host 이름 및 선택적으로 DisplayName로 구성 User 됩니다. 인 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"@hostuser."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하지 않습니다.

적용 대상