<network>-Element (Netzwerkeinstellungen)

Konfiguriert die Netzwerkoptionen für einen externen SMTP-Server (Simple Mail Transport Protocol).

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.

Attribute

Untergeordnete Elemente

Keine.

Übergeordnete Elemente

Hinweise

Das <network>-Element konfiguriert die Netzwerkoptionen für einen externen SMTP-Server.

Einige SMTP-Server erfordern vor der Benutzung eine Authentifizierung am Server. Wenn Sie sich unter Verwendung der auf Ihrem Host befindlichen Standard-Netzwerkanmeldeinformationen authentifizieren möchten, legen Sie das defaultCredentials-Attribut auf true fest. Die SmtpNetworkElement.DefaultCredentials-Eigenschaft kann verwendet werden, um den aktuellen Wert des defaultCredentials-Attributs aus anwendbaren Konfigurationsdateien abzurufen.

Sie können auch eine einfache Authentifizierung verwenden (Benutzername und Kennwort), um sich am SMTP-Server anzumelden. Um diese Option verwenden zu können, müssen Sie einen gültigen Benutzernamen und ein gültiges Kennwort für den angegebenen SMTP-Server angeben.

Hinweis

Einfache Authentifizierung sendet den userName-Wert und den password-Wert unverschlüsselt zum Server.Jede den Netzwerkverkehr überwachende Person kann die Anmeldeinformationen anzeigen und zum Herstellen einer Verbindung mit dem Server verwenden.Sie sollten in Erwägung ziehen, einen sichereren Authentifizierungsmechanismus zu verwenden, z. B. Kerberos oder NT LAN-Manager (NTLM). Falls defaultCredentials true ist, wird Kerberos oder NTLM verwendet, sofern der Server diese Protokolle unterstützt.

Die Optionen der einfachen Authentifizierung und der Standard-Netzwerkanmeldeinformationen schließen sich gegenseitig aus; wenn Sie defaultCredentials auf true festgelegt haben und einen Benutzernamen und ein Kennwort angeben, werden die Standard-Netzwerkanmeldeinformationen verwendet und die einfache Authentifizierung wird ignoriert.

Zur Standardauthentifizierung sollten Sie auch ein password angeben, um sich auf dem E-Mail-Server zu authentifizieren, wenn Sie einen userName angeben.

Die SmtpNetworkElement.UserName-Eigenschaft kann verwendet werden, um den aktuellen Wert des userName-Attributs aus anwendbaren Konfigurationsdateien abzurufen. Die SmtpNetworkElement.Password-Eigenschaft kann verwendet werden, um den aktuellen Wert des password-Attributs aus anwendbaren Konfigurationsdateien abzurufen. Ein password-Attribut würde normalerweise aus Sicherheitsgründen nicht in Konfigurationsdateien eingegeben werden.

Das clientDomain-Attribut ändert den Clientdomänennamen in der ursprünglichen SMTP-Protokollanforderung an einen SMTP-Server. Das clientDomain-Attribut kann auf den vollqualifizierten Domänennamen des lokalen Computers statt auf den standardmäßig verwendeten localhost-Name festgelegt werden. Dies bietet größere Kompatibilität mit den SMTP-Protokollstandards. Der Standardwert ist der localhost-Name des lokalen Computers, der die Anforderung sendet. Die SmtpNetworkElement.ClientDomain-Eigenschaft kann verwendet werden, um den aktuellen Wert des clientDomain-Attributs aus anwendbaren Konfigurationsdateien abzurufen.

Das targetName-Attribut dient zur Authentifizierung bei Verwendeung des erweiterten Schutzes. Der Standardwert liegt im Format "SMTPSVC/<Host>" vor, wobei <Host> der Hostname des SMTP-Mailservers ist. Die SmtpNetworkElement.TargetName-Eigenschaft kann verwendet werden, um den aktuellen Wert des targetName-Attributs aus anwendbaren Konfigurationsdateien abzurufen.

Das enableSsl -Attribut gibt an, ob SSL verwendet wird, um auf einen SMTP-Mailserver zuzugreifen. Die System.Net.Mail.SmtpClient-Klasse unterstützt nur die SMTP Service-Erweiterung für Sicheres SMTP über Transport Layer Security, wie in RFC 3207 definiert. In diesem Modus beginnt die SMTP-Sitzung auf einem unverschlüsselten Channel, dann wird ein STARTTLS-Befehl vom Client zum Server ausgegeben, um mit SSL zu sicherer Kommunikation zu wechseln. Weitere Informationen finden Sie in RFC 3207, veröffentlicht von der Internet Engineering Task Force (IETF).

Eine alternative Verbindungsmethode besteht darin, eine SSL-Sitzung im Vorhinein festzulegen, bevor Protokollbefehle gesendet werden. Diese Verbindungsmethode wird manchmal als SMTPs bezeichnet und verwendet standardmäßig Port 465. Diese alternative Verbindungsmethode mit SSL wird derzeit nicht unterstützt.

Die SmtpNetworkElement.EnableSsl-Eigenschaft kann verwendet werden, um den aktuellen Wert des enableSsl-Attributs aus anwendbaren Konfigurationsdateien abzurufen.

Beispiel

Im folgenden Codebeispiel werden die entsprechenden SMTP-Parameter angegeben, um E-Mails unter Verwendung der Standard-Netzwerkanmeldeinformationen zu senden.

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

Siehe auch

Referenz

Netzwerkeinstellungsschema

System.Net.Configuration.SmtpNetworkElement

System.Net.Configuration.SmtpSection

System.Net.Mail.SmtpClient