MailAddress Constructors

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)

Parameters

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld wordt deze constructor gebruikt om een MailAddress object te maken voor de Bcc ontvanger van een e-mailbericht.

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

Opmerkingen

De address parameter kan een weergavenaam en het bijbehorende e-mailadres bevatten als u het adres tussen punthaken plaatst. Voorbeeld:

"Tom Smith <tsmith@contoso.com>"

Witruimte is toegestaan tussen de weergavenaam en de hoekhaken.

In de volgende tabel ziet u de eigenschapswaarden voor een MailAddress object dat is samengesteld met behulp van het voorgaande voorbeeldadres.

public:
 MailAddress(System::String ^ address, System::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)

Parameters

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld wordt deze constructor gebruikt om exemplaren te maken MailAddress voor de afzender en ontvanger van een e-mailbericht.

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

Opmerkingen

Voorloop- en volgspaties in de weergavenaam blijven behouden.

Als displayName deze niet-ASCII-tekens bevat, wordt de iso-8859-1 tekenset gebruikt voor de displayName codering. Het coderen van niet-ASCII-tekens wordt besproken in RFC 1522, die beschikbaar is op https://www.ietf.org/.

Als address een weergavenaam bevat en displayName niet null gelijk is aan en niet gelijk is aan String.Empty, displayName overschrijft u de waarde die is opgegeven in address.

De MailAddress(String, String) constructor controleert niet of de displayName parameter geldig is. Met deze methode worden omringende aanhalingstekens verwijderd die niet door de DisplayName eigenschap worden weergegeven. Aanhalingstekens worden toegevoegd voor verzending. UTF8 encoding wordt toegepast op de DisplayName eigenschap vóór verzending.

public:
 MailAddress(System::String ^ address, System::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)

Parameters

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld wordt deze constructor gebruikt om exemplaren te maken MailAddress voor de afzender van een e-mailbericht.

// 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)

Opmerkingen

Voorloop- en volgspaties in de weergavenaam blijven behouden.

Als address een weergavenaam bevat en displayName niet null gelijk is aan en niet gelijk is aan String.Empty, displayName overschrijft u de waarde die is opgegeven in address.

De MailAddress(String, String, Encoding) constructor controleert niet of de displayName parameter geldig is. Met deze methode worden omringende aanhalingstekens verwijderd die niet door de DisplayName eigenschap worden weergegeven. Aanhalingstekens worden toegevoegd vóór verzending, behalve waar ASCII of Unicode is opgegeven in de displayNameEncoding parameter. De codering die in de displayNameEncoding parameter is opgegeven, wordt toegepast op de DisplayName eigenschap vóór verzending ASCII of Unicode is opgegeven in de displayNameEncoding parameter. UTF8 is de standaardcodering als er geen is opgegeven.

Zie MailAddressvoor meer informatie over ondersteunde indelingen voor e-mailadressen.