WebRequest.Create Metoda

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.Requests.dll

Inicializuje nový WebRequest.

Přetížení

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 prostředek internetu.

Návraty

WebRequest

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

Atributy

ObsoleteAttribute

Výjimky

NotSupportedException

Schéma žádosti zadané v requestUriString není zaregistrováno.

ArgumentNullException

requestUriString je null.

SecurityException

Volající nemá WebPermissionAttribute oprávnění k připojení 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 není platným identifikátorem URI.

Poznámka: V .NET pro aplikace pro Windows Store nebo v přenosné knihovně tříd místo toho zachyťte výjimku FormatExceptionzákladní třídy.

Příklady

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

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

Poznámky

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

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

Mezi již zaregistrované typy předem registrovaných rezerv patří:

• 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ů jsou registrováni pomocí RegisterPrefix metody.

Metoda Create používá requestUriString parametr k vytvoření Uri instance, kterou předá do nového WebRequestobjektu .

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete v tématu Trasování sítě v rozhraní .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í zaregistrováno.

ArgumentNullException

requestUri je null.

SecurityException

Volající nemá WebPermissionAttribute oprávnění k připojení 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í HttpWebRequest instance instance. Jako parametr konstruktoru se používá identifikátor URI představující cílovou adresu 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()

Poznámky

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

Pokud například vytvoříte WebRequest potomka Handler1 pro zpracování požadavků http://www.contoso.com/text/ na a další s názvem Handler2 pro zpracování požadavků na http://www.contoso.com/code/, můžete použít Create metodu pro vrácení potomka WebRequest přidruženého k některému zadanému identifikátoru URI.

Pokud chcete vrátit potomka WebRequest třídy založené pouze na části schématu identifikátoru URI, použijte metodu CreateDefault .

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

Mezi již zaregistrované typy předem registrovaných rezerv patří:

• 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ů jsou registrováni pomocí RegisterPrefix metody.

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete v tématu Trasování sítě v rozhraní .NET Framework.