WebRequest.Create メソッド (Uri)
指定した URI スキーム用に新しい WebRequest のインスタンスを初期化します。
Overloads Public Shared Function Create( _
ByVal requestUri As Uri _) As WebRequest
[C#]
public static WebRequest Create(UrirequestUri);
[C++]
public: static WebRequest* Create(Uri* requestUri);
[JScript]
public static function Create(
requestUri : Uri) : WebRequest;
パラメータ
- requestUri
要求されたリソースの URI を格納する Uri 。
戻り値
指定した URI スキーム用の WebRequest 派生クラス。
例外
例外の種類 | 条件 |
---|---|
NotSupportedException | requestUri で指定された要求スキームが登録されていません。 |
ArgumentNullException | requestUri が null 参照 (Visual Basic では Nothing) です。 |
SecurityException | 呼び出し元に、要求された URI に接続するためのアクセス許可、または要求のリダイレクト先の URI に接続するためのアクセス許可がありません。 |
解説
Create メソッドは、 requestUri に最も近い登録 URI として実行時に決定される、 WebRequest クラスの派生クラスを返します。
たとえば、 https://www.contoso.com/text/
への要求を処理するために WebRequest 派生クラス Handler1 を作成し、 https://www.contoso.com/code/
への要求を処理するために別の派生クラス Handler2 を作成する場合は、 Create メソッドを使用すると、指定したいずれかの URI に関連付けられている WebRequest 派生クラスを返すことができます。
URI のスキーム部分だけに基づいて、 WebRequest 派生インスタンスを返すには、 CreateDefault メソッドを使用します。
.NET Framework は、 http://
、 https://
、 file://
の各 URI スキームをサポートしています。その他の要求を処理するカスタム WebRequest 派生クラスは、 RegisterPrefix メソッドで登録します。
使用例
[Visual Basic, C#, C++] Create を使用して、 HttpWebRequest インスタンスをインスタンス化する例を次に示します。ターゲット URL を表す URI がコンストラクタ パラメータとして使用されます。
' Create a new 'Uri' object with the specified string.
Dim myUri As New Uri("https://www.contoso.com")
' Create a new request to the above mentioned URL.
Dim myWebRequest As WebRequest = WebRequest.Create(myUri)
' Assign the response object of 'WebRequest' to a 'WebResponse' variable.
Dim myWebResponse As WebResponse = myWebRequest.GetResponse()
[C#]
// Create a new 'Uri' object with the specified string.
Uri myUri =new Uri("https://www.contoso.com");
// Create a new request to the above mentioned URL.
WebRequest myWebRequest= WebRequest.Create(myUri);
// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse myWebResponse= myWebRequest.GetResponse();
[C++]
// Create a new 'Uri' object with the specified string.
Uri* myUri = new Uri(S"https://www.contoso.com");
// Create a new request to the above mentioned URL.
WebRequest* myWebRequest= WebRequest::Create(myUri);
// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse* myWebResponse = myWebRequest->GetResponse();
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard
参照
WebRequest クラス | WebRequest メンバ | System.Net 名前空間 | WebRequest.Create オーバーロードの一覧