MailAddress Constructores

Referencia

Definición

Espacio de nombres:: System.Net.Mail

Ensamblado:: System.Net.Mail.dll

Ensamblado:: System.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Inicializa una nueva instancia de la clase MailAddress.

Sobrecargas

MailAddress(String)	Inicializa una nueva instancia de la clase MailAddress usando la dirección especificada.
MailAddress(String, String)	Inicializa una nueva instancia de la clase MailAddress usando la dirección y el nombre para mostrar especificados.
MailAddress(String, String, Encoding)	Inicializa una nueva instancia de la clase MailAddress utilizando la dirección, el nombre para mostrar y la codificación que se hayan especificado.

MailAddress(String)

Source:: MailAddress.cs

Source:: MailAddress.cs

Source:: MailAddress.cs

Inicializa una nueva instancia de la clase MailAddress usando la dirección especificada.

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)

Parámetros

address: String

Elemento String que contiene una dirección de correo electrónico.

Excepciones

ArgumentNullException

address es null.

ArgumentException

address es Empty ("").

FormatException

address no es un formato reconocido.

Ejemplos

En el ejemplo de código siguiente se usa este constructor para crear un MailAddress objeto para el Bcc destinatario de un mensaje de correo electrónico.

static void CreateBccTestMessage( 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 = L"Using the SmtpClient class.";
   message->Body = L"Using this feature, you can send an email message from an application very easily.";
   MailAddress^ bcc = gcnew MailAddress( L"manager1@contoso.com" );
   message->Bcc->Add( bcc );
   SmtpClient^ client = gcnew SmtpClient( server );
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   Console::WriteLine( L"Sending an email message to {0} and {1}.", to->DisplayName, message->Bcc );
   try
   { 
       client->Send( message );
   }
   catch ( Exception^ ex )
   {
       Console::WriteLine(L"Exception caught in CreateBccTestMessage(): {0}", 
                     ex->ToString() );
   }
   client->~SmtpClient();
}

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

Comentarios

El address parámetro puede contener un nombre para mostrar y la dirección de correo electrónico asociada si incluye la dirección entre corchetes angulares. Por ejemplo:

"Tom Smith <tsmith@contoso.com>"

Se permite el espacio en blanco entre el nombre para mostrar y los corchetes angulares.

En la tabla siguiente se muestran los valores de propiedad de un MailAddress objeto construido mediante la dirección de ejemplo anterior.

Propiedad.	Valor
DisplayName	`"Tom Smith"`
Host	`"contoso.com"`
User	`"tsmith"`
Address	`"tsmith@contoso.com"`

Se aplica a

MailAddress(String, String)

Source:: MailAddress.cs

Source:: MailAddress.cs

Source:: MailAddress.cs

Inicializa una nueva instancia de la clase MailAddress usando la dirección y el nombre para mostrar especificados.

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)

Parámetros

address: String

Elemento String que contiene una dirección de correo electrónico.

displayName: String

String que contiene el nombre para mostrar asociado a address. Este parámetro puede ser null.

Excepciones

ArgumentNullException

address es null.

ArgumentException

address es Empty ("").

FormatException

address no es un formato reconocido.

O bien

El parámetro address contiene caracteres que no son ASCII.

Ejemplos

En el ejemplo de código siguiente se usa este constructor para crear MailAddress instancias para el remitente y el destinatario de un mensaje de correo electrónico.

static void CreateBccTestMessage( 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 = L"Using the SmtpClient class.";
   message->Body = L"Using this feature, you can send an email message from an application very easily.";
   MailAddress^ bcc = gcnew MailAddress( L"manager1@contoso.com" );
   message->Bcc->Add( bcc );
   SmtpClient^ client = gcnew SmtpClient( server );
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   Console::WriteLine( L"Sending an email message to {0} and {1}.", to->DisplayName, message->Bcc );
   try
   { 
       client->Send( message );
   }
   catch ( Exception^ ex )
   {
       Console::WriteLine(L"Exception caught in CreateBccTestMessage(): {0}", 
                     ex->ToString() );
   }
   client->~SmtpClient();
}

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

Comentarios

Se conserva el espacio en blanco inicial y final en el nombre para mostrar.

Si displayName contiene caracteres no ASCII, el juego de caracteres iso-8859-1 se usa para la displayName codificación. La codificación de caracteres no ASCII se describe en RFC 1522, que está disponible en https://www.ietf.org/.

Si address contiene un nombre para mostrar y displayName no null es y no es igual a String.Empty, displayName invalida el valor especificado en address.

Se aplica a

MailAddress(String, String, Encoding)

Source:: MailAddress.cs

Source:: MailAddress.cs

Source:: MailAddress.cs

Inicializa una nueva instancia de la clase MailAddress utilizando la dirección, el nombre para mostrar y la codificación que se hayan especificado.

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)

Parámetros

address: String

Elemento String que contiene una dirección de correo electrónico.

displayName: String

Objeto String que contiene el nombre para mostrar asociado al parámetro address.

displayNameEncoding: Encoding

Objeto Encoding que define el juego de caracteres utilizado para el parámetro displayName.

Excepciones

ArgumentNullException

address es null.

O bien

displayName es null.

ArgumentException

address es Empty ("").

O bien

displayName es Empty ("").

FormatException

address no es un formato reconocido.

O bien

El parámetro address contiene caracteres que no son ASCII.

Ejemplos

En el ejemplo de código siguiente se usa este constructor para crear MailAddress instancias para el remitente de un mensaje de correo electrónico.

// Create a mailing address that includes a UTF8 
// character in the display name.
MailAddress^ from = gcnew MailAddress("jane@contoso.com",
    "Jane " + (wchar_t)0xD8 + " Clayton",
    System::Text::Encoding::UTF8);

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

Comentarios

Se conserva el espacio en blanco inicial y final en el nombre para mostrar.

Si address contiene un nombre para mostrar y displayName no null es y no es igual a String.Empty, displayName invalida el valor especificado en address.

El MailAddress método no comprueba si el displayName parámetro es válido. Este método quita las comillas circundantes no mostradas por la DisplayName propiedad . Las comillas se agregarán antes de la transmisión, excepto cuando ASCII se especifique o Unicode en el displayNameEncoding parámetro . La codificación especificada en el displayNameEncoding parámetro se aplicará a la propiedad antes de la DisplayName transmisión ASCII o Unicode se especifique en el displayNameEncoding parámetro . UTF8 es la codificación predeterminada si no se especifica ninguna.

Para obtener más información sobre los formatos de dirección de correo admitidos, vea MailAddress.

Se aplica a

MailAddress Constructores

Definición

Sobrecargas

MailAddress(String)

Parámetros

Excepciones

Ejemplos

Comentarios

Se aplica a

MailAddress(String, String)

Parámetros

Excepciones

Ejemplos

Comentarios

Se aplica a

MailAddress(String, String, Encoding)

Parámetros

Excepciones

Ejemplos

Comentarios

Se aplica a

Comentarios

Recursos adicionales