HttpWebRequest.ContentLength プロパティ

.NET Framework クラス ライブラリ リファレンス

HttpWebRequest.ContentLength プロパティ

Content-length HTTP ヘッダーを取得または設定します。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Overrides Property
 ContentLength As Long

Visual Basic (使用法)

Dim instance As HttpWebRequest
Dim value As Long

value = instance.ContentLength

instance.ContentLength = value

C#

public override long ContentLength { get; set;
 }

C++

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

J#

/** @property */
public long get_ContentLength ()

/** @property */
public void set_ContentLength (long value)

JScript

public override function get
 ContentLength () : long

public override function set
 ContentLength (value : long)

プロパティ値
インターネット リソースに送信するデータのバイト数。既定値は -1 です。このプロパティが設定されていないこと、および送信する要求データが存在しないことを示します。

例外

例外の種類	条件
InvalidOperationException	要求が GetRequestStream、BeginGetRequestStream、GetResponse、または BeginGetResponse の各メソッドの呼び出しによって開始されました。
ArgumentOutOfRangeException	新しい ContentLength の値が 0 未満です。

解説

ContentLength プロパティは、要求と共に Content-length HTTP ヘッダーとして送信する値を格納します。

ContentLength プロパティの -1 以外の値は、要求がデータをアップロードし、データをアップロードしたメソッドだけを Method プロパティで設定できることを示します。

ContentLength プロパティに値を設定すると、GetRequestStream メソッドまたは BeginGetRequestStream メソッドと EndGetRequestStream メソッドの両方を呼び出して返される要求ストリームにそのバイト数を書き込む必要があります。

メモ
このプロパティの値は WebHeaderCollection に格納されます。WebHeaderCollection が設定されている場合、プロパティ値は失われます。

使用例

ContentLength プロパティを、ポストされている文字列の長さに設定するコード例を次に示します。

Visual Basic

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

C#

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

C++

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

J#

// Set the 'Method' property of the 'Webrequest' to 'POST'.
myHttpWebRequest.set_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();
ubyte byte1[] = encoding.GetBytes(postData);

// Set the content type of the data being posted.
myHttpWebRequest.set_ContentType("application/x-www-form-"
    +"urlencoded");
// Set the content length of the string being posted.
myHttpWebRequest.set_ContentLength(postData.length());

Stream newStream = myHttpWebRequest.GetRequestStream();

newStream.Write(byte1, 0, byte1.length);
Console.WriteLine("The value of 'ContentLength' property after"
    + " sending the data is {0}", 
    System.Convert.ToString(myHttpWebRequest.get_ContentLength()));
// Close the Stream object.
newStream.Close();

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
HttpWebRequest クラス
HttpWebRequest メンバ
System.Net 名前空間