SmtpClient.Host 屬性

定義

命名空間:

System.Net.Mail

組件:

System.Net.Mail.dll

來源:

SmtpClient.cs

取得或設定用於 SMTP 交易的主機名稱或 IP 位址。

public:
 property System::String ^ Host { System::String ^ get(); void set(System::String ^ value); };

public string? Host { get; set; }

member this.Host : string with get, set

Public Property Host As String

屬性值

String

String，包含用於 SMTP 交易的電腦名稱或 IP 位址。

例外狀況

ArgumentNullException

為設定作業指定的值為 null。

ArgumentException

為設定作業指定的值等於 Empty ("")。

InvalidOperationException

正在傳送電子郵件時，無法變更這個屬性的值。

範例

下列程式代碼範例示範如何使用應用程式組態檔中指定的主機和埠來傳送電子郵件訊息。

static void CreateTestMessage4( String^ server )
{
   MailAddress^ from = gcnew MailAddress( L"ben@contoso.com" );
   MailAddress^ to = gcnew MailAddress( L"Jane@contoso.com" );
   MailMessage^ message = gcnew MailMessage( from,to );
   message->Subject = L"Using the SmtpClient class.";
   message->Body = L"Using this feature, you can send an email message from an application very easily.";
   SmtpClient^ client = gcnew SmtpClient( server );
   Console::WriteLine( L"Sending an email message to {0} by using SMTP host {1} port {2}.", to, client->Host, client->Port );
   client->Send( message );
   client->~SmtpClient();
}

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

備註

您也可以使用建構函式或應用程式或計算機組態檔來設定 屬性的值 Host 。 如需詳細資訊，請參閱 <mailSettings> 元素 (網路設定) 。

如果使用這個屬性指定資訊，這項資訊會覆寫組態檔設定。

另請參閱

• SmtpSection
• SmtpNetworkElement
• Host
• Port
• mailSettings for system.net
• <smtp> 元素 (網路設定)
• <network> 元素 (網路設定)