WebRequest.CreateHttp WebRequest.CreateHttp WebRequest.CreateHttp WebRequest.CreateHttp Method

定義

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

オーバーロード

CreateHttp(String) CreateHttp(String) CreateHttp(String) CreateHttp(String)

指定した URI 文字列用に新しい HttpWebRequest インスタンスを初期化します。Initializes a new HttpWebRequest instance for the specified URI string.

CreateHttp(Uri) CreateHttp(Uri) CreateHttp(Uri) CreateHttp(Uri)

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

CreateHttp(String) CreateHttp(String) CreateHttp(String) CreateHttp(String)

指定した URI 文字列用に新しい HttpWebRequest インスタンスを初期化します。Initializes a new HttpWebRequest instance for the specified URI string.

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

パラメーター

requestUriString
String String String String

インターネット リソースを識別する URI 文字列。A URI string that identifies the Internet resource.

戻り値

指定した URI 文字列の HttpWebRequest インスタンス。An HttpWebRequest instance for the specific URI string.

例外

requestUriString で指定された要求スキームが、http スキームまたは https スキームです。The request scheme specified in requestUriString is the http or https scheme.

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.

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

注釈

メソッドCreateHttp(String)HttpWebRequestrequestUriStringのクラスのインスタンスを返します。The CreateHttp(String) method returns an instance of the HttpWebRequest class for the requestUriString.

http://またはrequestUriString HttpWebRequest CreateHttp(String)で始まる URI がパラメーターで渡されると、によってが返されます。 https://When a URI that begins with http:// or https:// is passed in the requestUriString parameter, a HttpWebRequest is returned by CreateHttp(String). 他のスキームでは、 NotSupportedExceptionがスローされます。Any other scheme will throw a NotSupportedException.

メソッドCreateHttp(String)は、 requestUriStringパラメーターを使用してUri 、新しいHttpWebRequestに渡すインスタンスを作成します。The CreateHttp(String) method uses the requestUriString parameter to create a Uri instance that it passes to the new HttpWebRequest. メソッドが成功した場合、 AllowReadStreamBuffering返さHttpWebRequestれたインスタンスのプロパティはにfalse設定されます。If the method is successful, the AllowReadStreamBuffering property on the returned HttpWebRequest instance is set to false.

.Net には、 http://およびhttps:// URI スキームのサポートが含まれています。.NET includes support for the http:// and https:// URI schemes. WebRequestの要求を処理するためのカスタム子孫RegisterPrefixは、メソッドに登録されます。Custom WebRequest descendants to handle other requests are registered with the RegisterPrefix method. メソッドを使用すると、他のスキームのWebRequestクラスの子孫を作成できます。 Create(String)The Create(String) method can be used to create a descendant of the WebRequest class for other schemes.

CreateHttp(Uri) CreateHttp(Uri) CreateHttp(Uri) CreateHttp(Uri)

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

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

パラメーター

requestUri
Uri Uri Uri Uri

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

戻り値

指定した URI 文字列の HttpWebRequest インスタンス。An HttpWebRequest instance for the specific URI string.

例外

requestUri で指定された要求スキームが、http スキームまたは https スキームです。The request scheme specified in requestUri is the http or https scheme.

呼び出し元には、要求された 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.

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

注釈

メソッドCreateHttp(Uri)HttpWebRequestrequestUriのクラスのインスタンスを返します。The CreateHttp(Uri) method returns an instance of the HttpWebRequest class for the requestUri.

http://またはrequestUri HttpWebRequest CreateHttp(Uri)で始まる URI がパラメーターで渡されると、によってが返されます。 http://When a URI that begins with http:// or http:// is passed in the requestUri parameter, an HttpWebRequest is returned by CreateHttp(Uri). もう1つのスキームでNotSupportedExceptionは、がスローされます。Another other scheme will throw a NotSupportedException.

メソッドCreateHttp(Uri)は、パラメーター requestUriを使用して新しいHttpWebRequestインスタンスを作成します。The CreateHttp(Uri) method uses the requestUri parameter to create a new HttpWebRequest instance. メソッドが成功した場合、 AllowReadStreamBuffering返さHttpWebRequestれたインスタンスのプロパティはにfalse設定されます。If the method is successful, the AllowReadStreamBuffering property on the returned HttpWebRequest instance is set to false.

.Net には、 http://およびhttps:// URI スキームのサポートが含まれています。.NET includes support for the http:// and https:// URI schemes. WebRequestの要求を処理するためのカスタム子孫RegisterPrefixは、メソッドに登録されます。Custom WebRequest descendants to handle other requests are registered with the RegisterPrefix method. メソッドを使用すると、他のスキームのWebRequestクラスの子孫を作成できます。 Create(Uri)The Create(Uri) method can be used to create a descendant of the WebRequest class for other schemes.

適用対象