WebRequest.Create Метод

Ссылка

Определение

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

Сборка:: System.Net.Requests.dll

Сборка:: System.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Инициализирует новый объект 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

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

Например, если 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

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

Атрибуты: ObsoleteAttribute

Исключения

NotSupportedException

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

ArgumentNullException

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

SecurityException

Примеры

В следующем примере используется 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()

Например, если создать 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://

Примечание

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

Поделиться через

WebRequest.Create Метод

Определение

Перегрузки

Create(String)

Параметры

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

Исключения

Примеры

Комментарии

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

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

Create(Uri)

Параметры

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

Исключения

Примеры

Комментарии

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

Дополнительные ресурсы