次の方法で共有


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 オーバーロードの一覧