WebRequest.Create Metoda

Definicja

Inicjuje nowe wystąpienie WebRequest.Initializes a new WebRequest.

Przeciążenia

Create(String)

Inicjuje nowe wystąpienie WebRequest dla określonego schematu identyfikatora URI.Initializes a new WebRequest instance for the specified URI scheme.

Create(Uri)

Inicjuje nowe wystąpienie WebRequest dla określonego schematu identyfikatora URI.Initializes a new WebRequest instance for the specified URI scheme.

Create(String)

Inicjuje nowe wystąpienie WebRequest dla określonego schematu identyfikatora URI.Initializes a new WebRequest instance for the specified URI scheme.

public:
 static System::Net::WebRequest ^ Create(System::String ^ requestUriString);
public static System.Net.WebRequest Create (string requestUriString);
static member Create : string -> System.Net.WebRequest
Public Shared Function Create (requestUriString As String) As WebRequest

Parametry

requestUriString
String

Identyfikator URI, który identyfikuje zasób internetowy.The URI that identifies the Internet resource.

Zwraca

WebRequest element podrzędny dla określonego schematu identyfikatora URI.A WebRequest descendant for the specific URI scheme.

Wyjątki

Schemat żądania określony w requestUriString nie został zarejestrowany.The request scheme specified in requestUriString has not been registered.

Parametr requestUriString ma wartość null.requestUriString is null.

Obiekt wywołujący nie ma uprawnień WebPermissionAttribute, aby nawiązać połączenie z żądanym identyfikatorem URI lub identyfikatorem URI, do którego żądanie jest przekierowywane.The caller does not have WebPermissionAttribute permission to connect to the requested URI or a URI that the request is redirected to.

W programie .NET dla aplikacji ze sklepu Windows lub przenośnej biblioteki klasPrzechwyć wyjątek klasy bazowej, FormatException, zamiast tego.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

Identyfikator URI określony w requestUriString nie jest prawidłowym identyfikatorem URI.The URI specified in requestUriString is not a valid URI.

Przykłady

Poniższy przykład używa Create, aby utworzyć wystąpienie HttpWebRequest wystąpienia.The following example uses Create to instantiate an HttpWebRequest instance. Ciąg reprezentujący docelowy adres URL jest używany jako parametr konstruktora.A string representing the target URL is used as the constructor parameter.

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

Uwagi

Metoda Create zwraca element podrzędny klasy WebRequest ustalony w czasie wykonywania jako najbliższe zarejestrowane dopasowanie dla requestUri.The Create method returns a descendant of the WebRequest class determined at run time as the closest registered match for requestUri.

Na przykład jeśli identyfikator URI rozpoczynający się od http:// lub https:// jest przekazana w requestUri, HttpWebRequest jest zwracany przez Create.For example, when a URI beginning with http:// or https:// is passed in requestUri, an HttpWebRequest is returned by Create. W przypadku przekazanie identyfikatora URI rozpoczynającego się od ftp:// Metoda Create zwróci wystąpienie FtpWebRequest.If a URI beginning with ftp:// is passed instead, the Create method will return a FtpWebRequest instance. W przypadku przekazanie identyfikatora URI rozpoczynającego się od file:// Metoda Create zwróci wystąpienie FileWebRequest.If a URI beginning with file:// is passed instead, the Create method will return a FileWebRequest instance.

Zarejestrowane wstępnie zarejestrowane typy rezerwacji obejmują następujące elementy:The pre-registered reserve types already registered include the following:

  • http://

  • https://

  • ftp://

  • file://

Platforma .NET obejmuje obsługę schematów identyfikatorów URI http://, https://, ftp://i file://..NET includes support for the http://, https://, ftp://, and file:// URI schemes. Niestandardowe elementy podrzędne WebRequest do obsługi innych żądań są rejestrowane przy użyciu metody RegisterPrefix.Custom WebRequest descendants to handle other requests are registered with the RegisterPrefix method.

Metoda Create używa parametru requestUriString w celu utworzenia wystąpienia Uri, które przechodzi do nowej WebRequest.The Create method uses the requestUriString parameter to create a Uri instance that it passes to the new WebRequest.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji.This member outputs trace information when you enable network tracing in your application. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.For more information, see Network Tracing in the .NET Framework.

Zobacz też

Create(Uri)

Inicjuje nowe wystąpienie WebRequest dla określonego schematu identyfikatora URI.Initializes a new WebRequest instance for the specified URI scheme.

public:
 static System::Net::WebRequest ^ Create(Uri ^ requestUri);
public static System.Net.WebRequest Create (Uri requestUri);
static member Create : Uri -> System.Net.WebRequest
Public Shared Function Create (requestUri As Uri) As WebRequest

Parametry

requestUri
Uri

Uri zawierający identyfikator URI żądanego zasobu.A Uri containing the URI of the requested resource.

Zwraca

WebRequest element podrzędny dla określonego schematu identyfikatora URI.A WebRequest descendant for the specified URI scheme.

Wyjątki

Schemat żądania określony w requestUri nie jest zarejestrowany.The request scheme specified in requestUri is not registered.

Parametr requestUri ma wartość null.requestUri is null.

Obiekt wywołujący nie ma uprawnień WebPermissionAttribute, aby nawiązać połączenie z żądanym identyfikatorem URI lub identyfikatorem URI, do którego żądanie jest przekierowywane.The caller does not have WebPermissionAttribute permission to connect to the requested URI or a URI that the request is redirected to.

Przykłady

Poniższy przykład używa Create, aby utworzyć wystąpienie HttpWebRequest wystąpienia.The following example uses Create to instantiate an HttpWebRequest instance. Identyfikator URI reprezentujący docelowy adres URL jest używany jako parametr konstruktora.A Uri representing the target URL is used as the constructor parameter.

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

Uwagi

Metoda Create zwraca element podrzędny klasy WebRequest ustalony w czasie wykonywania jako najbliższe zarejestrowane dopasowanie dla requestUri.The Create method returns a descendant of the WebRequest class determined at run time as the closest registered match for requestUri.

Na przykład jeśli utworzysz WebRequest element podrzędny handler1, aby obsługiwać żądania http://www.contoso.com/text/ i inne nazwane Handler2 do obsługi żądań do http://www.contoso.com/code/, można użyć metody Create do zwrócenia elementu podrzędnego żądania WebRequest skojarzonego z określonym identyfikatorem URI.For example, if you create a WebRequest descendant, Handler1, to handle requests to http://www.contoso.com/text/ and another named Handler2 to handle requests to http://www.contoso.com/code/, you can use Create method to return the WebRequest descendant associated with either specified URI.

Aby zwrócić element podrzędny klasy WebRequest w oparciu o tylko część schematu identyfikatora URI, użyj metody CreateDefault.To return a descendant of the WebRequest class based on only the scheme portion of a URI, use the CreateDefault method.

Na przykład jeśli identyfikator URI rozpoczynający się od http:// lub https:// jest przekazana w requestUri, HttpWebRequest jest zwracany przez Create.For example, when a URI beginning with http:// or https:// is passed in requestUri, an HttpWebRequest is returned by Create. W przypadku przekazanie identyfikatora URI rozpoczynającego się od ftp:// Metoda Create zwróci wystąpienie FileWebRequest.If a URI beginning with ftp:// is passed instead, the Create method will return a FileWebRequest instance. W przypadku przekazanie identyfikatora URI rozpoczynającego się od file:// Metoda Create zwróci wystąpienie FileWebRequest.If a URI beginning with file:// is passed instead, the Create method will return a FileWebRequest instance.

Zarejestrowane wstępnie zarejestrowane typy rezerwacji obejmują następujące elementy:The pre-registered reserve types already registered include the following:

  • http://

  • https://

  • ftp://

  • file://

Platforma .NET obejmuje obsługę schematów identyfikatorów URI http://, https://, ftp://i file://..NET includes support for the http://, https://, ftp://, and file:// URI schemes. Niestandardowe elementy podrzędne WebRequest do obsługi innych żądań są rejestrowane przy użyciu metody RegisterPrefix.Custom WebRequest descendants to handle other requests are registered with the RegisterPrefix method.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji.This member outputs trace information when you enable network tracing in your application. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.For more information, see Network Tracing in the .NET Framework.

Dotyczy