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

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

<configuração>
   <system.net>
     <Mailsettings>
       <Smtp>
         <rede>

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 filho

Nenhum.

Elementos pai

Observações

Alguns servidores SMTP exigem que você se autentique no servidor antes do uso. Se você quiser se autenticar usando as credenciais de rede padrão em seu host, defina o defaultCredentials atributo como true. A SmtpNetworkElement.DefaultCredentials propriedade pode ser usada para obter o valor atual do atributo dos defaultCredentials arquivos de configuração aplicáveis.

Você também pode usar a autenticação básica (um nome de usuário e uma senha) para se autenticar no servidor SMTP. Para usar essa opção, você deve especificar um nome de usuário e uma senha 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 você definir defaultCredentialstrue e especificar um nome de usuário e senha, a credencial de rede padrão será usada e os dados básicos de autenticação serão ignorados.

Para autenticação básica se você especificar um userName, você também deve especificar uma password autenticação para o servidor de email.

A SmtpNetworkElement.UserName propriedade pode ser usada para obter o valor atual do atributo dos userName arquivos de configuração aplicáveis. A SmtpNetworkElement.Password propriedade pode ser usada para obter o valor atual do atributo dos password arquivos de configuração aplicáveis. Normalmente password , um atributo não seria inserido nos arquivos de configuração por motivos de segurança.

O clientDomain atributo altera o nome de domínio do cliente usado na solicitação de protocolo SMTP inicial para um servidor SMTP. O clientDomain atributo pode ser definido como o nome de domínio totalmente qualificado do computador local, em vez do nome localhost usado por padrão. Isso fornece maior conformidade com os padrões de protocolo SMTP. O valor padrão é o nome localhost do computador local que envia a solicitação. A SmtpNetworkElement.ClientDomain propriedade pode ser usada para obter o valor atual do atributo dos clientDomain arquivos de configuração aplicáveis.

O targetName atributo é usado para autenticação ao usar a proteção estendida. O valor padrão é do formulário "SMTPSVC/<host>" em que <host> está o nome do host do servidor de email SMTP. A SmtpNetworkElement.TargetName propriedade pode ser usada para obter o valor atual do atributo dos targetName arquivos de configuração aplicáveis.

O enableSsl atributo especifica se o SSL é usado para acessar um servidor de email SMTP. A System.Net.Mail.SmtpClient classe só dá suporte à Extensão de Serviço SMTP para SMTP Seguro sobre a Segurança da Camada de Transporte, conforme definido no RFC 3207. Nesse modo, a sessão SMTP começa em um canal não criptografado e, em seguida, um comando STARTTLS é emitido pelo cliente para o servidor para alternar para uma comunicação segura usando SSL. Consulte o RFC 3207 publicado pela IETF (Internet Engineering Task Force) para obter mais informações.

Um método de conexão alternativo é onde uma sessão SSL é estabelecida antecipadamente antes de qualquer comando de protocolo ser enviado. Esse método de conexão às vezes é chamado de SMTPS e, por padrão, usa a porta 465. Atualmente, não há suporte para esse método de conexão alternativo usando SSL.

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

Example

O exemplo a seguir 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 Configurações de Rede