SmtpClient Construtores

Definição

Inicializa uma nova instância da SmtpClient classe.

Sobrecargas

Name Description
SmtpClient()

Inicializa uma nova instância da SmtpClient classe usando as definições do ficheiro de configuração.

SmtpClient(String)

Inicializa uma nova instância da SmtpClient classe que envia emails usando o servidor SMTP especificado.

SmtpClient(String, Int32)

Inicializa uma nova instância da SmtpClient classe que envia emails usando o servidor SMTP e a porta especificados.

SmtpClient()

Origem:
SmtpClient.cs
Origem:
SmtpClient.cs
Origem:
SmtpClient.cs
Origem:
SmtpClient.cs
Origem:
SmtpClient.cs

Inicializa uma nova instância da SmtpClient classe usando as definições do ficheiro de configuração.

public:
 SmtpClient();
public SmtpClient();
Public Sub New ()

Exemplos

O exemplo de código seguinte demonstra o envio de uma mensagem de email.

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 um exemplo do <nó mailSettings> no ficheiro de configuração da aplicação ou máquina, veja <Elemento mailSettings> (Configurações de Rede).

Observações

Este construtor inicializa os Host, , e Credentials propriedades para o novo Port usando as definições nos ficheiros de configuração da aplicação SmtpClientou da máquina. Para mais informações, consulte <Elemento mailSettings> (Configurações de Rede).

Aplica-se a

SmtpClient(String)

Origem:
SmtpClient.cs
Origem:
SmtpClient.cs
Origem:
SmtpClient.cs
Origem:
SmtpClient.cs
Origem:
SmtpClient.cs

Inicializa uma nova instância da SmtpClient classe que envia emails usando o 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

A String que contém o nome ou endereço IP do computador anfitrião utilizado para transações SMTP.

Exemplos

O exemplo de código seguinte demonstra chamar este construtor.

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

Observações

O host parâmetro é usado para inicializar o valor da Host propriedade. As Credentials propriedades e Port são inicializadas usando as definições nos ficheiros de configuração da aplicação ou da máquina. Se host for null igual a String.Empty, Host é inicializado usando as definições nos ficheiros de configuração da aplicação ou da máquina.

Para mais informações sobre a utilização dos ficheiros de configuração da aplicação e da máquina, consulte <mailSettings> Element (Network Settings). Se a informação for especificada usando SmtpClient construtores ou propriedades, esta informação sobrepõe-se às definições do ficheiro de configuração.

Aplica-se a

SmtpClient(String, Int32)

Origem:
SmtpClient.cs
Origem:
SmtpClient.cs
Origem:
SmtpClient.cs
Origem:
SmtpClient.cs
Origem:
SmtpClient.cs

Inicializa uma nova instância da SmtpClient classe que envia emails usando o servidor SMTP e a porta 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

A String que contém o nome ou endereço IP do host utilizado para transações SMTP.

port
Int32

Um Int32 maior que zero que contém a porta a ser usada em host.

Exceções

port não pode ser inferior a zero.

Exemplos

O exemplo de código seguinte demonstra chamar este construtor.

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

Observações

Os host parâmetros e port definem o valor das Host propriedades e Port , respetivamente. Se host for null igual a String.Empty, Host é inicializado usando as definições nos ficheiros de configuração da aplicação ou da máquina. Se port for zero, Port é inicializado usando as definições nos ficheiros de configuração da aplicação ou da máquina. A Credentials propriedade é inicializada usando as definições nos ficheiros de configuração da aplicação ou da máquina.

Para mais informações sobre a utilização dos ficheiros de configuração da aplicação e da máquina, consulte <mailSettings> Element (Network Settings). Se a informação for especificada usando SmtpClient construtores ou propriedades, esta informação sobrepõe-se às definições do ficheiro de configuração.

Aplica-se a