ServicePoint.Expect100Continue Propriété

Définition

Espace de noms:

System.Net

Assembly:

System.Net.ServicePoint.dll

Source:

ServicePoint.cs

Obtient ou définit une valeur Boolean qui détermine si le comportement 100-Continue doit être utilisé.

public:
 property bool Expect100Continue { bool get(); void set(bool value); };

public bool Expect100Continue { get; set; }

member this.Expect100Continue : bool with get, set

Public Property Expect100Continue As Boolean

Valeur de propriété

Boolean

true si des réponses 100-Continue sont attendues pour les demandes POST ; sinon, false. La valeur par défaut est true.

Exemples

L’exemple de code suivant affiche la valeur de cette propriété.

Console::WriteLine( "UseNagleAlgorithm = {0} ", sp->UseNagleAlgorithm.ToString() );
Console::WriteLine( "Expect 100-continue = {0}", sp->Expect100Continue.ToString() );

Console.WriteLine("UseNagleAlgorithm = " + sp.UseNagleAlgorithm.ToString());
Console.WriteLine("Expect 100-continue = " + sp.Expect100Continue.ToString());

Console.WriteLine("UseNagleAlgorithm = " + sp.UseNagleAlgorithm.ToString())
Console.WriteLine("Expect 100-continue = " + sp.Expect100Continue.ToString())

Remarques

Lorsque cette propriété est définie sur true, les demandes client qui utilisent la POST méthode s’attendent à recevoir une réponse 100-Continue du serveur pour indiquer que le client doit envoyer les données à publier. Ce mécanisme permet aux clients d’éviter d’envoyer de grandes quantités de données sur le réseau lorsque le serveur, en fonction des en-têtes de requête, a l’intention de rejeter la demande.

Par exemple, supposons que la Expect100Continue propriété soit false. Lorsque la demande est envoyée au serveur, elle inclut les données. Si, après avoir lu les en-têtes de requête, le serveur nécessite une authentification et envoie une réponse 401, le client doit renvoyer les données avec les en-têtes d’authentification appropriés.

Si la propriété a la Expect100Continue valeur true, les en-têtes de requête sont envoyés au serveur. Si le serveur n’a pas rejeté la demande, il envoie une réponse 100-Continue signalant que les données peuvent être transmises. Si, comme dans l’exemple précédent, le serveur nécessite une authentification, il envoie la réponse 401 et le client n’a pas transmis inutilement les données.

La modification de la valeur de cette propriété n’affecte pas les connexions existantes. Seules les nouvelles connexions créées après la modification sont affectées.

Le comportement Expect 100-Continue est entièrement décrit dans IETF RFC 2616 Section 10.1.1.