WebRequest.Create メソッド

定義

名前空間:

System.Net

アセンブリ:

System.Net.Requests.dll

新しい WebRequest を初期化します。

オーバーロード

Create(String)	古い. 指定した URI スキーム用に新しい WebRequest のインスタンスを初期化します。
Create(Uri)	古い. 指定した URI スキーム用に新しい WebRequest のインスタンスを初期化します。

Create(String)

注意事項

WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.

指定した URI スキーム用に新しい WebRequest のインスタンスを初期化します。

public:
 static System::Net::WebRequest ^ Create(System::String ^ requestUriString);

[System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static System.Net.WebRequest Create (string requestUriString);

[<System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member Create : string -> System.Net.WebRequest

Public Shared Function Create (requestUriString As String) As WebRequest

パラメーター

requestUriString

String

インターネット リソースを識別する URI。

戻り値

WebRequest

特定の URI スキーム用の WebRequest 派生クラス。

属性

ObsoleteAttribute

例外

NotSupportedException

requestUriString で指定された要求スキームが登録されていません。

ArgumentNullException

requestUriString が nullです。

SecurityException

呼び出し元には、要求された URI または要求のリダイレクト先である URI に接続するための WebPermissionAttribute アクセス許可がありません。

UriFormatException

requestUriString で指定された URI は、有効な URI ではありません。

注: .NET for Windows ストア アプリ または ポータブル クラス ライブラリでは、代わりに基底クラスの例外 FormatExceptionをキャッチします。

例

次の例では、 を使用 Create して インスタンスを HttpWebRequest インスタンス化します。 ターゲット URL を表す文字列がコンストラクター パラメーターとして使用されます。

Uri^ ourUri = gcnew Uri( url );

// Create a 'WebRequest' object with the specified url.
WebRequest^ myWebRequest = WebRequest::Create( url );

// Send the 'WebRequest' and wait for response.
WebResponse^ myWebResponse = myWebRequest->GetResponse();

// Use "ResponseUri" property to get the actual Uri from where the response was attained.
if ( ourUri->Equals( myWebResponse->ResponseUri ) )
{
   Console::WriteLine( "\nRequest Url : {0} was not redirected", url );
}
else
{
   Console::WriteLine( "\nRequest Url : {0} was redirected to {1}", url, myWebResponse->ResponseUri );
}

// Release resources of response object.
myWebResponse->Close();

Uri ourUri = new Uri(url);            

// Create a 'WebRequest' object with the specified url. 
WebRequest myWebRequest = WebRequest.Create(url); 

// Send the 'WebRequest' and wait for response.
WebResponse myWebResponse = myWebRequest.GetResponse(); 

// Use "ResponseUri" property to get the actual Uri from where the response was attained.
if (ourUri.Equals(myWebResponse.ResponseUri))
    Console.WriteLine("\nRequest Url : {0} was not redirected",url);   
else
    Console.WriteLine("\nRequest Url : {0} was redirected to {1}",url,myWebResponse.ResponseUri);   
// Release resources of response object.
myWebResponse.Close();

Dim ourUri As New Uri(url)
' Create a 'WebRequest' object with the specified url. 

Dim myWebRequest As WebRequest = WebRequest.Create(url)

' Send the 'WebRequest' and wait for response.
Dim myWebResponse As WebResponse = myWebRequest.GetResponse()

' "ResponseUri" property is used to get the actual Uri from where the response was attained.
If ourUri.Equals(myWebResponse.ResponseUri) Then
    Console.WriteLine(ControlChars.Cr + "Request Url : {0} was not redirected", url)
Else
    Console.WriteLine(ControlChars.Cr + "Request Url : {0} was redirected to {1}", url, myWebResponse.ResponseUri)
End If 

' Release resources of response object.
myWebResponse.Close()

注釈

メソッドは Create 、 に最も近い登録済み一致として実行時に決定された クラスの子孫 WebRequest を requestUri返します。

たとえば、 または でhttp://始まる URI が でHttpWebRequestrequestUri渡されると、 によって Createが返https://されます。 で始まる ftp:// URI が代わりに渡された場合、 Create メソッドは インスタンスを FtpWebRequest 返します。 で始まる file:// URI が代わりに渡された場合、 Create メソッドは インスタンスを FileWebRequest 返します。

既に登録されている事前登録済みの予約の種類は次のとおりです。

• http://

• https://

• ftp://

• file://

.NET には、http://https://ftp://、および file:// URI スキームのサポートが含まれています。 他の要求を処理するカスタム WebRequest 子孫は、 メソッドに RegisterPrefix 登録されます。

メソッドは Create 、 パラメーターを requestUriString 使用して、 Uri 新しい WebRequestに渡すインスタンスを作成します。

Note

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。

こちらもご覧ください

• プラグ可能なプロトコルのプログラミング

Create(Uri)

注意事項

WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.

指定した URI スキーム用に新しい WebRequest のインスタンスを初期化します。

public:
 static System::Net::WebRequest ^ Create(Uri ^ requestUri);

[System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static System.Net.WebRequest Create (Uri requestUri);

[<System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member Create : Uri -> System.Net.WebRequest

Public Shared Function Create (requestUri As Uri) As WebRequest

パラメーター

requestUri

Uri

要求されたリソースの URI を格納する Uri。

戻り値

WebRequest

指定した URI スキーム用の WebRequest 派生クラス。

属性

ObsoleteAttribute

例外

NotSupportedException

requestUri で指定された要求スキームが登録されていません。

ArgumentNullException

requestUri が nullです。

SecurityException

呼び出し元には、要求された URI または要求のリダイレクト先である URI に接続するための WebPermissionAttribute アクセス許可がありません。

例

次の例では、 を使用 Create して インスタンスを HttpWebRequest インスタンス化します。 ターゲット URL を表す URI がコンストラクター パラメーターとして使用されます。

// Create a new 'Uri' object with the specified string.
Uri^ myUri = gcnew Uri( "http://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();

// Create a new 'Uri' object with the specified string.
Uri myUri =new Uri("http://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();

' Create a new 'Uri' object with the specified string.
Dim myUri As New Uri("http://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()

注釈

メソッドは Create 、 に最も近い登録済み一致として実行時に決定された クラスの子孫 WebRequest を requestUri返します。

たとえば、 への要求を WebRequest 処理する子孫 Handler1 と、 への要求を http://www.contoso.com/text/ 処理 http://www.contoso.com/code/する別の名前付き Handler2 を作成する場合は、 メソッドを使用 Create して、指定された URI に関連付けられている WebRequest の子孫を返すことができます。

URI のスキーム部分のみに基づいてクラスの WebRequest 子孫を返すには、 メソッドを使用します CreateDefault 。

たとえば、 または でhttp://始まる URI が でHttpWebRequestrequestUri渡されると、 によって Createが返https://されます。 で始まる ftp:// URI が代わりに渡された場合、 Create メソッドは インスタンスを FileWebRequest 返します。 で始まる file:// URI が代わりに渡された場合、 Create メソッドは インスタンスを FileWebRequest 返します。

既に登録されている事前登録済みの予約の種類は次のとおりです。

• http://

• https://

• ftp://

• file://

.NET には、http://https://ftp://、および file:// URI スキームのサポートが含まれています。 他の要求を処理するカスタム WebRequest 子孫は、 メソッドに RegisterPrefix 登録されます。

Note

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。