SmtpClient.Timeout Propriété

Définition

Espace de noms:

System.Net.Mail

Assemblys:

netstandard.dll, System.Net.Mail.dll

Source:

SmtpClient.cs

Obtient ou définit une valeur qui spécifie la durée après laquelle un appel synchrone Send expire.

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

Valeur de propriété

Int32

Valeur Int32 de délai d’attente en millisecondes. La valeur par défaut est 100 000 (100 secondes).

Exceptions

ArgumentOutOfRangeException

La valeur spécifiée pour une opération de jeu était inférieure à zéro.

InvalidOperationException

Vous ne pouvez pas modifier la valeur de cette propriété lorsqu’un e-mail est envoyé.

Exemples

L’exemple de code suivant illustre l’obtention et la définition de la valeur de délai d’attente.

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

Remarques

Par défaut, les appels au bloc de Send méthode jusqu’à la fin de l’opération. Si vous définissez la Timeout propriété sur une valeur positive et qu’une Send opération ne peut pas se terminer dans le temps imparti, la SmtpClient classe lève une SmtpException exception.

Pour envoyer un message et continuer à s’exécuter dans le thread d’application, utilisez la SendAsync méthode.