HttpWebRequest.ContentLength Eigenschaft

Definition

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Ruft den Content-length-HTTP-Header ab oder legt diesen fest.

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

Eigenschaftswert

Int64

Die Anzahl der Bytes der an die Internetressource zu sendenden Daten. Der Standardwert ist -1. Dieser Wert gibt an, dass die Eigenschaft nicht festgelegt wurde und keine zu sendenden Anforderungsdaten vorhanden sind.

Ausnahmen

InvalidOperationException

Die Anforderung wurde durch Aufrufen der Methode GetRequestStream(), BeginGetRequestStream(AsyncCallback, Object), GetResponse() oder BeginGetResponse(AsyncCallback, Object) gestartet.

ArgumentOutOfRangeException

Der neue ContentLength-Wert ist kleiner als 0.

Beispiele

Im folgenden Codebeispiel wird die ContentLength -Eigenschaft auf die Länge der geposteten Zeichenfolge festgelegt.

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

Hinweise

Die ContentLength -Eigenschaft enthält den Wert, der Content-length als HTTP-Header mit der Anforderung gesendet werden soll.

Jeder andere Wert als -1 in der ContentLength -Eigenschaft gibt an, dass die Anforderung Daten hochlädt und dass nur Methoden, die Daten hochladen, in der Method -Eigenschaft festgelegt werden dürfen.

Nachdem die ContentLength -Eigenschaft auf einen Wert festgelegt wurde, muss diese Anzahl von Bytes in den Anforderungsdatenstrom geschrieben werden, der durch Aufrufen der GetRequestStream -Methode oder sowohl der -Methode als auch der BeginGetRequestStreamEndGetRequestStream -Methode zurückgegeben wird.

Hinweis

Der Wert für diese Eigenschaft wird in der WebHeaderCollection gespeichert. Wenn WebHeaderCollection festgelegt wird, geht der Eigenschaftswert verloren.