WebRequest.Create WebRequest.Create WebRequest.Create WebRequest.Create Method

定義

新しい WebRequest を初期化します。Initializes a new WebRequest.

オーバーロード

Create(String) Create(String) Create(String) Create(String)

指定した URI スキーム用に新しい WebRequest のインスタンスを初期化します。Initializes a new WebRequest instance for the specified URI scheme.

Create(Uri) Create(Uri) Create(Uri) Create(Uri)

指定した URI スキーム用に新しい WebRequest のインスタンスを初期化します。Initializes a new WebRequest instance for the specified URI scheme.

Create(String) Create(String) Create(String) Create(String)

指定した URI スキーム用に新しい WebRequest のインスタンスを初期化します。Initializes a new WebRequest instance for the specified URI scheme.

public:
 static System::Net::WebRequest ^ Create(System::String ^ requestUriString);
public static System.Net.WebRequest Create (string requestUriString);
static member Create : string -> System.Net.WebRequest
Public Shared Function Create (requestUriString As String) As WebRequest

パラメーター

requestUriString
String String String String

インターネット リソースを識別する URI。The URI that identifies the Internet resource.

戻り値

特定の URI スキーム用の WebRequest 派生クラス。A WebRequest descendant for the specific URI scheme.

例外

requestUriString で指定された要求スキームが登録されていません。The request scheme specified in requestUriString has not been registered.

requestUriStringnullです。requestUriString is null.

呼び出し元には、要求された URI または要求のリダイレクト先である URI に接続するための WebPermissionAttribute アクセス許可がありません。The caller does not have WebPermissionAttribute permission to connect to the requested URI or a URI that the request is redirected to.

Windows ストア アプリ用 .NET またはポータブル クラス ライブラリでは、基本クラスの例外である FormatException を代わりにキャッチします。In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

requestUriString で指定された URI は、有効な URI ではありません。The URI specified in requestUriString is not a valid URI.

次の例でCreateは、をHttpWebRequest使用してインスタンスをインスタンス化します。The following example uses Create to instantiate an HttpWebRequest instance. ターゲット URL を表す文字列は、コンストラクターパラメーターとして使用されます。A string representing the target URL is used as the constructor parameter.

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は、実行時に、 WebRequestrequestUri最も近い登録済みの一致として決定されたクラスの子孫を返します。The Create method returns a descendant of the WebRequest class determined at run time as the closest registered match for requestUri.

http://たとえば、 Createまたはhttps://で始まる URI HttpWebRequestが渡さrequestUriれた場合、によってが返されます。For example, when a URI beginning with http:// or https:// is passed in requestUri, an HttpWebRequest is returned by Create. ftp://始まる URI が代わりに渡される場合Create 、メソッドはインスタンスをFtpWebRequest返します。If a URI beginning with ftp:// is passed instead, the Create method will return a FtpWebRequest instance. file://始まる URI が代わりに渡される場合Create 、メソッドはインスタンスをFileWebRequest返します。If a URI beginning with file:// is passed instead, the Create method will return a FileWebRequest instance.

登録済みの事前登録済みの予約の種類には、次のものがあります。The pre-registered reserve types already registered include the following:

  • http://

  • https://

  • ftp://

  • file://

.Net http://にはhttps:// file:// 、、、、および URI スキームのサポートが含まれています。 ftp://.NET includes support for the http://, https://, ftp://, and file:// URI schemes. WebRequestの要求を処理するためのカスタム子孫RegisterPrefixは、メソッドに登録されます。Custom WebRequest descendants to handle other requests are registered with the RegisterPrefix method.

メソッドCreateは、 requestUriStringパラメーターを使用してUri 、新しいWebRequestに渡すインスタンスを作成します。The Create method uses the requestUriString parameter to create a Uri instance that it passes to the new WebRequest.

注意

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。This member outputs trace information when you enable network tracing in your application. 詳細については、「 .NET Framework のネットワークトレース」を参照してください。For more information, see Network Tracing in the .NET Framework.

こちらもご覧ください

Create(Uri) Create(Uri) Create(Uri) Create(Uri)

指定した URI スキーム用に新しい WebRequest のインスタンスを初期化します。Initializes a new WebRequest instance for the specified URI scheme.

public:
 static System::Net::WebRequest ^ Create(Uri ^ requestUri);
public static System.Net.WebRequest Create (Uri requestUri);
static member Create : Uri -> System.Net.WebRequest
Public Shared Function Create (requestUri As Uri) As WebRequest

パラメーター

requestUri
Uri Uri Uri Uri

要求されたリソースの URI を格納する UriA Uri containing the URI of the requested resource.

戻り値

指定した URI スキーム用の WebRequest 派生クラス。A WebRequest descendant for the specified URI scheme.

例外

requestUri で指定された要求スキームが登録されていません。The request scheme specified in requestUri is not registered.

呼び出し元には、要求された URI または要求のリダイレクト先である URI に接続するための WebPermissionAttribute アクセス許可がありません。The caller does not have WebPermissionAttribute permission to connect to the requested URI or a URI that the request is redirected to.

次の例でCreateは、をHttpWebRequest使用してインスタンスをインスタンス化します。The following example uses Create to instantiate an HttpWebRequest instance. ターゲット URL を表す Uri は、コンストラクターパラメーターとして使用されます。A Uri representing the target URL is used as the constructor parameter.

// 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は、実行時に、 WebRequestrequestUri最も近い登録済みの一致として決定されたクラスの子孫を返します。The Create method returns a descendant of the WebRequest class determined at run time as the closest registered match for requestUri.

たとえば、Handler1 をWebRequest作成しhttp://www.contoso.com/text/て、への要求http://www.contoso.com/code/を処理する別の Handler2 という名前の要求を処理する場合、 Createメソッドを使用して、次のいずれかに関連付けられている WebRequest 子孫を返すことができます。指定された URI。For example, if you create a WebRequest descendant, Handler1, to handle requests to http://www.contoso.com/text/ and another named Handler2 to handle requests to http://www.contoso.com/code/, you can use Create method to return the WebRequest descendant associated with either specified URI.

URI のスキーム部分のみにWebRequest基づいてクラスの子孫を返すには、 CreateDefaultメソッドを使用します。To return a descendant of the WebRequest class based on only the scheme portion of a URI, use the CreateDefault method.

http://たとえば、 Createまたはhttps://で始まる URI HttpWebRequestが渡さrequestUriれた場合、によってが返されます。For example, when a URI beginning with http:// or https:// is passed in requestUri, an HttpWebRequest is returned by Create. ftp://始まる URI が代わりに渡される場合Create 、メソッドはインスタンスをFileWebRequest返します。If a URI beginning with ftp:// is passed instead, the Create method will return a FileWebRequest instance. file://始まる URI が代わりに渡される場合Create 、メソッドはインスタンスをFileWebRequest返します。If a URI beginning with file:// is passed instead, the Create method will return a FileWebRequest instance.

登録済みの事前登録済みの予約の種類には、次のものがあります。The pre-registered reserve types already registered include the following:

  • http://

  • https://

  • ftp://

  • file://

.Net http://にはhttps:// file:// 、、、、および URI スキームのサポートが含まれています。 ftp://.NET includes support for the http://, https://, ftp://, and file:// URI schemes. WebRequestの要求を処理するためのカスタム子孫RegisterPrefixは、メソッドに登録されます。Custom WebRequest descendants to handle other requests are registered with the RegisterPrefix method.

注意

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。This member outputs trace information when you enable network tracing in your application. 詳細については、「 .NET Framework のネットワークトレース」を参照してください。For more information, see Network Tracing in the .NET Framework.

適用対象