ServicePointManager.Expect100Continue Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Net

Zestaw:: System.Net.ServicePoint.dll

Zestaw:: System.Net.Requests.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Źródło:: ServicePointManager.cs

Źródło:: ServicePointManager.cs

Źródło:: ServicePointManager.cs

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ść określającą Boolean , czy jest używane zachowanie 100-Kontynuuj.

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

public static bool Expect100Continue { get; set; }

static member Expect100Continue : bool with get, set

Public Shared Property Expect100Continue As Boolean

Wartość właściwości

Boolean

true aby włączyć zachowanie 100-Kontynuuj. Wartość domyślna to true.

Przykłady

Poniższy przykład kodu ustawia tę właściwość.

ServicePointManager::UseNagleAlgorithm = true;
ServicePointManager::Expect100Continue = true;
ServicePointManager::CheckCertificateRevocationList = true;
ServicePointManager::DefaultConnectionLimit = ServicePointManager::DefaultPersistentConnectionLimit;

ServicePointManager.UseNagleAlgorithm = true;
ServicePointManager.Expect100Continue = true;
ServicePointManager.CheckCertificateRevocationList = true;
ServicePointManager.DefaultConnectionLimit = ServicePointManager.DefaultPersistentConnectionLimit;

ServicePointManager.UseNagleAlgorithm = True
ServicePointManager.Expect100Continue = True
ServicePointManager.CheckCertificateRevocationList = True
ServicePointManager.DefaultConnectionLimit = _
    ServicePointManager.DefaultPersistentConnectionLimit

Uwagi

Gdy ta właściwość jest ustawiona na true, jest używane zachowanie 100-Kontynuuj. Żądania klienta korzystające z PUT metod i POST dodają nagłówek Expect do żądania, jeśli Expect100Continue właściwość jest true i ContentLength właściwość jest większa niż zero lub SendChunked właściwość ma wartość true. Klient będzie oczekiwać otrzymania odpowiedzi 100-Continue z serwera, aby wskazać, że klient powinien wysłać dane do wysłania. 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 Expect100Continue właściwość to false. Gdy żądanie jest wysyłane do serwera, zawiera dane. Jeśli po odczytaniu nagłówków żądania serwer wymaga uwierzytelnienia i musi wysłać odpowiedź 401, klient musi ponownie wysłać dane z odpowiednimi nagłówkami uwierzytelniania.

Jeśli ta właściwość to 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 ServicePoint obiekty. Dotyczy to tylko nowych ServicePoint obiektów utworzonych po zmianie.

Zachowanie 100-Kontynuuj nie jest używane dla żądań HTTP 1.0, nawet jeśli ta właściwość jest ustawiona na true.

Zachowanie Oczekiwane 100-Kontynuuj jest w pełni opisane w sekcji IETF RFC 2616 Sekcja 10.1.1.

Dotyczy

Zobacz też

ServicePoint