WebRequest.CreateHttp Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.Requests.dll

Inicjuje nowe HttpWebRequest wystąpienie dla określonego identyfikatora URI.

Przeciążenia

CreateHttp(String)	Przestarzałe. Inicjuje nowe HttpWebRequest wystąpienie dla określonego ciągu identyfikatora URI.
CreateHttp(Uri)	Przestarzałe. Inicjuje nowe HttpWebRequest wystąpienie dla określonego identyfikatora URI.

CreateHttp(String)

Źródło:

WebRequest.cs

Przestroga

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

Inicjuje nowe HttpWebRequest wystąpienie dla określonego ciągu identyfikatora URI.

public:
 static System::Net::HttpWebRequest ^ CreateHttp(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.HttpWebRequest CreateHttp (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 CreateHttp : string -> System.Net.HttpWebRequest

Public Shared Function CreateHttp (requestUriString As String) As HttpWebRequest

Parametry

requestUriString

String

Ciąg identyfikatora URI identyfikujący zasób internetowy.

Zwraca

HttpWebRequest

Wystąpienie HttpWebRequest określonego ciągu identyfikatora URI.

Atrybuty

ObsoleteAttribute

Wyjątki

NotSupportedException

Schemat żądania określony w requestUriString pliku to schemat http lub https.

ArgumentNullException

requestUriString to null.

SecurityException

Obiekt wywołujący nie ma WebPermissionAttribute uprawnień do nawiązywania połączenia z żądanym identyfikatorem URI lub identyfikatorem URI, do którego jest przekierowywane żądanie.

UriFormatException

Identyfikator URI określony w pliku requestUriString nie jest prawidłowym identyfikatorem URI.

Uwagi

Metoda CreateHttp(String) zwraca wystąpienie HttpWebRequest klasy dla klasy requestUriString.

Gdy identyfikator URI rozpoczynający się od http:// lub https:// jest przekazywany w parametrze requestUriString , element HttpWebRequest jest zwracany przez polecenie CreateHttp(String). Każdy inny schemat zgłosi błąd NotSupportedException.

Metoda CreateHttp(String) używa parametru , requestUriString aby utworzyć Uri wystąpienie, które przekazuje do nowego HttpWebRequestobiektu . Jeśli metoda zakończy się pomyślnie, AllowReadStreamBuffering właściwość zwróconego HttpWebRequest wystąpienia jest ustawiona na falsewartość .

Platforma .NET obejmuje obsługę schematów identyfikatorów http:// URI i https:// . Niestandardowe WebRequest elementy podrzędne do obsługi innych żądań są rejestrowane za pomocą RegisterPrefix metody . Za Create(String) pomocą metody można utworzyć element podrzędny WebRequest klasy dla innych schematów.

CreateHttp(Uri)

Źródło:

WebRequest.cs

Przestroga

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

Inicjuje nowe HttpWebRequest wystąpienie dla określonego identyfikatora URI.

public:
 static System::Net::HttpWebRequest ^ CreateHttp(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.HttpWebRequest CreateHttp (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 CreateHttp : Uri -> System.Net.HttpWebRequest

Public Shared Function CreateHttp (requestUri As Uri) As HttpWebRequest

Parametry

requestUri

Uri

Identyfikator URI identyfikujący zasób internetowy.

Zwraca

HttpWebRequest

Wystąpienie HttpWebRequest określonego ciągu identyfikatora URI.

Atrybuty

ObsoleteAttribute

Wyjątki

NotSupportedException

Schemat żądania określony w requestUri pliku to schemat http lub https.

ArgumentNullException

requestUri to null.

SecurityException

Obiekt wywołujący nie ma WebPermissionAttribute uprawnień do nawiązywania połączenia z żądanym identyfikatorem URI lub identyfikatorem URI, do którego jest przekierowywane żądanie.

UriFormatException

Identyfikator URI określony w pliku requestUri nie jest prawidłowym identyfikatorem URI.

Uwagi

Metoda CreateHttp(Uri) zwraca wystąpienie HttpWebRequest klasy dla klasy requestUri.

Gdy identyfikator URI rozpoczynający się od http:// lub http:// jest przekazywany w parametrze requestUri , jest HttpWebRequest zwracany przez parametr CreateHttp(Uri). Inny inny schemat zgłosi błąd NotSupportedException.

Metoda CreateHttp(Uri) używa parametru do requestUri utworzenia nowego HttpWebRequest wystąpienia. Jeśli metoda zakończy się pomyślnie, AllowReadStreamBuffering właściwość zwróconego HttpWebRequest wystąpienia jest ustawiona na falsewartość .

Platforma .NET obejmuje obsługę schematów identyfikatorów http:// URI i https:// . Niestandardowe WebRequest elementy podrzędne do obsługi innych żądań są rejestrowane za pomocą RegisterPrefix metody . Za Create(Uri) pomocą metody można utworzyć element podrzędny WebRequest klasy dla innych schematów.