WebRequest.Create Метод

  • Ссылка

Определение

Пространство имен:
System.Net
Сборка:
System.Net.Requests.dll
Сборка:
System.dll
Сборка:
netstandard.dll

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

Перегрузки

Create(String)
Является устаревшей.

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

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

Create(String)

Внимание!

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

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

Атрибуты
ObsoleteAttribute

Исключения

NotSupportedException

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

ArgumentNullException

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

SecurityException

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

UriFormatException

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

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

  • http://

  • https://

  • ftp://

  • file://

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

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

Примечание

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

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

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

Create(Uri)

Внимание!

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

Потомок 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 = 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

Например, при создании потомка Handler1 для обработки запросов http://www.contoso.com/text/ и другого именованного WebRequest Handler2 для обработки запросов http://www.contoso.com/code/можно использовать Create метод для возврата потомка WebRequest, связанного с указанным URI.

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

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

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

  • http://

  • https://

  • ftp://

  • file://

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

Примечание

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

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