SmtpClient.Credentials Eigenschaft

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

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

Ausnahmen

Beispiele

Das folgende Codebeispiel veranschaulicht das Festlegen der Anmeldeinformationen, die zum Senden einer E-Mail verwendet werden.

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 Standard-Netzwerkanmeldeinformationen zu verwenden, können Sie die UseDefaultCredentialstrue Eigenschaft auf "Auf" festlegen, anstatt diese Eigenschaft festzulegen. Wenn die UseDefaultCredentials Eigenschaft auf false, den Wert festgelegt ist, der in der Credentials Eigenschaft festgelegt wird, wird für die Anmeldeinformationen beim Herstellen einer Verbindung mit dem Server verwendet. Wenn die UseDefaultCredentials Eigenschaft festgelegt ist und die Credentials Eigenschaft nicht festgelegt false wurde, wird E-Mail anonym an den Server gesendet.

Anmeldeinformationen können auch mithilfe der Anwendungs- und Computerkonfigurationsdateien angegeben werden. Weitere Informationen finden Sie unter mailSettings Element (Netzwerkeinstellungen).For more information, see< mailSettings> Element (Network Settings). Wenn Informationen mithilfe der Credentials Eigenschaft angegeben werden, überschreibt diese Informationen die Konfigurationsdateieinstellungen.