WebRequest.ContentLength プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

WebRequest.ContentLength プロパティ

派生クラスでオーバーライドされると、送信している要求データのコンテンツ長を取得または設定します。

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

Visual Basic (宣言)

Public Overridable Property
 ContentLength As Long

Visual Basic (使用法)

Dim instance As WebRequest
Dim value As Long

value = instance.ContentLength

instance.ContentLength = value

public virtual long ContentLength { get; set;
 }

C++

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

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

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

JScript

public function get ContentLength
 () : long

public function set ContentLength
 (value : long)

プロパティ値
送信している要求データのバイト数。

例外

例外の種類	条件
NotImplementedException	プロパティが派生クラスでオーバーライドされていないのに、そのプロパティの取得または設定が試行されました。

解説

ContentLength プロパティは、WebRequest インスタンスによってインターネットリソースに送信されるデータのバイト数を格納します。

メモ
WebRequest クラスは、abstract クラスです。実行時の WebRequest インスタンスの実際の動作は、System.Net.WebRequest.Create メソッドで返される派生クラスによって決まります。既定値および例外の詳細については、HttpWebRequest や FileWebRequest などの派生クラスの説明を参照してください。

使用例

ContentLength プロパティを発信バイトバッファのバイト数の値に設定する例を次に示します。

Visual Basic


' Set the 'ContentType' property of the WebRequest.
myWebRequest.ContentType = "application/x-www-form-urlencoded"

' Set the 'ContentLength' property of the WebRequest.
myWebRequest.ContentLength = byteArray.Length
Dim newStream As Stream = myWebRequest.GetRequestStream()
newStream.Write(byteArray, 0, byteArray.Length)

' Close the Stream object.
newStream.Close()

' Assign the response object of 'WebRequest' to a 'WebResponse' variable.
Dim myWebResponse As WebResponse = myWebRequest.GetResponse()

// Set the 'ContentType' property of the WebRequest.
myWebRequest.ContentType="application/x-www-form-urlencoded";

// Set the 'ContentLength' property of the WebRequest.
myWebRequest.ContentLength=byteArray.Length;
Stream newStream=myWebRequest.GetRequestStream();
newStream.Write(byteArray,0,byteArray.Length);

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

// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse myWebResponse=myWebRequest.GetResponse();

C++

// Set the 'ContentType' property of the WebRequest.
myWebRequest->ContentType = "application/x-www-form-urlencoded";

// Set the 'ContentLength' property of the WebRequest.
myWebRequest->ContentLength = byteArray->Length;
Stream^ newStream = myWebRequest->GetRequestStream();
newStream->Write( byteArray, 0, byteArray->Length );

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

// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse^ myWebResponse = myWebRequest->GetResponse();

// Set the 'ContentType' property of the WebRequest.
myWebRequest.set_ContentType("application/x-www-form-urlencoded");
// Set the 'ContentLength' property of the WebRequest.
myWebRequest.set_ContentLength(byteArray.get_Length());
Stream newStream = myWebRequest.GetRequestStream();
newStream.Write(byteArray, 0, byteArray.get_Length());
// Close the Stream object.
newStream.Close();
// Assign the response object of 'WebRequest' to a 'WebResponse' 
// variable.
WebResponse myWebResponse = myWebRequest.GetResponse();