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

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

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

HttpWebRequest.ProtocolVersion プロパティ

要求に対して使用する HTTP バージョンを取得または設定します。

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

Visual Basic (宣言)

Public Property ProtocolVersion As
 Version

Visual Basic (使用法)

Dim instance As HttpWebRequest
Dim value As Version

value = instance.ProtocolVersion

instance.ProtocolVersion = value

public Version ProtocolVersion { get; set;
 }

C++

public:
property Version^ ProtocolVersion {
    Version^ get ();
    void set (Version^ value);
}

/** @property */
public Version get_ProtocolVersion ()

/** @property */
public void set_ProtocolVersion (Version value)

JScript

public function get ProtocolVersion
 () : Version

public function set ProtocolVersion
 (value : Version)

プロパティ値
要求に対して使用する HTTP バージョン。既定値は HttpVersion.Version11 です。

例外

例外の種類	条件
ArgumentException	HTTP バージョンが 1.0 または 1.1 以外の値に設定されています。

解説

HttpWebRequest クラスは、バージョン 1.0 およびバージョン 1.1 の HTTP だけをサポートしています。ProtocolVersion をこれ以外のバージョンに設定すると、例外がスローされます。

メモ
現在の要求の HTTP バージョンを設定するには、HttpVersion クラスの Version10 フィールドと Version11 フィールドを使用します。

使用例

ProtocolVersion プロパティを設定するコード例を次に示します。

Visual Basic

' Create a new 'HttpWebRequest' Object to the mentioned URL.
Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create("http://www.microsoft.com"),
 HttpWebRequest)
' Use the existing 'ProtocolVersion' , and display it onto the console.
    
Console.WriteLine(ControlChars.Cr + "The 'ProtocolVersion' of the
 protocol used is {0}", myHttpWebRequest.ProtocolVersion)
' Set the 'ProtocolVersion' property of the 'HttpWebRequest' to 'Version1.0'
 .
myHttpWebRequest.ProtocolVersion = HttpVersion.Version10
'  Assign the response object of 'HttpWebRequest' to a 'HttpWebResponse'
 variable.
Dim myHttpWebResponse As HttpWebResponse =
 CType(myHttpWebRequest.GetResponse(), HttpWebResponse)
Console.WriteLine(ControlChars.Cr + "The 'ProtocolVersion' of the
 protocol changed to {0}", myHttpWebRequest.ProtocolVersion)
Console.WriteLine(ControlChars.Cr + "The protocol version of the
 response object is {0}", myHttpWebResponse.ProtocolVersion)

// Create a new 'HttpWebRequest' Object to the mentioned URL.
HttpWebRequest myHttpWebRequest=(HttpWebRequest)WebRequest.Create("http://www.microsoft.com");
// Use the existing 'ProtocolVersion' , and display it onto the console.
    
Console.WriteLine("\nThe 'ProtocolVersion' of the protocol used is {0}"
,myHttpWebRequest.ProtocolVersion);
// Set the 'ProtocolVersion' property of the 'HttpWebRequest' to 'Version1.0'
 .
myHttpWebRequest.ProtocolVersion=HttpVersion.Version10;
 // Assign the response object of 'HttpWebRequest' to a 'HttpWebResponse'
 variable.
 HttpWebResponse myHttpWebResponse=(HttpWebResponse)myHttpWebRequest.GetResponse();
Console.WriteLine("\nThe 'ProtocolVersion' of the protocol changed to {0}"
,myHttpWebRequest.ProtocolVersion);
Console.WriteLine("\nThe protocol version of the response object is {0}"
,myHttpWebResponse.ProtocolVersion);

C++

// Create a new 'HttpWebRequest' Object to the mentioned URL.
HttpWebRequest^ myHttpWebRequest = (HttpWebRequest^)( WebRequest::Create( "http://www.microsoft.com"
 ) );
// Use the existing 'ProtocolVersion' , and display it onto the console.
Console::WriteLine( "\nThe 'ProtocolVersion' of the protocol used is {0}",
 myHttpWebRequest->ProtocolVersion );
// Set the 'ProtocolVersion' property of the 'HttpWebRequest' to 'Version1::0'
 .
myHttpWebRequest->ProtocolVersion = HttpVersion::Version10;
// Assign the response object of 'HttpWebRequest' to a 'HttpWebResponse'
 variable.
HttpWebResponse^ myHttpWebResponse = (HttpWebResponse^)( myHttpWebRequest->GetResponse()
 );
Console::WriteLine( "\nThe 'ProtocolVersion' of the protocol changed to {0}",
 myHttpWebRequest->ProtocolVersion );
Console::WriteLine( "\nThe protocol version of the response Object* is {0}",
 myHttpWebResponse->ProtocolVersion );

// Create a new 'HttpWebRequest' Object to the mentioned URL.
HttpWebRequest myHttpWebRequest = (HttpWebRequest)
    WebRequest.Create("http://www.microsoft.com");

// Use the existing 'ProtocolVersion' , and display it onto 
// the console.
Console.WriteLine("\nThe 'ProtocolVersion' of the "
    +"protocol used is {0}",
    myHttpWebRequest.get_ProtocolVersion());

// Set the 'ProtocolVersion' property of the 'HttpWebRequest' to
// 'Version1.0'.
myHttpWebRequest.set_ProtocolVersion(HttpVersion.Version10);

// Assign the response object of 'HttpWebRequest' to a 
// 'HttpWebResponse' variable.
HttpWebResponse myHttpWebResponse = (HttpWebResponse)
    myHttpWebRequest.GetResponse();
Console.WriteLine("\nThe 'ProtocolVersion' of the protocol"
    +" changed to {0}", myHttpWebRequest.get_ProtocolVersion());
Console.WriteLine("\nThe protocol version of the response object"
    +" is {0}", myHttpWebResponse.get_ProtocolVersion());