WebRequest.RequestUri プロパティ

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

WebRequest.RequestUri プロパティ

派生クラスでオーバーライドされると、要求に関連付けられたインターネット リソースの URI を取得します。

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

Visual Basic (宣言)

Public Overridable ReadOnly
 Property RequestUri As Uri

Visual Basic (使用法)

Dim instance As WebRequest
Dim value As Uri

value = instance.RequestUri

C#

public virtual Uri RequestUri { get; }

C++

public:
virtual property Uri^ RequestUri {
    Uri^ get ();
}

J#

/** @property */
public Uri get_RequestUri ()

JScript

public function get RequestUri
 () : Uri

プロパティ値
要求に関連付けられているリソースを表す Uri。

例外

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

解説

派生クラスでオーバーライドされると、RequestUri プロパティは、Create メソッドが要求を作成するために使用する Uri インスタンスを格納します。

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

継承時の注意 RequestUri は、Create メソッドに渡される元の Uri インスタンスを格納する必要があります。要求を実行するために、プロトコルがその要求を異なる URI にリダイレクトできる場合、派生クラスは、実際に要求を実行する URI を格納したプロパティを提供する必要があります。

使用例

RequestUri プロパティを確認して、最初に要求されたサイトかどうかを確かめる例を次に示します。

Visual Basic

' Create a new WebRequest Object to the mentioned URL.
Dim myWebRequest As WebRequest = WebRequest.Create("http://www.example.com")
Console.WriteLine(ControlChars.Cr + "The Uri that responded for
 the Request is   {0}", myWebRequest.RequestUri)
' Assign the response object of 'WebRequest' to a 'WebResponse' variable.
Dim myWebResponse As WebResponse = myWebRequest.GetResponse()
' Print the HTML contents of the page to the console. 
Dim streamResponse As Stream = myWebResponse.GetResponseStream()
Dim streamRead As New StreamReader(streamResponse)
Dim readBuff(256) As [Char]
Dim count As Integer = streamRead.Read(readBuff,
 0, 256)
Console.WriteLine(ControlChars.Cr + "The Uri that responded for
 the Request is   {0}", myWebRequest.RequestUri)

C#

// Create a new WebRequest Object to the mentioned URL.
WebRequest myWebRequest=WebRequest.Create("http://www.example.com");
Console.WriteLine("\nThe Uri that responded for the Request
 is   {0}",myWebRequest.RequestUri);
// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse myWebResponse=myWebRequest.GetResponse();
// Print the HTML contents of the page to the console. 
Stream streamResponse=myWebResponse.GetResponseStream();
StreamReader streamRead = new StreamReader( streamResponse );
Char[] readBuff = new Char[256];
int count = streamRead.Read( readBuff, 0, 256 );    
Console.WriteLine("\nThe Uri that responded for the Request
 is '{0}'",myWebRequest.RequestUri);

C++

// Create a new WebRequest object to the mentioned URL.
WebRequest^ myWebRequest = WebRequest::Create( "http://www.example.com"
 );
Console::WriteLine( "\nThe Uri that responded for the Request
 is {0}", myWebRequest->RequestUri );
// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse^ myWebResponse = myWebRequest->GetResponse();
// Print the HTML contents of the page to the console.
Stream^ streamResponse = myWebResponse->GetResponseStream();
StreamReader^ streamRead = gcnew StreamReader( streamResponse );
array<Char>^ readBuff = gcnew array<Char>(256);
int count = streamRead->Read( readBuff, 0, 256 );
Console::WriteLine( "\nThe Uri that responded for the Request
 is ' {0}'", myWebRequest->RequestUri );

J#

// Create a new WebRequest Object to the mentioned URL.
WebRequest myWebRequest = WebRequest.Create("http://www.example.com");
Console.WriteLine("\nThe Uri that responded for the Request
 is   {0}",
    myWebRequest.get_RequestUri());
// Assign the response object of 'WebRequest' to a 'WebResponse'
// variable.
WebResponse myWebResponse = myWebRequest.GetResponse();
// Print the HTML contents of the page to the console. 
Stream streamResponse = myWebResponse.GetResponseStream();
StreamReader streamRead = new StreamReader(streamResponse);
char readBuff[] = new char[256];
int count = streamRead.Read(readBuff, 0, 256);
Console.WriteLine("\nThe Uri that responded for the Request"
 
    + " is '{0}'", myWebRequest.get_RequestUri());

プラットフォーム

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

参照

関連項目
WebRequest クラス
WebRequest メンバ
System.Net 名前空間
HttpWebRequest.RequestUri プロパティ
HttpWebRequest.Address プロパティ