SmtpClient.Credentials Tulajdonság

Definíció

Névtér:

System.Net.Mail

Szerelvény:

System.dll

Lekéri vagy beállítja a feladó hitelesítéséhez használt hitelesítő adatokat.

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

Tulajdonság értéke

ICredentialsByHost

A ICredentialsByHost hitelesítéshez használandó hitelesítő adatokat jelöli; vagy null ha nincs megadva hitelesítő adat.

Kivételek

InvalidOperationException

E-mail küldésekor nem módosíthatja ennek a tulajdonságnak az értékét.

Példák

Az alábbi példakód bemutatja az e-mailek küldéséhez használt hitelesítő adatok beállítását.

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

Megjegyzések

Egyes SMTP-kiszolgálók megkövetelik az ügyfél hitelesítését, mielőtt a kiszolgáló e-mailt küld a nevében. Az alapértelmezett hálózati hitelesítő adatok használatához a tulajdonság beállítása helyett a UseDefaultCredentialstrue beállítást állíthatja be. Ha a UseDefaultCredentials tulajdonság értéke úgy van beállítva, hogy false, a Credentials tulajdonságban megadott érték a kiszolgálóhoz való csatlakozáskor a hitelesítő adatokhoz legyen használva. Ha a UseDefaultCredentials tulajdonság be van állítva false , és a Credentials tulajdonság nincs beállítva, a rendszer névtelenül küld e-mailt a kiszolgálónak.

A hitelesítő adatok az alkalmazás- és gépkonfigurációs fájlok használatával is megadhatóak. További információ: <mailSettings> Elem (Hálózati beállítások). Ha az információ a Credentials tulajdonság használatával van megadva, ez az információ felülírja a konfigurációs fájl beállításait.

Caution

Ha hitelesítő adatokat ad meg az alapszintű hitelesítéshez, azokat a rendszer világos szövegben küldi el a kiszolgálónak. Ez biztonsági problémát okozhat, mert a hitelesítő adatai láthatók, majd mások is használhatják.