SmtpClient.Timeout Свойство

Определение

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

System.Net.Mail

Сборки:

netstandard.dll, System.Net.Mail.dll

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

SmtpClient.cs

Возвращает или задает значение, указывающее время ожидания синхронного Send вызова.

public:
 property int Timeout { int get(); void set(int value); };

public int Timeout { get; set; }

member this.Timeout : int with get, set

Public Property Timeout As Integer

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

Int32

Значение Int32 времени ожидания в миллисекундах. Значение по умолчанию — 100 000 (100 секунд).

Исключения

ArgumentOutOfRangeException

Значение, указанное для операции набора, было меньше нуля.

InvalidOperationException

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

Примеры

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

public static void CreateTimeoutTestMessage(string server)
{
    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);
    Console.WriteLine("Changing time out from {0} to 100.", client.Timeout);
    client.Timeout = 100;
    // 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);
}

Комментарии

По умолчанию вызывает Send блок метода до завершения операции. Если для свойства задано Timeout положительное значение, а Send операция не может завершиться в заданное время, SmtpClient класс создает SmtpException исключение.

Чтобы отправить сообщение и продолжить выполнение в потоке приложения, используйте SendAsync метод.