SmtpClient.Timeout Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, указывающее промежуток времени, после которого для синхронного вызова 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, указывающее значение тайм-аута в миллисекундах. По умолчанию установлено значение 100,000 (100 секунд).
Исключения
Значение, указанное для операции присвоения, меньше нуля.
Значение этого свойства нельзя изменить во время отправки электронной почты.
Примеры
В следующем примере кода показано получение и установка значения времени ожидания.
static void CreateTimeoutTestMessage( String^ server )
{
String^ to = L"[email protected]";
String^ from = L"[email protected]";
String^ subject = L"Using the new SMTP client.";
String^ body = L"Using this new feature, you can send an email message from an application very easily.";
MailMessage^ message = gcnew MailMessage( from,to,subject,body );
SmtpClient^ client = gcnew SmtpClient( server );
Console::WriteLine( L"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 );
}
public static void CreateTimeoutTestMessage(string server)
{
string to = "[email protected]";
string from = "[email protected]";
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 метод .