WebRequest.Create Метод

Определение

Инициализирует новый объект WebRequest.Initializes a new WebRequest.

Перегрузки

Create(String)

Инициализирует новый экземпляр WebRequest для заданной схемы URI.Initializes a new WebRequest instance for the specified URI scheme.

Create(Uri)

Инициализирует новый экземпляр WebRequest для заданной схемы URI.Initializes a new WebRequest instance for the specified URI scheme.

Create(String)

Инициализирует новый экземпляр WebRequest для заданной схемы URI.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

Универсальный код ресурса (URI), определяющий интернет-ресурс.The URI that identifies the Internet resource.

Возвращаемое значение

Потомок WebRequest для определенной схемы URI.A WebRequest descendant for the specific URI scheme.

Исключения

Схема запроса, заданная в requestUriString, не зарегистрирована.The request scheme specified in requestUriString has not been registered.

requestUriString имеет значение null.requestUriString is null.

У вызывающего объекта нет разрешения WebPermissionAttribute на подключение к запрошенному универсальному коду ресурса (URI) или к универсальному коду ресурса (URI), к которому перенаправляется запрос.The caller does not have WebPermissionAttribute permission to connect to the requested URI or a URI that the request is redirected to.

Вместо этого в .NET для приложений Магазина Windows или в переносимой библиотеке классов перехватите исключение базового класса FormatException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

Код URI, заданный в requestUriString, является недопустимым.The URI specified in requestUriString is not a valid URI.

Примеры

В следующем примере для создания экземпляра HttpWebRequest используется Create.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 возвращает потомка класса WebRequest, который определяется во время выполнения как ближайшее Зарегистрированное совпадение для requestUri.The Create method returns a descendant of the WebRequest class determined at run time as the closest registered match for requestUri.

Например, если в requestUriпередается URI, начинающийся с http:// или https://, Createвозвращается HttpWebRequest.For example, when a URI beginning with http:// or https:// is passed in requestUri, an HttpWebRequest is returned by Create. Если вместо этого передается URI, начинающийся с ftp://, метод Create вернет экземпляр FtpWebRequest.If a URI beginning with ftp:// is passed instead, the Create method will return a FtpWebRequest instance. Если вместо этого передается URI, начинающийся с file://, метод 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 включает поддержку схем URI http://, https://, ftp://и file://..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)

Инициализирует новый экземпляр WebRequest для заданной схемы URI.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).A Uri containing the URI of the requested resource.

Возвращаемое значение

Потомок WebRequest для указанной схемы URI.A WebRequest descendant for the specified URI scheme.

Исключения

Схема запроса, заданная в requestUri, не зарегистрирована.The request scheme specified in requestUri is not registered.

requestUri имеет значение null.requestUri is null.

У вызывающего объекта нет разрешения WebPermissionAttribute на подключение к запрошенному универсальному коду ресурса (URI) или к универсальному коду ресурса (URI), к которому перенаправляется запрос.The caller does not have WebPermissionAttribute permission to connect to the requested URI or a URI that the request is redirected to.

Примеры

В следующем примере для создания экземпляра HttpWebRequest используется Create.The following example uses Create to instantiate an HttpWebRequest instance. В качестве параметра конструктора используется URI, представляющий целевой URL-адрес.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 возвращает потомка класса WebRequest, который определяется во время выполнения как ближайшее Зарегистрированное совпадение для requestUri.The Create method returns a descendant of the WebRequest class determined at run time as the closest registered match for requestUri.

Например, если создать WebRequest-потомок, Handler1, для обработки запросов к http://www.contoso.com/text/ и другой с именем Handler2 для обработки запросов к http://www.contoso.com/code/, можно использовать метод 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.

Чтобы получить наследник класса WebRequest, основанный только на части схемы URI, используйте метод CreateDefault.To return a descendant of the WebRequest class based on only the scheme portion of a URI, use the CreateDefault method.

Например, если в requestUriпередается URI, начинающийся с http:// или https://, Createвозвращается HttpWebRequest.For example, when a URI beginning with http:// or https:// is passed in requestUri, an HttpWebRequest is returned by Create. Если вместо этого передается URI, начинающийся с ftp://, метод Create вернет экземпляр FileWebRequest.If a URI beginning with ftp:// is passed instead, the Create method will return a FileWebRequest instance. Если вместо этого передается URI, начинающийся с file://, метод 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 включает поддержку схем URI http://, https://, ftp://и file://..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.

Применяется к