MailAddress Klas

Definitie

public ref class MailAddress

public class MailAddress

type MailAddress = class

Public Class MailAddress

Overname

Object

MailAddress

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een e-mailbericht verzendt met behulp van de SmtpClient, MailAddressen MailMessage klassen.

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

Opmerkingen

De MailAddress klasse wordt gebruikt door de SmtpClient en MailMessage klassen om adresgegevens voor e-mailberichten op te slaan.

Een e-mailadres bestaat uit een gebruikersnaam, hostnaam en een optionele weergavenaam. DisplayName mag niet-ASCII-tekens bevatten als u deze coderen.

De MailAddress klasse ondersteunt de volgende indelingen voor e-mailadressen:

• Een eenvoudige adresindeling van user@host. Als een DisplayName niet is ingesteld, is dit de indeling van het e-mailadres dat wordt gegenereerd.

• Een standaardweergavenaamnotatie tussen aanhalingsvermeldingen van "display name" <user@host>. Als een DisplayName set is ingesteld, is dit de indeling die wordt gegenereerd.

  • Als ze nog niet zijn opgenomen, worden punthaken toegevoegd rond de User naam en Host naam. Wordt bijvoorbeeld "display name" user@host gewijzigd in "display name" <user@host>.
  • Als ze nog niet zijn opgenomen, worden aanhalingstekens toegevoegd rond de DisplayName. Wordt bijvoorbeeld display name <user@host> gewijzigd in "display name" <user@host>.
  • Unicode-tekens worden ondersteund in de DisplayName eigenschap.

Binnen deze twee indelingen zijn de volgende elementen toegestaan:

• Een User naam met aanhalingstekens. Bijvoorbeeld: "user name"@host.
• Letterlijke haken van domein. Bijvoorbeeld: <user@[my domain]>.
• Opmerkingen. Bijvoorbeeld: (comment)"display name"(comment)<(comment)user(comment)@(comment)domain(comment)>(comment). Opmerkingen worden verwijderd vóór verzending.
• .NET 9 en eerder: Opeenvolgende en volgpunten in gebruikersnamen. Bijvoorbeeld: user...name..@host. (Vanaf .NET 10 zijn opeenvolgende puntjes niet toegestaan.)

Een komma wordt gebruikt om elementen in een lijst met e-mailadressen te scheiden. Als gevolg hiervan mag een komma niet worden gebruikt in niet-aanhalingstekens in een lijst. De volgende e-mailadressen zijn toegestaan:

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

Het volgende e-mailadres is niet toegestaan:

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

Aanhalingstekens kunnen worden ingesloten in een tekenreeks tussen aanhalingstekens, maar ze moeten worden ontsnapt. De volgende e-mailadressen zijn toegestaan:

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

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

Het volgende e-mailadres is niet toegestaan:

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

Wanneer de gebruikersnaam niet wordt geciteerd, wordt alle tekst tussen het begin van de tekenreeks (of komma) en het adres beschouwd als onderdeel van de DisplayName, inclusief opmerkingen. Voorbeeld:

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

Hoewel de MailAddress klasse een e-mailadres als geldig accepteert, accepteren andere e-mailservers het e-mailadres mogelijk niet.

De MailAddress klasse biedt geen ondersteuning voor de volgende indelingen voor e-mailadressen:

• Gemengde weergavenamen tussen aanhaling en niet-aanhalingeerde weergavenamen. Bijvoorbeeld: display "name" <user@host>.
• Groepen, zoals gedefinieerd in RFC 2822 Section 3.4 gepubliceerd door de IETF.
• De verouderde indelingen van de gebruikersnaam van "user"."name"@host, user."name"@host of "user".name@host.
• .NET alleen 10 en nieuwere versies: opeenvolgende punten in de gebruikersnaam, bijvoorbeeld user...name@host.com.