WebRequest.Create Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestawy:

netstandard.dll, System.Net.Requests.dll

Inicjuje nowy WebRequestelement .

Przeciążenia

Nazwa	Opis
Create(String)	Przestarzałe. Inicjuje nowe WebRequest wystąpienie dla określonego schematu identyfikatora URI.
Create(Uri)	Przestarzałe. Inicjuje nowe WebRequest wystąpienie dla określonego schematu identyfikatora URI.

Create(String)

Źródło:

WebRequest.cs

Uwaga

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

Inicjuje nowe WebRequest wystąpienie dla określonego schematu identyfikatora 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

Parametry

requestUriString

String

Identyfikator URI identyfikujący zasób internetowy.

Zwraca

WebRequest

Element WebRequest potomny dla określonego schematu identyfikatora URI.

Atrybuty

ObsoleteAttribute

Wyjątki

NotSupportedException

Schemat żądania określony w pliku requestUriString nie został zarejestrowany.

ArgumentNullException

Parametr requestUriString ma wartość 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.

Przykłady

W poniższym przykładzie użyto Create metody do utworzenia HttpWebRequest wystąpienia wystąpienia. Ciąg reprezentujący docelowy adres URL jest używany jako parametr konstruktora.

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

Uwagi

Metoda Create zwraca element potomny WebRequest klasy określonej w czasie wykonywania jako najbliższe zarejestrowane dopasowanie elementu requestUri.

Na przykład gdy identyfikator URI rozpoczynający się od http:// lub https:// jest przekazywany w requestUrielemecie , HttpWebRequest element jest zwracany przez Createelement . Jeśli zamiast tego zostanie przekazany identyfikator URI rozpoczynający się od ftp:// , Create metoda zwróci FtpWebRequest wystąpienie. Jeśli zamiast tego zostanie przekazany identyfikator URI rozpoczynający się od file:// , Create metoda zwróci FileWebRequest wystąpienie.

Zarejestrowane wcześniej typy rezerw obejmują następujące elementy:

• http://

• https://

• ftp://

• file://

Platforma .NET obejmuje obsługę http://schematów identyfikatorów URI , https://, ftp://i file:// . Niestandardowe WebRequest elementy potomne do obsługi innych żądań są rejestrowane za pomocą RegisterPrefix metody .

Metoda Create używa parametru requestUriString , aby utworzyć Uri wystąpienie, które przekazuje do nowego WebRequestobiektu .

Note

Ten członek generuje dane śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Network Tracing w .NET Framework.

Zobacz też

• Protokoły podłączane do programowania

Create(Uri)

Źródło:

WebRequest.cs

Uwaga

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

Inicjuje nowe WebRequest wystąpienie dla określonego schematu identyfikatora 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

Parametry

requestUri

Uri

Element Uri zawierający identyfikator URI żądanego zasobu.

Zwraca

WebRequest

Element WebRequest potomny dla określonego schematu identyfikatora URI.

Atrybuty

ObsoleteAttribute

Wyjątki

NotSupportedException

Schemat żądania określony w pliku requestUri nie jest zarejestrowany.

ArgumentNullException

Parametr requestUri ma wartość 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.

Przykłady

W poniższym przykładzie użyto Create metody do utworzenia HttpWebRequest wystąpienia wystąpienia. Identyfikator URI reprezentujący docelowy adres URL jest używany jako parametr konstruktora.

// 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()

Uwagi

Metoda Create zwraca element potomny WebRequest klasy określonej w czasie wykonywania jako najbliższe zarejestrowane dopasowanie elementu requestUri.

Jeśli na przykład utworzysz element potomny WebRequest Handler1, aby obsłużyć żądania do http://www.contoso.com/text/ i innego o nazwie Handler2 do obsługi żądań do http://www.contoso.com/code/programu , możesz użyć Create metody , aby zwrócić element potomny WebRequest skojarzony z określonym identyfikatorem URI.

Aby zwrócić element potomny WebRequest klasy na podstawie tylko części schematu identyfikatora URI, użyj CreateDefault metody .

Na przykład gdy identyfikator URI rozpoczynający się od http:// lub https:// jest przekazywany w requestUrielemecie , HttpWebRequest element jest zwracany przez Createelement . Jeśli zamiast tego zostanie przekazany identyfikator URI rozpoczynający się od ftp:// , Create metoda zwróci FileWebRequest wystąpienie. Jeśli zamiast tego zostanie przekazany identyfikator URI rozpoczynający się od file:// , Create metoda zwróci FileWebRequest wystąpienie.

Zarejestrowane wcześniej typy rezerw obejmują następujące elementy:

• http://

• https://

• ftp://

• file://

Platforma .NET obejmuje obsługę http://schematów identyfikatorów URI , https://, ftp://i file:// . Niestandardowe WebRequest elementy potomne do obsługi innych żądań są rejestrowane za pomocą RegisterPrefix metody .

Note

Ten członek generuje dane śledzenia po włączeniu śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Network Tracing w .NET Framework.