SmtpClient.Timeout Vlastnost

Definice

Obor názvů:

System.Net.Mail

Sestavení:

netstandard.dll, System.Net.Mail.dll

Zdroj:

SmtpClient.cs

Získá nebo nastaví hodnotu, která určuje dobu, po které synchronní Send volání vyprší.

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

Hodnota vlastnosti

Int32

Určuje Int32 hodnotu časového limitu v milisekundách. Výchozí hodnota je 100 000 (100 sekund).

Výjimky

ArgumentOutOfRangeException

Hodnota zadaná pro operaci sady byla menší než nula.

InvalidOperationException

Hodnotu této vlastnosti nelze změnit při odesílání e-mailu.

Příklady

Následující příklad kódu ukazuje získání a nastavení hodnoty časového limitu.

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

Poznámky

Ve výchozím nastavení volá Send blok metody, dokud se operace nekončí. Pokud nastavíte Timeout vlastnost na kladnou hodnotu a Send operace nemůže dokončit v přiděleném čase, SmtpClient třída vyvolá SmtpException výjimku.

Pokud chcete odeslat zprávu a pokračovat v provádění ve vlákně aplikace, použijte metodu SendAsync .