HttpWebRequest.ContentLength Özellik

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

System.Net.Requests.dll

Kaynak:

HttpWebRequest.cs

Content-length HTTP üst bilgisini alır veya ayarlar.

public:
 virtual property long ContentLength { long get(); void set(long value); };

public override long ContentLength { get; set; }

member this.ContentLength : int64 with get, set

Public Overrides Property ContentLength As Long

Özellik Değeri

Int64

İnternet kaynağına gönderilecek veri bayt sayısı. Özelliğin ayarlanmadığını ve gönderilecek istek verisi olmadığını gösteren -1 varsayılan değeridir.

Özel durumlar

InvalidOperationException

İstek, GetRequestStream(), BeginGetRequestStream(AsyncCallback, Object), GetResponse()veya BeginGetResponse(AsyncCallback, Object) yöntemi çağrılarak başlatılmıştır.

ArgumentOutOfRangeException

Yeni ContentLength değeri 0'dan küçüktür.

Örnekler

Aşağıdaki kod örneği, ContentLength özelliğini gönderilen dizenin uzunluğuna ayarlar.

// Set the 'Method' property of the 'Webrequest' to 'POST'.
myHttpWebRequest->Method = "POST";
Console::WriteLine( "\nPlease enter the data to be posted to the (http://www.contoso.com/codesnippets/next.asp) Uri :" );

// Create a new String* Object* to POST data to the Url.
String^ inputData = Console::ReadLine();

String^ postData = String::Concat( "firstone= ", inputData );
ASCIIEncoding^ encoding = gcnew ASCIIEncoding;
array<Byte>^ byte1 = encoding->GetBytes( postData );

// Set the content type of the data being posted.
myHttpWebRequest->ContentType = "application/x-www-form-urlencoded";

// Set the content length of the String* being posted.
myHttpWebRequest->ContentLength = byte1->Length;

Stream^ newStream = myHttpWebRequest->GetRequestStream();

newStream->Write( byte1, 0, byte1->Length );
Console::WriteLine( "The value of 'ContentLength' property after sending the data is {0}", myHttpWebRequest->ContentLength );

// Close the Stream Object*.
newStream->Close();

// Set the 'Method' property of the 'Webrequest' to 'POST'.
myHttpWebRequest.Method = "POST";
Console.WriteLine ("\nPlease enter the data to be posted to the (http://www.contoso.com/codesnippets/next.asp) Uri :");

// Create a new string object to POST data to the Url.
string inputData = Console.ReadLine ();


string postData = "firstone=" + inputData;
ASCIIEncoding encoding = new ASCIIEncoding ();
byte[] byte1 = encoding.GetBytes (postData);

// Set the content type of the data being posted.
myHttpWebRequest.ContentType = "application/x-www-form-urlencoded";

// Set the content length of the string being posted.
myHttpWebRequest.ContentLength = byte1.Length;

Stream newStream = myHttpWebRequest.GetRequestStream ();

newStream.Write (byte1, 0, byte1.Length);
Console.WriteLine ("The value of 'ContentLength' property after sending the data is {0}", myHttpWebRequest.ContentLength);

// Close the Stream object.
newStream.Close ();

' Set the 'Method' property of the 'Webrequest' to 'POST'.
myHttpWebRequest.Method = "POST"

Console.WriteLine(ControlChars.Cr + "Please enter the data to be posted to the (http://www.contoso.com/codesnippets/next.asp) Uri :")
' Create a new string object to POST data to the Url.
Dim inputData As String = Console.ReadLine()
Dim postData As String = "firstone" + ChrW(61) + inputData
Dim encoding As New ASCIIEncoding()
Dim byte1 As Byte() = encoding.GetBytes(postData)
' Set the content type of the data being posted.
myHttpWebRequest.ContentType = "application/x-www-form-urlencoded"
' Set the content length of the string being posted.
myHttpWebRequest.ContentLength = byte1.Length
Dim newStream As Stream = myHttpWebRequest.GetRequestStream()
newStream.Write(byte1, 0, byte1.Length)
Console.WriteLine("The value of 'ContentLength' property after sending the data is {0}", myHttpWebRequest.ContentLength)
newStream.Close()

Açıklamalar

Dikkat

WebRequest, HttpWebRequest, ServicePointve WebClient kullanım dışıdır ve bunları yeni geliştirme için kullanmamalısınız. Bunun yerine HttpClient kullanın.

ContentLength özelliği, isteği içeren Content-length HTTP üst bilgisi olarak gönderilecek değeri içerir.

ContentLength özelliğindeki -1 dışındaki herhangi bir değer, isteğin verileri karşıya yüklediğini ve yalnızca verileri karşıya yükleyen yöntemlerin Method özelliğinde ayarlanmasına izin verildiğini gösterir.

ContentLength özelliği bir değere ayarlandıktan sonra, GetRequestStream yöntemi veya hem BeginGetRequestStream hem de EndGetRequestStream yöntemleri çağrılarak döndürülen istek akışına bu sayıda bayt yazılmalıdır.

Not

Bu özelliğin değeri WebHeaderCollectioniçinde depolanır. WebHeaderCollection ayarlanırsa özellik değeri kaybolur.