ServicePoint.Expect100Continue Properti

Definisi

Ruang nama:

System.Net

Rakitan:

netstandard.dll, System.Net.Requests.dll

Sumber:

ServicePoint.cs

Mendapatkan atau menetapkan Boolean nilai yang menentukan apakah perilaku 100-Lanjutkan digunakan.

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

Nilai Properti

Boolean

true untuk mengharapkan 100-Lanjutkan respons untuk POST permintaan; jika tidak, false. Nilai defaultnya adalah true.

Contoh

Contoh kode berikut menampilkan nilai properti ini.

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())

Keterangan

Caution

WebRequest, , HttpWebRequestServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Ketika properti ini diatur ke true, permintaan klien yang menggunakan POST metode mengharapkan untuk menerima respons 100-Lanjutkan dari server untuk menunjukkan bahwa klien harus mengirim data yang akan diposting. Mekanisme ini memungkinkan klien untuk menghindari pengiriman data dalam jumlah besar melalui jaringan ketika server, berdasarkan header permintaan, berniat untuk menolak permintaan.

Misalnya, asumsikan Expect100Continue propertinya adalah false. Ketika permintaan dikirim ke server, permintaan tersebut menyertakan data. Jika, setelah membaca header permintaan, server memerlukan autentikasi dan mengirim respons 401, klien harus mengirim ulang data dengan header autentikasi yang tepat.

Expect100Continue Jika properti adalah true, header permintaan dikirim ke server. Jika server belum menolak permintaan, server mengirimkan sinyal respons 100-Lanjutkan yang menandakan bahwa data dapat dikirimkan. Jika, seperti dalam contoh sebelumnya, server memerlukan autentikasi, server mengirimkan respons 401 dan klien tidak perlu mengirimkan data.

Mengubah nilai properti ini tidak memengaruhi koneksi yang ada. Hanya koneksi baru yang dibuat setelah perubahan terpengaruh.

Perilaku Expect 100-Continue sepenuhnya dijelaskan dalam IETF RFC 2616 Bagian 10.1.1.

Note

Sejak .NET 9, properti ini mengatur HttpRequestHeaders.ExpectContinue pada HttpRequestMessage.Headers.