SmtpClient Construtores

Definição

Namespace:

System.Net.Mail

Assembly:

System.Net.Mail.dll

Inicializa uma nova instância da classe SmtpClient.

Sobrecargas

SmtpClient()	Inicializa uma nova instância da classe SmtpClient usando as definições do arquivo de configuração.
SmtpClient(String)	Inicializa uma nova instância da classe SmtpClient, que envia o email usando o servidor SMTP especificado.
SmtpClient(String, Int32)	Inicializa uma nova instância da classe SmtpClient, que envia emails usando o servidor SMTP e a porta especificados.

SmtpClient()

Origem:

SmtpClient.cs

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

public:
 SmtpClient();

public SmtpClient ();

Public Sub New ()

Exemplos

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

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 obter um exemplo do <nó mailSettings> no arquivo de configuração do aplicativo ou do computador, consulte <Elemento mailSettings> (Configurações de Rede).

Comentários

Esse construtor inicializa as Hostpropriedades , Credentialse Port para o novo SmtpClient usando as configurações nos arquivos de configuração do aplicativo ou do computador. Para obter mais informações, consulte <Elemento mailSettings> (Configurações de Rede).

SmtpClient(String)

Origem:

SmtpClient.cs

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

public:
 SmtpClient(System::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

Um String que contém o nome ou endereço IP do computador host usado para transações de SMTP.

Exemplos

O exemplo de código a seguir demonstra a chamada desse construtor.

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

Comentários

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

Para obter mais informações sobre como usar os arquivos de configuração do aplicativo e do computador, consulte <Elemento mailSettings> (Configurações de Rede). Se as informações forem especificadas usando SmtpClient construtores ou propriedades, essas informações substituirão as configurações do arquivo de configuração.

SmtpClient(String, Int32)

Origem:

SmtpClient.cs

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

public:
 SmtpClient(System::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

Um String que contém o nome ou endereço IP do host usado para transações de SMTP.

port

Int32

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

Exceções

ArgumentOutOfRangeException

port não pode ser menor que zero.

Exemplos

O exemplo de código a seguir demonstra a chamada desse construtor.

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

Comentários

Os host parâmetros e port definem o valor das Host propriedades e Port , respectivamente. Se host for null ou igual a String.Empty, Host será inicializado usando as configurações nos arquivos de configuração do aplicativo ou do computador. Se port for zero, Port será inicializado usando as configurações nos arquivos de configuração do aplicativo ou do computador. A Credentials propriedade é inicializada usando as configurações nos arquivos de configuração do aplicativo ou do computador.

Para obter mais informações sobre como usar os arquivos de configuração do aplicativo e do computador, consulte <Elemento mailSettings> (Configurações de Rede). Se as informações forem especificadas usando SmtpClient construtores ou propriedades, essas informações substituirão as configurações do arquivo de configuração.