WebRequest.Create Метод

Определение

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

Перегрузки

Create(String)
Устаревшие..

Инициализирует новый экземпляр WebRequest для заданной схемы URI.

Create(Uri)
Устаревшие..

Инициализирует новый экземпляр WebRequest для заданной схемы URI.

Create(String)

Исходный код:
WebRequest.cs
Исходный код:
WebRequest.cs
Исходный код:
WebRequest.cs

Внимание!

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

Инициализирует новый экземпляр WebRequest для заданной схемы URI.

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), определяющий интернет-ресурс.

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

Потомок WebRequest для определенной схемы URI.

Атрибуты

Исключения

Схема запроса, заданная в requestUriString, не зарегистрирована.

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

У вызывающего объекта нет разрешения WebPermissionAttribute на подключение к запрошенному универсальному коду ресурса (URI) или к универсальному коду ресурса (URI), к которому перенаправляется запрос.

Код URI, заданный в requestUriString, является недопустимым.

Примечание. Вместо этого в .NET для приложений Магазина Windows или переносимой библиотеке классов перехватите исключение 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.

Например, если URI, начинающийся с http:// или https:// , передается в requestUri, HttpWebRequest возвращается .Create Если вместо этого передается URI, начинающийся с ftp:// , Create метод вернет FtpWebRequest экземпляр . Если вместо этого передается URI, начинающийся с file:// , Create метод вернет FileWebRequest экземпляр .

К уже зарегистрированным типам предварительно зарегистрированных резервов относятся следующие.

  • http://

  • https://

  • ftp://

  • file://

.NET включает поддержку http://схем , https://, ftp://и file:// URI. Пользовательские WebRequest потомки для обработки других запросов регистрируются с помощью RegisterPrefix метода .

Метод Create использует параметр для requestUriString создания экземпляра Uri , который передается в новый WebRequest.

Примечание

Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в разделе Трассировка сети в платформа .NET Framework.

См. также раздел

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

Create(Uri)

Исходный код:
WebRequest.cs
Исходный код:
WebRequest.cs
Исходный код:
WebRequest.cs

Внимание!

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

Инициализирует новый экземпляр WebRequest для заданной схемы URI.

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).

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

Потомок WebRequest для указанной схемы URI.

Атрибуты

Исключения

Схема запроса, заданная в requestUri, не зарегистрирована.

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

У вызывающего объекта нет разрешения WebPermissionAttribute на подключение к запрошенному универсальному коду ресурса (URI) или к универсальному коду ресурса (URI), к которому перенаправляется запрос.

Примеры

В следующем примере используется Create для создания экземпляра HttpWebRequest . В качестве параметра конструктора используется универсальный код ресурса (URI), представляющий целевой URL-адрес.

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

Чтобы вернуть потомок класса на WebRequest основе только части схемы URI, используйте CreateDefault метод .

Например, если URI, начинающийся с http:// или https:// , передается в requestUri, HttpWebRequest возвращается .Create Если вместо этого передается URI, начинающийся с ftp:// , Create метод вернет FileWebRequest экземпляр . Если вместо этого передается URI, начинающийся с file:// , Create метод вернет FileWebRequest экземпляр .

К уже зарегистрированным типам предварительно зарегистрированных резервов относятся следующие.

  • http://

  • https://

  • ftp://

  • file://

.NET включает поддержку http://схем , https://, ftp://и file:// URI. Пользовательские WebRequest потомки для обработки других запросов регистрируются с помощью RegisterPrefix метода .

Примечание

Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в разделе Трассировка сети в платформа .NET Framework.

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