SmtpClient.Credentials Eigenschaft

Definition

Namespace:

System.Net.Mail

Assembly:

System.Net.Mail.dll

Assembly:

System.dll

Assembly:

netstandard.dll

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

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 Auftrag sendet. Um Ihre Standardnetzwerkanmeldeinformationen zu verwenden, können Sie die UseDefaultCredentials true Eigenschaft anstelle dieser Eigenschaft festlegen. Wenn die Eigenschaft auf false, den Wert festgelegt ist, wird der UseDefaultCredentials Wert in der Credentials Eigenschaft bei der Verbindung mit dem Server für die Anmeldeinformationen verwendet. Wenn die UseDefaultCredentials Eigenschaft festgelegt ist und die Credentials Eigenschaft nicht festgelegt false wurde, wird E-Mails anonym an den Server gesendet.

Anmeldeinformationen können auch mithilfe der Anwendungs- und Computerkonfigurationsdateien festgelegt werden. Weitere Informationen finden Sie unter <mailSettings-Element> (Network Einstellungen). Wenn Informationen mithilfe der Credentials Eigenschaft angegeben werden, überschreibt 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.