SmtpClient.UseDefaultCredentials Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение 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
Значение свойства
Значение true
, если используются учетные данные по умолчанию; в противном случае — значение false
. Значение по умолчанию — false
.
Исключения
Значение этого свойства нельзя изменить во время отправки электронной почты.
Примеры
В следующем примере кода показано использование этого свойства.
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 свойство не задано, почта отправляется на сервер анонимно.
Внимание!
Если предоставлены учетные данные для обычной проверки подлинности, они отправляются на сервер в виде обычного текста. Это может создать проблему безопасности, так как ваши учетные данные могут быть видны, а затем используются другими пользователями.
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по