WebRequest.Create Метод

Определение

Пространство имен:

System.Net

Сборки:

netstandard.dll, System.Net.Requests.dll

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

Перегрузки

Имя	Описание
Create(String)	Устаревшие.. Инициализирует новый WebRequest экземпляр для указанной схемы URI.
Create(Uri)	Устаревшие.. Инициализирует новый WebRequest экземпляр для указанной схемы URI.

Create(String)

Исходный код:

WebRequest.cs

Внимание

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

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

public:
 static System::Net::WebRequest ^ Create(System::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);

[<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

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

Атрибуты

ObsoleteAttribute

Исключения

NotSupportedException

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

ArgumentNullException

requestUriString равно null.

SecurityException

Вызывающий объект не имеет WebPermissionAttribute разрешения на подключение к запрошенным URI или URI, на который перенаправляется запрос.

UriFormatException

Указанный в requestUriString URI не является допустимым универсальным кодом ресурса (URI).

Примеры

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

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. Если вместо этого Create передается универсальный код ресурса (URIftp://), метод вернет FtpWebRequest экземпляр. Если вместо этого Create передается универсальный код ресурса (URIfile://), метод вернет FileWebRequest экземпляр.

Типы предварительно зарегистрированных резервов уже зарегистрированы:

• http://

• https://

• ftp://

• file://

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

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

Note

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Network Трассировка в .NET Framework.

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

• Программируемые подключаемые протоколы

Create(Uri)

Исходный код:

WebRequest.cs

Внимание

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

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

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

[<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

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

Атрибуты

ObsoleteAttribute

Исключения

NotSupportedException

Указанная в requestUri запросе схема не зарегистрирована.

ArgumentNullException

requestUri равно null.

SecurityException

Вызывающий объект не имеет WebPermissionAttribute разрешения на подключение к запрошенным URI или URI, на который перенаправляется запрос.

Примеры

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

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

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

Например, если URI начинается с http:// или https:// передается в requestUri, HttpWebRequest возвращается Create. Если вместо этого Create передается универсальный код ресурса (URIftp://), метод вернет FileWebRequest экземпляр. Если вместо этого Create передается универсальный код ресурса (URIfile://), метод вернет FileWebRequest экземпляр.

Типы предварительно зарегистрированных резервов уже зарегистрированы:

• http://

• https://

• ftp://

• file://

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

Note

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Network Трассировка в .NET Framework.