Элемент <network> (параметры сети)<network> Element (Network Settings)

• 03/30/2017
• Чтение занимает 3 мин
• • k
  • o
  • S

Настраивает параметры сети для внешнего SMTP-сервера.Configures the network options for an external Simple Mail Transport Protocol (SMTP) server.

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

Атрибуты и элементыAttributes and Elements

В следующих разделах описаны атрибуты, дочерние и родительские элементы.The following sections describe attributes, child elements, and parent elements.

АтрибутыAttributes

Дочерние элементыChild Elements

Отсутствует.None.

Родительские элементыParent Elements

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.

Параметры обычной проверки подлинности и сетевых учетных данных по умолчанию являются взаимоисключающими. Если задано defaultCredentials значение true и указано имя пользователя и пароль, используются учетные данные сети по умолчанию, а основные данные проверки подлинности игнорируются.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. passwordВ целях безопасности атрибут обычно не указывается в файлах конфигурации.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Для атрибута можно задать полное доменное имя локального компьютера, а не имя localhost, используемое по умолчанию.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. Значение по умолчанию — имя localhost локального компьютера, отправляющего запрос.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/", <host> где <host> — имя узла почтового 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Атрибут указывает, используется ли протокол SSL для доступа к почтовому серверу SMTP.The enableSsl attribute specifies whether SSL is used to access an SMTP mail server. System.Net.Mail.SmtpClientКласс поддерживает только расширение службы SMTP для защиты SMTP по протоколу TLS, как определено в 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. Дополнительные сведения см. в RFC 3207, опубликованных с помощью IETF.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. Этот метод подключения иногда называют SMTP и по умолчанию использует порт 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

• System.Net.Configuration.SmtpNetworkElement
• System.Net.Configuration.SmtpSection
• System.Net.Mail.SmtpClient
• Схема параметров сетиNetwork Settings Schema