ServicePoint.Expect100Continue Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia wartość Boolean, która określa, czy jest używane zachowanie 100-Kontynuuj.
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
Wartość właściwości
true
oczekiwać 100-kontynuuj odpowiedzi dla żądań POST
; w przeciwnym razie false
. Wartość domyślna to true
.
Przykłady
Poniższy przykład kodu wyświetla wartość tej właściwości.
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())
Uwagi
Ostrożność
WebRequest
, HttpWebRequest
, ServicePoint
i WebClient
są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.
Gdy ta właściwość jest ustawiona na true
, żądania klientów używające metody POST
oczekują otrzymania odpowiedzi 100-Continue z serwera, aby wskazać, że klient powinien wysłać dane do opublikowania. Ten mechanizm umożliwia klientom unikanie wysyłania dużych ilości danych przez sieć, gdy serwer na podstawie nagłówków żądań zamierza odrzucić żądanie.
Załóżmy na przykład, że właściwość Expect100Continue jest false
. Gdy żądanie jest wysyłane do serwera, zawiera dane. Jeśli po odczytaniu nagłówków żądania serwer wymaga uwierzytelnienia i wyśle odpowiedź 401, klient musi ponownie wysłać dane z odpowiednimi nagłówkami uwierzytelniania.
Jeśli właściwość Expect100Continue jest true
, nagłówki żądań są wysyłane do serwera. Jeśli serwer nie odrzucił żądania, wysyła odpowiedź 100-Continue sygnalizując, że dane mogą być przesyłane. Jeśli tak jak w poprzednim przykładzie serwer wymaga uwierzytelnienia, wysyła odpowiedź 401, a klient nie niepotrzebnie przesyłał danych.
Zmiana wartości tej właściwości nie ma wpływu na istniejące połączenia. Zmiany dotyczą tylko nowych połączeń utworzonych po zmianie.
Zachowanie Oczekiwanej kontynuacji 100 jest w pełni opisane w sekcji IETF RFC 2616 10.1.1.