SmtpClient.Credentials Eigenschaft

Definition

Namespace:

System.Net.Mail

Assembly:

System.Net.Mail.dll

Quelle:

SmtpClient.cs

Ruft die Anmeldeinformationen zum Authentifizieren des Absenders ab oder legt diese fest.

public:
 property System::Net::ICredentialsByHost ^ Credentials { System::Net::ICredentialsByHost ^ get(); void set(System::Net::ICredentialsByHost ^ value); };

public System.Net.ICredentialsByHost? Credentials { get; set; }

member this.Credentials : System.Net.ICredentialsByHost with get, set

Public Property Credentials As ICredentialsByHost

Eigenschaftswert

ICredentialsByHost

Ein ICredentialsByHost, das die für die Authentifizierung zu verwendenden Anmeldeinformationen darstellt, oder null, wenn keine Anmeldeinformationen angegeben wurden.

Ausnahmen

InvalidOperationException

Sie können den Wert dieser Eigenschaft nicht ändern, während eine E-Mail-Nachricht gesendet wird.

Beispiele

Im folgenden Codebeispiel wird das Festlegen der Anmeldeinformationen veranschaulicht, die zum Senden einer E-Mail verwendet werden.

static void CreateTestMessage1( String^ server, int port )
{
   String^ to = L"jane@contoso.com";
   String^ from = L"ben@contoso.com";
   String^ subject = L"Using the new SMTP client.";
   String^ body = L"Using this new feature, you can send an email message from an application very easily.";
   MailMessage^ message = gcnew MailMessage( from,to,subject,body );
   SmtpClient^ client = gcnew SmtpClient( server,port );
   
   // Credentials are necessary if the server requires the client 
   // to authenticate before it will send email on the client's behalf.
   client->Credentials = CredentialCache::DefaultNetworkCredentials;
   client->Send( message );
   client->~SmtpClient();
}

public static void CreateTestMessage1(string server, int port)
{
    string to = "jane@contoso.com";
    string from = "ben@contoso.com";
    string subject = "Using the new SMTP client.";
    string body = @"Using this new feature, you can send an email message from an application very easily.";
    MailMessage message = new MailMessage(from, to, subject, body);
    SmtpClient client = new SmtpClient(server, port);
    // Credentials are necessary if the server requires the client
    // to authenticate before it will send email on the client's behalf.
    client.Credentials = CredentialCache.DefaultNetworkCredentials;
    client.Send(message);
}

Hinweise

Einige SMTP-Server erfordern, dass der Client authentifiziert wird, bevor der Server E-Mails in seinem Namen sendet. Um Ihre Standardnetzwerkanmeldeinformationen zu verwenden, können Sie auf UseDefaultCredentialstrue festlegen, anstatt diese Eigenschaft festzulegen. Wenn die UseDefaultCredentials -Eigenschaft auf false, festgelegt ist, wird der in der Credentials -Eigenschaft festgelegte Wert für die Anmeldeinformationen beim Herstellen einer Verbindung mit dem Server verwendet. Wenn die UseDefaultCredentials -Eigenschaft auf false festgelegt ist und die Credentials -Eigenschaft nicht festgelegt wurde, wird die E-Mail anonym an den Server gesendet.

Anmeldeinformationen können auch mithilfe der Anwendungs- und Computerkonfigurationsdateien festgelegt werden. Weitere Informationen finden Sie unter <mailSettings-Element> (Netzwerkeinstellungen). Wenn Informationen mithilfe der Credentials -Eigenschaft angegeben werden, überschreiben diese Informationen die Konfigurationsdateieinstellungen.

Achtung

Wenn Sie Anmeldeinformationen für Standardauthentifizierung bereitstellen, werden diese als Nur-Text an den Server gesendet. Dies kann ein Sicherheitsproblem darstellen, da Ihre Anmeldeinformationen angezeigt und dann von anderen verwendet werden können.