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

Настраивает параметры сети для внешнего сервера ПРОТОКОЛА SMTP.

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

Синтаксис

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

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

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Attributes

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

Нет.

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

Замечания

Для некоторых SMTP-серверов требуется пройти проверку подлинности на сервере перед использованием. Если вы хотите выполнить проверку подлинности самостоятельно, используя учетные данные сети по умолчанию на узле, задайте для атрибута defaultCredentialsзначение true . Свойство SmtpNetworkElement.DefaultCredentials можно использовать для получения текущего значения атрибута defaultCredentials из применимых файлов конфигурации.

Вы также можете использовать обычную проверку подлинности (имя пользователя и пароль) для проверки подлинности на SMTP-сервере. Чтобы использовать этот параметр, необходимо указать допустимое имя пользователя и пароль для указанного SMTP-сервера.

Основные параметры проверки подлинности и учетных данных сети по умолчанию являются взаимоисключающими; Если задано defaultCredentialstrue и указано имя пользователя и пароль, используется учетные данные сети по умолчанию, а базовые данные проверки подлинности игнорируются.

Для базовой 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 поддерживает только расширение службы SMTP для безопасного SMTP-протокола по протоколу Transport Layer Security, как определено в RFC 3207. В этом режиме сеанс SMTP начинается на незашифрованном канале, а затем команда STARTTLS выдана клиентом серверу, чтобы переключиться на безопасное взаимодействие с помощью SSL. Дополнительные сведения см. в статье RFC 3207, опубликованной в Группе разработчиков Интернета (IETF).

Альтернативный метод подключения заключается в том, что сеанс SSL устанавливается перед отправкой любых команд протокола. Этот метод подключения иногда называется SMTPS, и по умолчанию использует порт 465. Этот альтернативный метод подключения с использованием SSL в настоящее время не поддерживается.

Свойство SmtpNetworkElement.EnableSsl можно использовать для получения текущего значения атрибута enableSsl из применимых файлов конфигурации.

Example

В следующем примере указаны соответствующие параметры 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>

См. также

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