HttpWebRequest.ContentLength Propriété

Définition

Espace de noms:

System.Net

Assembly:

System.Net.Requests.dll

Source:

HttpWebRequest.cs

Obtient ou définit l’en-tête HTTP 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

Valeur de propriété

Int64

Nombre d'octets de données à envoyer à la ressource Internet. La valeur par défaut est -1, ce qui indique que la propriété n'a pas été définie et qu'aucune donnée de la requête ne doit être envoyée.

Exceptions

InvalidOperationException

La requête a été lancée en appelant la méthode GetRequestStream(), BeginGetRequestStream(AsyncCallback, Object), GetResponse() ou BeginGetResponse(AsyncCallback, Object).

ArgumentOutOfRangeException

La nouvelle valeur de ContentLength est inférieure à 0.

Exemples

L’exemple de code suivant définit la ContentLength propriété sur la longueur de la chaîne en cours de publication.

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

Remarques

La ContentLength propriété contient la valeur à envoyer en tant qu’en-tête Content-length HTTP avec la requête.

Toute valeur autre que -1 dans la ContentLength propriété indique que la requête charge des données et que seules les méthodes qui chargent des données sont autorisées à être définies dans la Method propriété .

Une fois la ContentLength propriété définie sur une valeur, ce nombre d’octets doit être écrit dans le flux de requête retourné en appelant la GetRequestStream méthode ou les BeginGetRequestStream méthodes et EndGetRequestStream .

Notes

La valeur de cette propriété est stockée dans WebHeaderCollection. Si WebHeaderCollection est défini, la valeur de la propriété est perdue.