SmtpClient.Credentials Vlastnost

Definice

Obor názvů:

System.Net.Mail

Sestavení:

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žívaných k odeslání e-mailu.

static void CreateTestMessage1( String^ server, int port )
{
   String^ to = L"jane@contoso.com";
   String^ from = L"ben@contoso.com";
   String^ subject = L"Using the new SMTP client.";
   String^ body = L"Using this new feature, you can send an email message from an application very easily.";
   MailMessage^ message = gcnew MailMessage( from,to,subject,body );
   SmtpClient^ client = gcnew 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 );
   client->~SmtpClient();
}

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 byl klient před odesláním e-mailu jeho jménem ověřený. Pokud chcete použít výchozí síťové přihlašovací údaje, můžete místo této vlastnosti nastavit UseDefaultCredentials na true . Pokud je vlastnost nastavená UseDefaultCredentials 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 nastavená na false a Credentials vlastnost nebyla nastavena, odešle se pošta na server anonymně.

Přihlašovací údaje lze 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 , přepíší tyto informace nastavení konfiguračního souboru.

Upozornění

Pokud zadáte přihlašovací údaje pro základní ověřování, odesílají se na server jako prostý text. 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 jiní uživatelé.