SmtpClient.UseDefaultCredentials Właściwość

Definicja

Przestrzeń nazw:

System.Net.Mail

Zestaw:

System.Net.Mail.dll

Źródło:

SmtpClient.cs

Pobiera lub ustawia Boolean wartość, która kontroluje, czy DefaultCredentials obiekt jest wysyłany z żądaniami.

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

Wartość właściwości

Boolean

true jeśli są używane poświadczenia domyślne; w przeciwnym razie false. Wartość domyślna to false.

Wyjątki

InvalidOperationException

Nie można zmienić wartości tej właściwości podczas wysyłania wiadomości e-mail.

Przykłady

Poniższy przykład kodu przedstawia użycie tej właściwości.

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

Uwagi

Niektóre serwery SMTP wymagają uwierzytelnienia klienta, zanim serwer wyśle wiadomość e-mail w jego imieniu. Ustaw tę właściwość na true wartość , jeśli ten SmtpClient obiekt ma być żądany przez serwer, uwierzytelnij się przy użyciu domyślnych poświadczeń aktualnie zalogowanego użytkownika. W przypadku aplikacji klienckich jest to pożądane zachowanie w większości scenariuszy.

Informacje o poświadczeniach można również określić przy użyciu plików konfiguracji aplikacji i maszyny. Aby uzyskać więcej informacji, zobacz <mailSettings> , element (ustawienia sieciowe).

UseDefaultCredentials Jeśli właściwość jest ustawiona na false, wartość , wartość ustawiona we Credentials właściwości będzie używana dla poświadczeń podczas nawiązywania połączenia z serwerem. UseDefaultCredentials Jeśli właściwość jest ustawiona na false , a Credentials właściwość nie została ustawiona, poczta jest wysyłana anonimowo do serwera.

Przestroga

Jeśli podasz poświadczenia do uwierzytelniania podstawowego, zostaną one wysłane do serwera w postaci zwykłego tekstu. Może to stanowić problem z zabezpieczeniami, ponieważ poświadczenia mogą być widoczne, a następnie używane przez inne osoby.