<ネットワーク > 要素 (ネットワーク設定)<network> Element (Network Settings)

外部の簡易メール転送プロトコル (SMTP) サーバーのネットワーク オプションを構成します。Configures the network options for an external Simple Mail Transport Protocol (SMTP) server.

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

構文Syntax

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

属性および要素Attributes and Elements

以降のセクションでは、属性、子要素、および親要素について説明します。The following sections describe attributes, child elements, and parent elements.

属性Attributes

属性Attribute 説明Description
clientDomain SMTP メール サーバーに接続する最初の SMTP プロトコル要求に使用するクライアントのドメイン名を指定します。Specifies the client domain name to use in the initial SMTP protocol request to connect to the SMTP mail server. 既定値は、要求を送信するローカル コンピューターのローカル ホスト名です。The default value is the localhost name of the local computer sending the request.
defaultCredentials SMTP トランザクションで、SMTP メール サーバーへのアクセスに既定のユーザー資格情報を使用するかどうかを指定します。Specifies whether the default user credentials should be used to access the SMTP mail server for SMTP transactions. 既定値は false です。The default value is false.
enableSsl SMTP メール サーバーへのアクセスに SSL が使用されるかどうかを指定します。Specifies whether SSL is used to access an SMTP mail server. 既定値は false です。The default value is false.
host SMTP トランザクションで使用する SMTP メール サーバーのホスト名を指定します。Specifies the hostname of the SMTP mail server to use for SMTP transactions. この属性には、既定値はありません。This attribute has no default value.
password SMTP メール サーバーへの認証に使用するパスワードを指定します。Specifies the password to use for authentication to the SMTP mail server. この属性には、既定値はありません。This attribute has no default value.
port SMTP メール サーバーへの接続に使用するポート番号を指定します。Specifies the port number to use to connect to the SMTP mail server. 既定値は 25 です。The default value is 25.
targetName SMTP トランザクションで拡張保護を使用する場合は、認証に使用するサービス プロバイダー名 (SPN) を指定します。Specifies the Service Provider Name (SPN) to use for authentication when using extended protection for SMTP transactions. この属性には、既定値はありません。This attribute has no default value.
userName SMTP メール サーバーへの認証に使用するユーザー名を指定します。Specifies the user name to use for authentication to the SMTP mail server. この属性には、既定値はありません。This attribute has no default value.

子要素Child Elements

なし。None.

親要素Parent Elements

要素Element 説明Description
<smtp > 要素 (ネットワーク設定)<smtp> Element (Network Settings) 簡易メール転送プロトコル (SMTP) 電子メールの送信オプションを構成します。Configures Simple Mail Transport Protocol (SMTP) mail sending options.

RemarksRemarks

一部の SMTP サーバーでは、自分でを使用する前に、サーバーに対して認証することが必要です。Some SMTP servers require that you authenticate yourself to the server before use. ホストの既定のネットワーク資格情報を使用して自分で認証を設定する場合、defaultCredentials属性をtrueします。If you want to authenticate yourself using the default network credentials on your host, set the defaultCredentials attribute to true. SmtpNetworkElement.DefaultCredentialsプロパティを使用しての現在の値を取得すること、defaultCredentials該当する構成ファイルからの属性。The SmtpNetworkElement.DefaultCredentials property can be used to get the current value of the defaultCredentials attribute from applicable configuration files.

基本認証 (ユーザー名とパスワード) SMTP サーバーに認証を使用することもできます。You can also use basic authentication (a user name and password) to authenticate yourself to the SMTP server. このオプションを使用するには、有効なユーザー名とパスワードを指定した SMTP サーバーを指定する必要があります。To use this option, you must specify a valid user name and password for the specified SMTP server.

注意

基本認証で送信、userNamepassword暗号化せずに、サーバーの値。Basic authentication sends the userName and password values to the server unencrypted. 資格情報を表示でき、それらを使用して、サーバーに接続するネットワーク トラフィックを監視している人ことができます。Anyone monitoring network traffic can view your credentials and use them to connect to the server. Kerberos または NT LAN Manager (NTLM。) より安全な認証メカニズムの使用を検討する必要があります。場合defaultCredentialstrueサーバーは、これらのプロトコルをサポートしている場合、Kerberos または NTLM が使用されます。You should consider using a more secure authentication mechanism, such as Kerberos or NT LAN Manager (NTLM.) If defaultCredentials is true, Kerberos or NTLM will be used if the server supports these protocols.

基本認証と既定ネットワーク資格情報オプションは相互に排他的です。設定した場合defaultCredentialstrueユーザー名とパスワードを指定し、既定のネットワーク資格情報を使用すると、および、基本認証データは無視されます。The basic authentication and default network credentials options are mutually exclusive; if you set defaultCredentials to true and specify a user name and password, the default network credential is used, and the basic authentication data is ignored.

基本認証を指定する場合、userNameも指定する必要があります、password認証メール サーバーに自分でします。For basic authentication if you specify a userName, you should also specify a password to authentication yourself to the mail server.

SmtpNetworkElement.UserNameプロパティを使用しての現在の値を取得すること、userName該当する構成ファイルからの属性。The SmtpNetworkElement.UserName property can be used to get the current value of the userName attribute from applicable configuration files. SmtpNetworkElement.Passwordプロパティを使用しての現在の値を取得すること、password該当する構成ファイルからの属性。The SmtpNetworkElement.Password property can be used to get the current value of the password attribute from applicable configuration files. Apasswordは、通常セキュリティ上の理由から、構成ファイルに入力することができません属性。A password attribute would not normally be entered in configuration files for security reasons.

clientDomain属性は、SMTP サーバーへの最初の SMTP プロトコル要求で使用されるクライアントのドメイン名を変更します。The clientDomain attribute changes the client domain name used in the initial SMTP protocol request to an SMTP server. clientDomain属性は、既定で使用されるローカル ホスト名ではなく、ローカル コンピューターの完全修飾ドメイン名に設定することができます。The clientDomain attribute can be set to the fully-qualified domain name of the local machine, rather than the localhost name that is used by default. これは、SMTP プロトコルの標準とコンプライアンスの向上を提供します。This provides greater compliance with the SMTP protocol standards. 既定値は、要求を送信するローカル コンピューターのローカル ホスト名です。The default value is the localhost name of the local computer sending the request. SmtpNetworkElement.ClientDomainプロパティを使用しての現在の値を取得すること、clientDomain該当する構成ファイルからの属性。The SmtpNetworkElement.ClientDomain property can be used to get the current value of the clientDomain attribute from applicable configuration files.

targetName属性は、拡張保護を使用する場合、認証に使用します。The targetName attribute is used for authentication when using extended protection. フォームの既定値は"SMTPSVC/<ホスト >"を<ホスト > は、SMTP メール サーバーのホスト名。The default value is of the form "SMTPSVC/<host>" where <host> is the hostname of the SMTP mail server. SmtpNetworkElement.TargetNameプロパティを使用しての現在の値を取得すること、targetName該当する構成ファイルからの属性。The SmtpNetworkElement.TargetName property can be used to get the current value of the targetName attribute from applicable configuration files.

enableSsl属性は、SMTP メール サーバーへのアクセスに SSL が使用されるかどうかを指定します。The enableSsl attribute specifies whether SSL is used to access an SMTP mail server. System.Net.Mail.SmtpClientクラスのみをサポート SMTP サービスの拡張機能のセキュリティで保護された SMTP トランスポート層セキュリティ経由で RFC 3207 で定義されています。The System.Net.Mail.SmtpClient class only supports the SMTP Service Extension for Secure SMTP over Transport Layer Security as defined in RFC 3207. このモードでは、SMTP セッションの非暗号化チャネルで開始し、STARTTLS コマンドが SSL を使用してセキュリティで保護された通信を切り替えるためにサーバーにクライアントによって発行されたします。In this mode, the SMTP session begins on an unencrypted channel, then a STARTTLS command is issued by the client to the server to switch to secure communication using SSL. 詳細についてはインターネット技術標準化委員会 (IETF) によって発行された RFC 3207 を参照してください。See RFC 3207 published by the Internet Engineering Task Force (IETF) for more information.

代替の接続方法は、任意のプロトコルのコマンドを送信する前の SSL セッションの事前の確立します。An alternate connection method is where an SSL session is established up front before any protocol commands are sent. この接続方法が SMTPS とも呼ばれますが、既定ではポート 465 を使用します。This connection method is sometimes called SMTPS and by default uses port 465. SSL を使用してこの代替の接続方法は現在サポートされていません。This alternate connection method using SSL is not currently supported.

SmtpNetworkElement.EnableSslプロパティを使用しての現在の値を取得すること、enableSsl該当する構成ファイルからの属性。The SmtpNetworkElement.EnableSsl property can be used to get the current value of the enableSsl attribute from applicable configuration files.

Example

次の例では、既定のネットワーク資格情報を使用して電子メールを送信する適切な SMTP パラメーターを指定します。The following example specifies the appropriate SMTP parameters to send email using the default network credentials.

<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>  

関連項目See also