SmtpClient.Host 屬性

定義

命名空間:

System.Net.Mail

組件:

System.Net.Mail.dll

來源:

SmtpClient.cs

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

C#

public string? Host { get; set; }

屬性值

String

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

例外狀況

ArgumentNullException

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

ArgumentException

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

InvalidOperationException

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

範例

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

C#

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> 元素 (網路設定)