ServicePointManager.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ść 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, setPublic Shared Property Expect100Continue As BooleanWartość właściwości
true aby włączyć zachowanie 100-Kontynuuj. Domyślna wartość 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
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 spowodują dodanie nagłówka Expect do żądania, jeśli Expect100Continue właściwość jest trueContentLength i 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. Zmiany dotyczą 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 truewartość .
Zachowanie Oczekiwanej kontynuacji 100 jest w pełni opisane w sekcji IETF RFC 2616 10.1.1.
Uwaga / Notatka
Ponieważ platforma .NET 9, ta właściwość jest ustawiana HttpRequestHeaders.ExpectContinue na obiekcie HttpRequestMessage.Headers , chyba że zostanie zastąpiona przez .ServicePoint.Expect100Continue
