共用方式為

<網路> 元素 (網路設定)

  • 發行項

設定外部簡易郵件傳輸通訊協定 (SMTP) 伺服器的網路選項。

<configuration>
  <system.net>
    <mailSettings>
      <smtp>
        <network>

Syntax

<network  
  clientDomain="string"
  defaultCredentials="true|false"  
  enableSsl="true|false"  
  host="string"
  password="string"  
  port="integer"
  targetName="string"  
  userName="string"  
/>

屬性和項目

下列章節說明屬性、子元素和父元素。

屬性

屬性 描述
clientDomain 指定要在初始 SMTP 通訊協定要求用來連線到 SMTP 郵件伺服器的用戶端網域名稱。 預設值是傳送要求的本機電腦的 localhost 名稱。
defaultCredentials 指定是否應使用預設使用者認證存取 SMTP 郵件伺服器以進行 SMTP 交易。 預設值是 false。
enableSsl 指定是否使用 SSL 存取 SMTP 郵件伺服器。 預設值是 false。
host 指定用於 SMTP 交易的 SMTP 郵件伺服器的主機名稱。 此屬性沒有預設值。
password 指定用於驗證 SMTP 郵件伺服器的密碼。 此屬性沒有預設值。
port 指定用於連接到 SMTP 郵件伺服器的連接埠號碼。 預設值為 25。
targetName 指定在對 SMTP 交易使用擴充保護時，用於驗證的服務提供者名稱 (SPN)。 此屬性沒有預設值。
userName 指定用於驗證 SMTP 郵件伺服器的使用者名稱。 此屬性沒有預設值。

子元素

無。

父項目

元素 描述
<smtp> 元素 (網路設定) 設定簡易郵件傳輸通訊協定 (SMTP) 郵件傳送選項。

備註

部分 SMTP 伺服器要求您在使用前向伺服器進行驗證。 若要使用主機的預設網路認證自行驗證，請將 defaultCredentials 屬性設定為 true。 SmtpNetworkElement.DefaultCredentials 屬性可用來從適用的組態檔取得目前 defaultCredentials 屬性的值。

您也可以使用基本驗證 (使用者名稱及密碼 ) 向 SMTP 伺服器驗證自己。 若要使用此選項，必須為指定的 SMTP 伺服器指定有效的使用者名稱與密碼。

注意

基本驗證會將 userName 及 password 值傳送至未加密的伺服器。 任何監視流量的任何人都可檢視您的認證，並使用它們連線到伺服器。 應考慮使用更安全的驗證機制，例如 Kerberos 或 NT LAN Manager (NTLM)。如果 defaultCredentials 是 true，則伺服器支援這些通訊協定，則會使用 Kerberos 或 NTLM。

基本驗證及預設網路認證選項互斥；如果將 defaultCredentials 設定為 true 並指定使用者名稱及密碼，則使用預設網路認證，並忽略基本驗證資料。

對於基本驗證，如果指定 userName，則應指定 password 向郵件伺服器自行驗證。

SmtpNetworkElement.UserName 屬性可用來從適用的組態檔取得 userName 屬性的目前值。 SmtpNetworkElement.Password 屬性可用來從適用的組態檔取得 password 屬性的目前值。 基於安全性原因，通常不會在配置檔輸入 password 屬性。

clientDomain 屬性將初始 SMTP 通訊協定要求使用的用戶端網域名稱變更為 SMTP 伺服器。 clientDomain 屬性可設定為本機電腦的完整網域名稱，而不是預設使用的 localhost 名稱。 這更符合 SMTP 通訊協定合規性標準。 預設值是傳送要求的本機電腦的 localhost 名稱。 SmtpNetworkElement.ClientDomain 屬性可用來從適用的組態檔取得 clientDomain 屬性的目前值。

使用擴充保護時，targetName 屬性用於驗證。 預設值的形式為 "SMTPSVC/<host>"，其中 <host> 是 SMTP 郵件伺服器的主機名稱。 SmtpNetworkElement.TargetName 屬性可用來從適用的組態檔取得 targetName 屬性的目前值。

enableSsl 屬性指定是否使用 SSL 存取 SMTP 郵件伺服器。 類別 System.Net.Mail.SmtpClient 僅支援 RFC 3207 所定義透過傳輸層安全性安全 SMTP 的 SMTP 服務延伸模組。 在此模式，SMTP 工作階段會從未加密的通道開始，然後用戶端向伺服器發出 STARTTLS 命令，以切換到使用 SSL 的安全通訊。 如需詳細資訊，請參閱網際網路標準組織 (IETF) 發佈的 RFC 3207。

替代連線方法是在傳送任何通訊協定命令之前預先建立 SSL 工作階段。 此連線方法有時稱為 SMTPS，預設會使用連接埠 465。 目前不支援使用 SSL 的替代連線方法。

SmtpNetworkElement.EnableSsl 屬性可用於從適用的組態檔取得 enableSsl 屬性的目前值。

範例

下列範例指定適當的 SMTP 參數，以便使用預設網路認證來傳送電子郵件。

<configuration>  
  <system.net>  
    <mailSettings>  
      <smtp deliveryMethod="Network">  
        <network  
          clientDomain="www.contoso.com"  
          defaultCredentials="true"  
          enableSsl="false"  
          host="mail.contoso.com"  
          port="25"  
        />  
      </smtp>  
    </mailSettings>  
  </system.net>  
</configuration>

另請參閱