SmtpClient.UseDefaultCredentials Proprietà

Definizione

Spazio dei nomi:

System.Net.Mail

Assembly:

System.Net.Mail.dll

Origine:

SmtpClient.cs

Ottiene o imposta un valore Boolean che controlla se insieme alle richieste viene inviata la proprietà DefaultCredentials.

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

Valore della proprietà

Boolean

true se vengono usate le credenziali predefinite; in caso contrario, false. Il valore predefinito è false.

Eccezioni

InvalidOperationException

Non è possibile modificare il valore di questa proprietà mentre viene inviato un messaggio di posta elettronica.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questa proprietà.

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

Commenti

Alcuni server SMTP richiedono che il client venga autenticato prima che il server invii messaggi di posta elettronica per suo conto. Impostare questa proprietà su true quando questo SmtpClient oggetto deve, se richiesto dal server, eseguire l'autenticazione usando le credenziali predefinite dell'utente attualmente connesso. Per le applicazioni client, questo è il comportamento desiderato nella maggior parte degli scenari.

Le informazioni delle credenziali possono essere specificate anche utilizzando i file di configurazione dell'applicazione e del computer. Per altre informazioni, vedere Elemento mailSettings (impostazioni di rete).For more information, see< mailSettings> Element (Network Settings).

Se la UseDefaultCredentials proprietà è impostata su false, , il valore impostato nella Credentials proprietà verrà utilizzato per le credenziali durante la connessione al server. Se la UseDefaultCredentials proprietà è impostata su false e la Credentials proprietà non è stata impostata, la posta viene inviata al server in modo anonimo.

Attenzione

Se si specificano le credenziali per l'autenticazione di base, queste vengono inviate al server in formato testo non crittografato. Questo può presentare un problema di sicurezza perché le credenziali possono essere visualizzate e quindi usate da altri utenti.