MailAddress 클래스

정의

public ref class MailAddress

public class MailAddress

type MailAddress = class

Public Class MailAddress

상속

Object

MailAddress

예제

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

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 클래스에서 사용 됩니다.

메일 주소는 사용자 이름, 호스트 이름 및 선택적 표시 이름으로 구성됩니다. DisplayName 은 인코딩하는 경우 ASCII가 아닌 문자를 포함할 수 있습니다.

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

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

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

  • 아직 포함되지 않은 경우 이름 및 User 이름 주위에 꺾쇠 괄호가 Host 추가됩니다. 예를 들어 는 "display name" user@host 로 변경됩니다 "display name" <user@host>.
  • 아직 포함되지 않은 경우 따옴표가 주위에 DisplayName추가됩니다. 예를 들어 는 display name <user@host> 로 변경됩니다 "display name" <user@host>.
  • 유니코드 문자는 속성에서 DisplayName 지원됩니다.

이러한 두 형식 내에서 다음 요소가 허용됩니다.

• User 따옴표가 있는 이름입니다. "user name"@host을 예로 들 수 있습니다.
• 대괄호로 묶인 도메인 리터럴입니다. <user@[my domain]>을 예로 들 수 있습니다.
• 코멘트. (comment)"display name"(comment)<(comment)user(comment)@(comment)domain(comment)>(comment)을 예로 들 수 있습니다. 주석은 전송 전에 제거됩니다.
• .NET 9 이전 버전만: 사용자 이름에 연속 및 후행 점이 있습니다. user...name..@host을 예로 들 수 있습니다. (.NET 10부터 연속된 점이 허용되지 않습니다.)

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

"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.
• 10개 이상 버전만 .NET: 사용자 이름에 연속된 점(예: user...name@host.com).