MailAddress Konstruktorer

Definition

Namnområde:: System.Net.Mail

Sammansättningar:: netstandard.dll, System.Net.Mail.dll

Sammansättning:: System.Net.Mail.dll

Sammansättning:: System.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Initierar en ny instans av MailAddress klassen.

Överlagringar

Name	Description
MailAddress(String)	Initierar en ny instans av MailAddress klassen med den angivna adressen.
MailAddress(String, String)	Initierar en ny instans av MailAddress klassen med den angivna adressen och visningsnamnet.
MailAddress(String, String, Encoding)	Initierar en ny instans av MailAddress klassen med den angivna adressen, visningsnamnet och kodningen.

MailAddress(String)

Källa:: MailAddress.cs

Källa:: MailAddress.cs

Källa:: MailAddress.cs

Källa:: MailAddress.cs

Källa:: MailAddress.cs

Initierar en ny instans av MailAddress klassen med den angivna adressen.

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)

Parametrar

address: String

En String som innehåller en e-postadress.

Undantag

ArgumentNullException

address är null.

ArgumentException

address är Empty ("").

FormatException

address är inte i ett igenkänt format.

Exempel

I följande kodexempel används den här konstruktorn för att skapa ett MailAddress objekt för Bcc mottagaren av ett e-postmeddelande.

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

Kommentarer

Parametern address kan innehålla ett visningsnamn och den associerade e-postadressen om du omger adressen inom vinkelparenteser. Ett exempel:

"Tom Smith <tsmith@contoso.com>"

Tomt utrymme tillåts mellan visningsnamnet och vinkelparenteserna.

I följande tabell visas egenskapsvärdena för ett MailAddress objekt som skapats med hjälp av föregående exempeladress.

Fastighet	Value
DisplayName	`"Tom Smith"`
Host	`"contoso.com"`
User	`"tsmith"`
Address	`"tsmith@contoso.com"`

Gäller för

MailAddress(String, String)

Källa:: MailAddress.cs

Källa:: MailAddress.cs

Källa:: MailAddress.cs

Källa:: MailAddress.cs

Källa:: MailAddress.cs

Initierar en ny instans av MailAddress klassen med den angivna adressen och visningsnamnet.

public:
 MailAddress(System::String ^ address, System::String ^ displayName);

public MailAddress(string address, 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)

Parametrar

address: String

En String som innehåller en e-postadress.

displayName: String

A String som innehåller visningsnamnet som är associerat med address. Den här parametern kan vara null.

Undantag

ArgumentNullException

address är null.

ArgumentException

address är Empty ("").

FormatException

address är inte i ett igenkänt format.

-eller-

address innehåller icke-ASCII-tecken.

Exempel

I följande kodexempel används den här konstruktorn för att skapa MailAddress instanser för avsändaren och mottagaren av ett e-postmeddelande.

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

Kommentarer

Inledande och avslutande blanksteg i visningsnamnet bevaras.

Om displayName innehåller icke-ASCII-tecken används teckenuppsättningen iso-8859-1 för displayName kodningen. Kodning av icke-ASCII-tecken beskrivs i RFC 1522, som finns på https://www.ietf.org/.

Om address innehåller ett visningsnamn och displayName inte null är och inte är lika med String.EmptydisplayName åsidosätter det värde som anges i address.

Konstruktorn MailAddress(String, String) kontrollerar inte om parametern displayName är giltig. Den här metoden tar bort omgivande citattecken som inte visas av egenskapen DisplayName . Citattecken läggs till före överföring. UTF8 kodning kommer att tillämpas på DisplayName egenskapen före överföring.

Gäller för

MailAddress(String, String, Encoding)

Källa:: MailAddress.cs

Källa:: MailAddress.cs

Källa:: MailAddress.cs

Källa:: MailAddress.cs

Källa:: MailAddress.cs

Initierar en ny instans av MailAddress klassen med den angivna adressen, visningsnamnet och kodningen.

public:
 MailAddress(System::String ^ address, System::String ^ displayName, System::Text::Encoding ^ displayNameEncoding);

public MailAddress(string address, 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)

Parametrar

address: String

En String som innehåller en e-postadress.

displayName: String

A String som innehåller visningsnamnet som är associerat med address.

displayNameEncoding: Encoding

Som Encoding definierar teckenuppsättningen som används för displayName.

Undantag

ArgumentNullException

address är null.

-eller-

displayName är null.

ArgumentException

address är Empty ("").

-eller-

displayName är Empty ("").

FormatException

address är inte i ett igenkänt format.

-eller-

address innehåller icke-ASCII-tecken.

Exempel

I följande kodexempel används den här konstruktorn för att skapa MailAddress instanser för avsändaren av ett e-postmeddelande.

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

Kommentarer

Inledande och avslutande blanksteg i visningsnamnet bevaras.

Om address innehåller ett visningsnamn och displayName inte null är och inte är lika med String.EmptydisplayName åsidosätter det värde som anges i address.

Konstruktorn MailAddress(String, String, Encoding) kontrollerar inte om parametern displayName är giltig. Den här metoden tar bort omgivande citattecken som inte visas av egenskapen DisplayName . Citattecken läggs till före överföring, förutom där ASCII eller Unicode anges i parametern displayNameEncoding . Kodningen som anges i parametern displayNameEncoding tillämpas på DisplayName egenskapen före överföring ASCII eller Unicode anges i parametern displayNameEncoding . UTF8 är standardkodningen om ingen har angetts.

Mer information om e-postadressformat som stöds finns i MailAddress.

Gäller för

Feedback

Var den här sidan till hjälp?