WebRequest.Create メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
新しい 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
で指定された要求スキームが登録されていません。
requestUriString
が null
です。
呼び出し元には、要求された 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 、 に最も近い登録済み一致として実行時に決定された クラスの子孫 WebRequest を requestUri
返します。
たとえば、 または で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
パラメーター
戻り値
指定した URI スキーム用の WebRequest 派生クラス。
- 属性
例外
requestUri
で指定された要求スキームが登録されていません。
requestUri
が null
です。
呼び出し元には、要求された 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 には、、および file://
URI スキームのサポートftp://
http://
https://
が含まれています。 他の要求を処理するカスタム WebRequest 子孫は、 メソッドに RegisterPrefix 登録されます。
Note
このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「 .NET Framework でのネットワーク トレース」を参照してください。
適用対象
.NET