SmtpClient Constructores
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 SmtpClient.
SmtpClient() |
Inicializa una nueva instancia de la clase SmtpClient usando la configuración del archivo de configuración. |
SmtpClient(String) |
Inicializa una nueva instancia de la clase SmtpClient que envía correo electrónico con el servidor SMTP especificado. |
SmtpClient(String, Int32) |
Inicializa una nueva instancia de la clase SmtpClient que envía correo electrónico con el servidor SMTP y el puerto especificados. |
- Source:
- SmtpClient.cs
- Source:
- SmtpClient.cs
- Source:
- SmtpClient.cs
Inicializa una nueva instancia de la clase SmtpClient usando la configuración del archivo de configuración.
public:
SmtpClient();
public SmtpClient ();
Public Sub New ()
Ejemplos
En el ejemplo de código siguiente se muestra cómo enviar un mensaje de correo electrónico.
static void CreateTestMessage3()
{
MailAddress^ to = gcnew MailAddress( L"jane@contoso.com" );
MailAddress^ from = gcnew MailAddress( L"ben@contoso.com" );
MailMessage^ message = gcnew MailMessage( from,to );
message->Subject = L"Using the new SMTP client.";
message->Body = L"Using this new feature, you can send an email message from an application very easily.";
// Use the application or machine configuration to get the
// host, port, and credentials.
SmtpClient^ client = gcnew SmtpClient;
Console::WriteLine( L"Sending an email message to {0} at {1} by using the SMTP host {2}.", to->User, to->Host, client->Host );
client->Send( message );
}
public static void CreateTestMessage3()
{
MailAddress to = new MailAddress("jane@contoso.com");
MailAddress from = new MailAddress("ben@contoso.com");
MailMessage message = new MailMessage(from, to);
message.Subject = "Using the new SMTP client.";
message.Body = @"Using this new feature, you can send an email message from an application very easily.";
// Use the application or machine configuration to get the
// host, port, and credentials.
SmtpClient client = new SmtpClient();
Console.WriteLine("Sending an email message to {0} at {1} by using the SMTP host={2}.",
to.User, to.Host, client.Host);
client.Send(message);
}
Para obtener un ejemplo del <nodo mailSettings> en el archivo de configuración de la aplicación o máquina, vea <elemento mailSettings> (Configuración de red).
Comentarios
Este constructor inicializa las Hostpropiedades , Credentialsy Port para el nuevo SmtpClient mediante la configuración de los archivos de configuración de la aplicación o del equipo. Para obtener más información, vea <elemento mailSettings> (Configuración de red) .
Se aplica a
.NET 9 y otras versiones
Producto | Versiones |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
- Source:
- SmtpClient.cs
- Source:
- SmtpClient.cs
- Source:
- SmtpClient.cs
Inicializa una nueva instancia de la clase SmtpClient que envía correo electrónico con el servidor SMTP especificado.
public:
SmtpClient(System::String ^ host);
public SmtpClient (string? host);
public SmtpClient (string host);
new System.Net.Mail.SmtpClient : string -> System.Net.Mail.SmtpClient
Public Sub New (host As String)
Parámetros
- host
- String
Objeto String que contiene el nombre o la dirección IP del equipo host utilizado para las transacciones SMTP.
Ejemplos
En el ejemplo de código siguiente se muestra cómo llamar a este constructor.
static void CreateTimeoutTestMessage( String^ server )
{
String^ to = L"jane@contoso.com";
String^ from = L"ben@contoso.com";
String^ subject = L"Using the new SMTP client.";
String^ body = L"Using this new feature, you can send an email message from an application very easily.";
MailMessage^ message = gcnew MailMessage( from,to,subject,body );
SmtpClient^ client = gcnew SmtpClient( server );
Console::WriteLine( L"Changing time out from {0} to 100.", client->Timeout );
client->Timeout = 100;
// Credentials are necessary if the server requires the client
// to authenticate before it will send email on the client's behalf.
client->Credentials = CredentialCache::DefaultNetworkCredentials;
client->Send( message );
}
public static void CreateTimeoutTestMessage(string server)
{
string to = "jane@contoso.com";
string from = "ben@contoso.com";
string subject = "Using the new SMTP client.";
string body = @"Using this new feature, you can send an email message from an application very easily.";
MailMessage message = new MailMessage(from, to, subject, body);
SmtpClient client = new SmtpClient(server);
Console.WriteLine("Changing time out from {0} to 100.", client.Timeout);
client.Timeout = 100;
// Credentials are necessary if the server requires the client
// to authenticate before it will send email on the client's behalf.
client.Credentials = CredentialCache.DefaultNetworkCredentials;
client.Send(message);
}
Comentarios
El host
parámetro se usa para inicializar el valor de la Host propiedad . Las Credentials propiedades y Port se inicializan mediante la configuración de los archivos de configuración de la aplicación o del equipo. Si host
es null
o igual a String.Empty, Host se inicializa mediante la configuración de los archivos de configuración de la aplicación o del equipo.
Para obtener más información sobre el uso de los archivos de configuración de la aplicación y la máquina, vea <elemento mailSettings> (Configuración de red). Si se especifica información mediante SmtpClient constructores o propiedades, esta información invalida los valores del archivo de configuración.
Se aplica a
.NET 9 y otras versiones
Producto | Versiones |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
- Source:
- SmtpClient.cs
- Source:
- SmtpClient.cs
- Source:
- SmtpClient.cs
Inicializa una nueva instancia de la clase SmtpClient que envía correo electrónico con el servidor SMTP y el puerto especificados.
public:
SmtpClient(System::String ^ host, int port);
public SmtpClient (string? host, int port);
public SmtpClient (string host, int port);
new System.Net.Mail.SmtpClient : string * int -> System.Net.Mail.SmtpClient
Public Sub New (host As String, port As Integer)
Parámetros
- host
- String
Objeto String que contiene el nombre o la dirección IP del host utilizado para las transacciones SMTP.
Excepciones
El parámetro port
no puede ser menor que cero.
Ejemplos
En el ejemplo de código siguiente se muestra cómo llamar a este constructor.
static void CreateTestMessage1( String^ server, int port )
{
String^ to = L"jane@contoso.com";
String^ from = L"ben@contoso.com";
String^ subject = L"Using the new SMTP client.";
String^ body = L"Using this new feature, you can send an email message from an application very easily.";
MailMessage^ message = gcnew MailMessage( from,to,subject,body );
SmtpClient^ client = gcnew SmtpClient( server,port );
// Credentials are necessary if the server requires the client
// to authenticate before it will send email on the client's behalf.
client->Credentials = CredentialCache::DefaultNetworkCredentials;
client->Send( message );
client->~SmtpClient();
}
public static void CreateTestMessage1(string server, int port)
{
string to = "jane@contoso.com";
string from = "ben@contoso.com";
string subject = "Using the new SMTP client.";
string body = @"Using this new feature, you can send an email message from an application very easily.";
MailMessage message = new MailMessage(from, to, subject, body);
SmtpClient client = new SmtpClient(server, port);
// Credentials are necessary if the server requires the client
// to authenticate before it will send email on the client's behalf.
client.Credentials = CredentialCache.DefaultNetworkCredentials;
client.Send(message);
}
Comentarios
Los host
parámetros y port
establecen el valor de las Host propiedades y Port , respectivamente. Si host
es null
o igual a String.Empty, Host se inicializa mediante la configuración de los archivos de configuración de la aplicación o del equipo. Si port
es cero, Port se inicializa con la configuración de los archivos de configuración de la aplicación o de la máquina. La Credentials propiedad se inicializa mediante la configuración de los archivos de configuración de la aplicación o del equipo.
Para obtener más información sobre el uso de los archivos de configuración de la aplicación y la máquina, vea <elemento mailSettings> (Configuración de red). Si se especifica información mediante SmtpClient constructores o propiedades, esta información invalida los valores del archivo de configuración.
Se aplica a
.NET 9 y otras versiones
Producto | Versiones |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
Comentarios de .NET
.NET es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: