<network> Elemento (Definições de Rede)

Configura as opções de rede para um servidor externo do Simple Mail Transport Protocol (SMTP).

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

Sintaxe

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

Atributos e Elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Attributes

Elementos Subordinados

Nenhum.

Elementos Principais

Observações

Alguns servidores SMTP exigem que te autentiques no servidor antes de o usar. Se quiser autenticar-se usando as credenciais de rede padrão do seu host, defina o defaultCredentials atributo para true. A SmtpNetworkElement.DefaultCredentials propriedade pode ser usada para obter o valor atual do defaultCredentials atributo a partir dos ficheiros de configuração aplicáveis.

Também pode usar autenticação básica (nome de utilizador e palavra-passe) para se autenticar no servidor SMTP. Para usar esta opção, deve especificar um nome de utilizador e uma palavra-passe válidos para o servidor SMTP especificado.

As opções básicas de autenticação e credenciais de rede padrão são mutuamente exclusivas; Se definir defaultCredentials e true especificar um nome de utilizador e palavra-passe, é usada a credencial de rede por defeito e os dados básicos de autenticação são ignorados.

Para autenticação básica, se especificar um userName, também deve especificar um password para autenticação ao servidor de e-mail.

A SmtpNetworkElement.UserName propriedade pode ser usada para obter o valor atual do userName atributo a partir dos ficheiros de configuração aplicáveis. A SmtpNetworkElement.Password propriedade pode ser usada para obter o valor atual do password atributo a partir dos ficheiros de configuração aplicáveis. Normalmente, um password atributo não seria inserido em ficheiros de configuração por razões de segurança.

O clientDomain atributo altera o nome de domínio cliente usado no pedido inicial do protocolo SMTP para um servidor SMTP. O clientDomain atributo pode ser definido para o nome de domínio totalmente qualificado da máquina local, em vez do nome localhost usado por defeito. Isto proporciona maior conformidade com os padrões do protocolo SMTP. O valor predefinido é o nome localhost do computador local que envia o pedido. A SmtpNetworkElement.ClientDomain propriedade pode ser usada para obter o valor atual do clientDomain atributo a partir dos ficheiros de configuração aplicáveis.

O targetName atributo é usado para autenticação quando se utiliza proteção estendida. O valor padrão é da forma "SMTPSVC/<host>", onde <host> é o nome de host do servidor de email SMTP. A SmtpNetworkElement.TargetName propriedade pode ser usada para obter o valor atual do targetName atributo a partir dos ficheiros de configuração aplicáveis.

O enableSsl atributo especifica se SSL é usado para aceder a um servidor de email SMTP. A System.Net.Mail.SmtpClient classe suporta apenas a Extensão de Serviço SMTP para Segurança SMTP sobre Camada de Transporte, conforme definido no RFC 3207. Neste modo, a sessão SMTP começa num canal não encriptado, sendo depois emitido pelo cliente um comando STARTTLS ao servidor para mudar para comunicação segura usando SSL. Consulte o RFC 3207 publicado pela Internet Engineering Task Force (IETF) para mais informações.

Um método alternativo de ligação é quando uma sessão SSL é estabelecida antecipadamente antes de quaisquer comandos de protocolo serem enviados. Este método de ligação é por vezes chamado SMTPS e, por defeito, utiliza a porta 465. Este método alternativo de ligação usando SSL não é atualmente suportado.

A SmtpNetworkElement.EnableSsl propriedade pode ser usada para obter o valor atual do enableSsl atributo a partir dos ficheiros de configuração aplicáveis.

Example

O exemplo seguinte especifica os parâmetros SMTP apropriados para enviar emails usando as credenciais de rede padrão.

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

Consulte também

• System.Net.Configuration.SmtpNetworkElement
• System.Net.Configuration.SmtpSection
• System.Net.Mail.SmtpClient
• Esquema de Definições de Rede