WebRequest.Create Metoda

Definice

Obor názvů:

System.Net

Sestavení:

netstandard.dll, System.Net.Requests.dll

Inicializuje nový WebRequest.

Přetížení

Name	Description
Create(String)	Zastaralé. Inicializuje novou WebRequest instanci pro zadané schéma identifikátoru URI.
Create(Uri)	Zastaralé. Inicializuje novou WebRequest instanci pro zadané schéma identifikátoru URI.

Create(String)

Zdroj:

WebRequest.cs

Upozornění

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

Inicializuje novou WebRequest instanci pro zadané schéma identifikátoru 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

Identifikátor URI, který identifikuje internetový prostředek.

Návraty

WebRequest

Potomek WebRequest pro konkrétní schéma identifikátoru URI.

Atributy

ObsoleteAttribute

Výjimky

NotSupportedException

Schéma požadavku zadané v requestUriString seznamu nebylo zaregistrováno.

ArgumentNullException

requestUriString je null.

SecurityException

Volající nemá WebPermissionAttribute oprávnění připojit se k požadovanému identifikátoru URI nebo identifikátoru URI, na který je požadavek přesměrován.

UriFormatException

Identifikátor URI zadaný v requestUriString tomto identifikátoru není platným identifikátorem URI.

Příklady

Následující příklad používá Create k vytvoření instance HttpWebRequest instance. Řetězec představující cílovou adresu URL se používá jako parametr konstruktoru.

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

Poznámky

Metoda Create vrátí potomka WebRequest třídy určené za běhu jako nejbližší registrovaná shoda pro requestUri.

Pokud například identifikátor URI začíná http:// nebo https:// je předán requestUri, HttpWebRequest vrátí Createfunkce . Pokud je místo toho předán identifikátor URI ftp:// začínající na, Create metoda vrátí FtpWebRequest instanci. Pokud je místo toho předán identifikátor URI file:// začínající na, Create metoda vrátí FileWebRequest instanci.

Předem zaregistrované typy rezerv zahrnují následující:

• http://

• https://

• ftp://

• file://

.NET zahrnuje podporu schémat http://, , https://ftp://a file:// URI. Vlastní WebRequest potomci pro zpracování jiných požadavků se zaregistrují v RegisterPrefix metodě.

Metoda Create pomocí parametru requestUriString vytvoří instanci, kterou předá nové UriWebRequest .

Note

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace najdete v tématu Network Tracing v .NET Framework.

Viz také

• Programování připojitelných protokolů

Create(Uri)

Zdroj:

WebRequest.cs

Upozornění

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

Inicializuje novou WebRequest instanci pro zadané schéma identifikátoru 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

A Uri obsahující identifikátor URI požadovaného prostředku.

Návraty

WebRequest

Potomek WebRequest pro zadané schéma identifikátoru URI.

Atributy

ObsoleteAttribute

Výjimky

NotSupportedException

Schéma požadavku zadané v requestUri není registrováno.

ArgumentNullException

requestUri je null.

SecurityException

Volající nemá WebPermissionAttribute oprávnění připojit se k požadovanému identifikátoru URI nebo identifikátoru URI, na který je požadavek přesměrován.

Příklady

Následující příklad používá Create k vytvoření instance HttpWebRequest instance. Identifikátor URI představující cílovou adresu URL se používá jako parametr konstruktoru.

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

Poznámky

Metoda Create vrátí potomka WebRequest třídy určené za běhu jako nejbližší registrovaná shoda pro requestUri.

Pokud například vytvoříte potomka, obslužnou rutinu1 WebRequest , pro zpracování požadavků do http://www.contoso.com/text/ a jiného pojmenovaného Handler2 pro zpracování požadavků http://www.contoso.com/code/, můžete použít Create metodu k vrácení potomku WebRequest přidruženého k některému zadanému identifikátoru URI.

Chcete-li vrátit potomka WebRequest třídy na základě pouze části schématu identifikátoru URI, použijte metodu CreateDefault .

Pokud například identifikátor URI začíná http:// nebo https:// je předán requestUri, HttpWebRequest vrátí Createfunkce . Pokud je místo toho předán identifikátor URI ftp:// začínající na, Create metoda vrátí FileWebRequest instanci. Pokud je místo toho předán identifikátor URI file:// začínající na, Create metoda vrátí FileWebRequest instanci.

Předem zaregistrované typy rezerv zahrnují následující:

• http://

• https://

• ftp://

• file://

.NET zahrnuje podporu schémat http://, , https://ftp://a file:// URI. Vlastní WebRequest potomci pro zpracování jiných požadavků se zaregistrují v RegisterPrefix metodě.

Note

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace najdete v tématu Network Tracing v .NET Framework.