SmtpClient.UseDefaultCredentials Eigenschaft

Definition

Namespace:

System.Net.Mail

Assembly:

System.Net.Mail.dll

Quelle:

SmtpClient.cs

Ruft einen Boolean-Wert ab, der steuert, ob mit den Anforderungen DefaultCredentials gesendet werden, oder legt diesen fest.

public:
 property bool UseDefaultCredentials { bool get(); void set(bool value); };

public bool UseDefaultCredentials { get; set; }

member this.UseDefaultCredentials : bool with get, set

Public Property UseDefaultCredentials As Boolean

Eigenschaftswert

Boolean

true, wenn die Standardanmeldeinformationen verwendet werden, andernfalls false. Der Standardwert ist false.

Ausnahmen

InvalidOperationException

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

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieser Eigenschaft veranschaulicht.

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

public static void CreateTestMessage2(string server)
{
    string to = "jane@contoso.com";
    string from = "ben@contoso.com";
    MailMessage message = new MailMessage(from, to);
    message.Subject = "Using the new SMTP client.";
    message.Body = @"Using this new feature, you can send an email message from an application very easily.";
    SmtpClient client = new SmtpClient(server);
    // Credentials are necessary if the server requires the client
    // to authenticate before it will send email on the client's behalf.
    client.UseDefaultCredentials = true;

    try
    {
        client.Send(message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Exception caught in CreateTestMessage2(): {0}",
            ex.ToString());
    }
}

Hinweise

Einige SMTP-Server erfordern, dass der Client authentifiziert wird, bevor der Server E-Mails in seinem Namen sendet. Legen Sie diese Eigenschaft auf fest true , wann sich dieses SmtpClient Objekt authentifizieren soll, wenn es vom Server angefordert wird, mit den Standardanmeldeinformationen des aktuell angemeldeten Benutzers. Für Clientanwendungen ist dies das gewünschte Verhalten in den meisten Szenarien.

Anmeldeinformationen können auch mithilfe der Anwendungs- und Computerkonfigurationsdateien festgelegt werden. Weitere Informationen finden Sie unter <mailSettings-Element> (Netzwerkeinstellungen).

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.

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.