SmtpClient.Host Propriedade

Definição

Espaço de Nomes:
System.Net.Mail
Assemblagens:
netstandard.dll, System.Net.Mail.dll
Assemblagem:
System.Net.Mail.dll
Assemblagem:
System.dll
Assemblagem:
netstandard.dll
Origem:
SmtpClient.cs
Origem:
SmtpClient.cs
Origem:
SmtpClient.cs
Origem:
SmtpClient.cs
Origem:
SmtpClient.cs

Obtém ou define o nome ou endereço IP do host usado para transações SMTP.

public:
 property System::String ^ Host { System::String ^ get(); void set(System::String ^ value); };
public string? Host { get; set; }
public string Host { get; set; }
member this.Host : string with get, set
Public Property Host As String

Valor de Propriedade

String

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

Exceções

ArgumentNullException

O valor especificado para uma operação de conjunto é null.

ArgumentException

O valor especificado para uma operação de conjunto é igual a Empty ("").

InvalidOperationException

Não pode alterar o valor desta propriedade quando um email está a ser enviado.

Exemplos

O exemplo de código seguinte demonstra o envio de uma mensagem de email usando o host e a porta especificados num ficheiro de configuração de aplicação.

public static void CreateTestMessage4(string server)
{
    MailAddress from = new MailAddress("ben@contoso.com");
    MailAddress to = new MailAddress("Jane@contoso.com");
    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.";
    SmtpClient client = new SmtpClient(server);
    Console.WriteLine("Sending an email message to {0} by using SMTP host {1} port {2}.",
         to.ToString(), client.Host, client.Port);

    try
    {
        client.Send(message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Exception caught in CreateTestMessage4(): {0}",
            ex.ToString());
    }
}

Observações

O valor da Host propriedade também pode ser definido usando construtores ou o ficheiro de configuração da aplicação ou da máquina. Para mais informações, consulte <Elemento mailSettings> (Configurações de Rede).

Se a informação for especificada usando esta propriedade, esta informação sobrepõe-se às definições do ficheiro de configuração.

Aplica-se a

Ver também