SmtpClient Construtores
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
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.