SmtpClient.UseDefaultCredentials Vlastnost

Definice

Obor názvů:

System.Net.Mail

Sestavení:

System.Net.Mail.dll

Zdroj:

SmtpClient.cs

Získá nebo nastaví Boolean hodnotu, která určuje, zda DefaultCredentials jsou odesílány s požadavky.

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

Hodnota vlastnosti

Boolean

true pokud se použijí výchozí přihlašovací údaje; jinak false. Výchozí hodnota je false.

Výjimky

InvalidOperationException

Hodnotu této vlastnosti nelze změnit při odesílání e-mailu.

Příklady

Následující příklad kódu ukazuje použití této vlastnosti.

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

Poznámky

Některé servery SMTP vyžadují ověření klienta předtím, než server odešle e-mail jeho jménem. Tuto vlastnost nastavte na true hodnotu, kdy se má tento SmtpClient objekt v případě požadavku serveru ověřit pomocí výchozích přihlašovacích údajů aktuálně přihlášeného uživatele. U klientských aplikací se jedná o požadované chování ve většině scénářů.

Informace o přihlašovacích údaji je také možné zadat pomocí konfiguračních souborů aplikace a počítače. Další informace najdete v tématu <element mailSettings> (nastavení sítě).

UseDefaultCredentials Pokud je vlastnost nastavená na false, hodnotu, použije se pro přihlašovací údaje při připojování k serveru hodnota nastavená ve Credentials vlastnosti. UseDefaultCredentials Pokud je vlastnost nastavena na false a Credentials vlastnost nebyla nastavena, odešle se pošta na server anonymně.

Upozornění

Pokud zadáte přihlašovací údaje pro základní ověřování, odesílají se na server ve formátu prostého textu. To může představovat problém se zabezpečením, protože vaše přihlašovací údaje můžou zobrazit a pak je používat ostatní.