SmtpClient.Credentials Vlastnost

Definice

Obor názvů:

System.Net.Mail

Sestavení:

netstandard.dll, System.Net.Mail.dll

Zdroj:

SmtpClient.cs

Získá nebo nastaví přihlašovací údaje použité k ověření odesílatele.

public:
 property System::Net::ICredentialsByHost ^ Credentials { System::Net::ICredentialsByHost ^ get(); void set(System::Net::ICredentialsByHost ^ value); };

public System.Net.ICredentialsByHost? Credentials { get; set; }

member this.Credentials : System.Net.ICredentialsByHost with get, set

Public Property Credentials As ICredentialsByHost

Hodnota vlastnosti

ICredentialsByHost

Představuje ICredentialsByHost přihlašovací údaje, které se mají použít k ověřování, nebo null pokud nebyly zadány žádné přihlašovací údaje.

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 nastavení přihlašovacích údajů použitých k odeslání e-mailu.

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

Poznámky

Některé servery SMTP vyžadují, aby se klient ověřil, než server odešle e-mail za něj. Pokud chcete použít výchozí síťové přihlašovací údaje, můžete místo true tohoto nastavení nastavit UseDefaultCredentials tuto vlastnost. UseDefaultCredentials Pokud je vlastnost nastavena na false, hodnotu nastavena v Credentials vlastnosti bude použita pro přihlašovací údaje při připojování k serveru. UseDefaultCredentials Pokud je vlastnost nastavena false a Credentials vlastnost nebyla nastavena, odešle se pošta na server anonymně.

Informace o přihlašovacích údaji je možné zadat také pomocí konfiguračních souborů aplikace a počítače. Další informace najdete v tématu <mailSettings> – element (nastavení sítě). Pokud jsou informace zadány pomocí Credentials vlastnosti, tyto informace přepíší nastavení konfiguračního souboru.

Upozornění

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