SmtpClient.UseDefaultCredentials Свойство

Определение

Пространство имен:

System.Net.Mail

Сборка:

System.Net.Mail.dll

Исходный код:

SmtpClient.cs

Возвращает или задает значение Boolean, которое управляет отправкой учетных данных 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

Значение свойства

Boolean

Значение true, если используются учетные данные по умолчанию; в противном случае — значение false. Значение по умолчанию — false.

Исключения

InvalidOperationException

Значение этого свойства нельзя изменить во время отправки электронной почты.

Примеры

В следующем примере кода демонстрируется использование этого свойства.

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

Комментарии

Для некоторых SMTP-серверов требуется, чтобы клиент прошел проверку подлинности перед отправкой электронной почты от его имени. Присвойте этому свойству значение true , когда объект SmtpClient должен, если он запрашивает сервер, проходить проверку подлинности с использованием учетных данных по умолчанию текущего вошедшего в систему пользователя. Для клиентских приложений это поведение является требуемым в большинстве сценариев.

Учетные данные также можно указать с помощью файлов конфигурации приложения и компьютера. Дополнительные сведения см. в разделе <Элемент mailSettings> (параметры сети).

Если свойству UseDefaultCredentials присвоено значение , false, то значение, заданное в свойстве Credentials , будет использоваться для учетных данных при подключении к серверу. Если свойству UseDefaultCredentials присвоено значение false , а Credentials свойство не задано, почта отправляется на сервер анонимно.

Внимание!

Если предоставлены учетные данные для обычной проверки подлинности, они отправляются на сервер в виде обычного текста. Это может представлять проблему безопасности, так как ваши учетные данные могут быть видны, а затем использоваться другими пользователями.