ServicePoint.Expect100Continue Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen eines Boolean Werts, der bestimmt, ob das Verhalten von 100-Continue verwendet wird.
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
Eigenschaftswert
true
100-Fortsetzungsantworten für POST
Anforderungen erwarten; andernfalls false
. Der Standardwert ist true
.
Beispiele
Im folgenden Codebeispiel wird der Wert dieser Eigenschaft angezeigt.
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())
Hinweise
Vorsicht
WebRequest
, HttpWebRequest
, ServicePoint
und WebClient
sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.
Wenn diese Eigenschaft auf true
festgelegt ist, werden Clientanforderungen, die die POST
-Methode verwenden, erwarten, dass eine 100-Continue-Antwort vom Server empfangen wird, um anzugeben, dass der Client die zu postenden Daten senden soll. Mit diesem Mechanismus können Clients das Senden großer Datenmengen über das Netzwerk vermeiden, wenn der Server basierend auf den Anforderungsheadern die Anforderung ablehnen möchte.
Angenommen, die eigenschaft Expect100Continue ist false
. Wenn die Anforderung an den Server gesendet wird, enthält sie die Daten. Wenn der Server nach dem Lesen der Anforderungsheader eine Authentifizierung erfordert und eine 401-Antwort sendet, muss der Client die Daten mit den richtigen Authentifizierungsheadern erneut senden.
Wenn die eigenschaft Expect100Continuetrue
ist, werden die Anforderungsheader an den Server gesendet. Wenn der Server die Anforderung nicht abgelehnt hat, sendet er ein 100-Continue-Antwortsignal, das signalisiert, dass die Daten übertragen werden können. Wenn der Server wie im vorherigen Beispiel eine Authentifizierung erfordert, sendet er die Antwort 401, und der Client hat die Daten nicht unnötig übertragen.
Das Ändern des Werts dieser Eigenschaft wirkt sich nicht auf vorhandene Verbindungen aus. Nur neue Verbindungen, die nach der Änderung erstellt wurden, sind betroffen.
Das Verhalten "100-Continue" wird vollständig in IETF RFC 2616 Abschnitt 10.1.1 beschrieben.