HttpWebRequest.ContentLength Özellik

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kod:

System.Net.Requests.dll

Kaynak:

HttpWebRequest.cs

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

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ı belirten -1 varsayılan değeridir.

Özel durumlar

InvalidOperationException

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

ArgumentOutOfRangeException

Yeni ContentLength değer 0'dan küçük.

Örnekler

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

// 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

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

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

ContentLength özelliği bir değere ayarlandıktan sonra, yöntemi veya hem hem de yöntemlerini çağırarak GetRequestStream döndürülen istek akışına BeginGetRequestStreamEndGetRequestStream bu bayt sayısının yazılması gerekir.

Not

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