次の方法で共有


WebRequest.Create メソッド

定義

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

オーバーロード

Create(String)
古い.

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

Create(Uri)
古い.

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

Create(String)

ソース:
WebRequest.cs
ソース:
WebRequest.cs
ソース:
WebRequest.cs

注意事項

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

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

public:
 static System::Net::WebRequest ^ Create(System::String ^ requestUriString);
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}")]
public static System.Net.WebRequest Create (string requestUriString);
static member Create : string -> System.Net.WebRequest
[<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。

戻り値

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

属性

例外

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

requestUriStringnullです。

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

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

注: Windows ストア アプリまたはポータブル クラス ライブラリ用の .NET では、代わりに基本クラスの例外 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 、 に最も近い登録済み一致として実行時に決定された クラスの子孫 WebRequestrequestUri返します。

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

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

  • http://

  • https://

  • ftp://

  • file://

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

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

Note

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

こちらもご覧ください

適用対象

Create(Uri)

ソース:
WebRequest.cs
ソース:
WebRequest.cs
ソース:
WebRequest.cs

注意事項

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

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

public:
 static System::Net::WebRequest ^ Create(Uri ^ requestUri);
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);
static member Create : Uri -> System.Net.WebRequest
[<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

戻り値

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

属性

例外

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

requestUrinullです。

呼び出し元には、要求された 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 、 に最も近い登録済み一致として実行時に決定された クラスの子孫 WebRequestrequestUri返します。

たとえば、 への要求を 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 には、、および file:// URI スキームのサポートftp://http://https://が含まれています。 他の要求を処理するカスタム WebRequest 子孫は、 メソッドに RegisterPrefix 登録されます。

Note

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

適用対象