WebRequest.Create Methode

Definitie

Initialiseert een nieuwe WebRequest.

Overloads

Name Description
Create(String)

Initialiseert een nieuw WebRequest exemplaar voor het opgegeven URI-schema.

Create(Uri)

Initialiseert een nieuw WebRequest exemplaar voor het opgegeven URI-schema.

Create(String)

Initialiseert een nieuw WebRequest exemplaar voor het opgegeven URI-schema.

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

Parameters

requestUriString
String

De URI die de internetresource identificeert.

Retouren

Een WebRequest afstammeling voor het specifieke URI-schema.

Uitzonderingen

Het opgegeven requestUriString aanvraagschema is niet geregistreerd.

requestUriString is null.

De beller is niet WebPermissionAttribute gemachtigd om verbinding te maken met de aangevraagde URI of een URI waarnaar de aanvraag wordt omgeleid.

De OPGEGEVEN requestUriString URI is geen geldige URI.

Opmerking: In .NET voor Windows Store-apps of de Portable Class Library, haalt u in plaats daarvan de uitzondering van de basisklasse op, FormatException.

Voorbeelden

In het volgende voorbeeld wordt een Create instantie geïnstitueren HttpWebRequest . Een tekenreeks die de doel-URL vertegenwoordigt, wordt gebruikt als de constructorparameter.

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

Opmerkingen

De Create methode retourneert een afstammeling van de WebRequest klasse die tijdens runtime is bepaald als de dichtstbijzijnde geregistreerde overeenkomst voor requestUri.

Wanneer bijvoorbeeld een URI begint met http:// of https:// wordt doorgegeven requestUri, wordt er een HttpWebRequest geretourneerd door Create. Als in plaats daarvan ftp:// een URI wordt doorgegeven, retourneert de Create methode een FtpWebRequest exemplaar. Als in plaats daarvan file:// een URI wordt doorgegeven, retourneert de Create methode een FileWebRequest exemplaar.

De vooraf geregistreerde reservetypen die al zijn geregistreerd, zijn onder andere:

  • http://

  • https://

  • ftp://

  • file://

.NET bevat ondersteuning voor de http://, https://, ftp:// en file:// URI-schema's. Aangepaste WebRequest afstammelingen voor het verwerken van andere aanvragen worden geregistreerd bij de RegisterPrefix methode.

De Create methode gebruikt de requestUriString parameter om een Uri exemplaar te maken dat wordt doorgegeven aan de nieuwe WebRequest.

Note

Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in the .NET Framework voor meer informatie.

Zie ook

Van toepassing op

Create(Uri)

Initialiseert een nieuw WebRequest exemplaar voor het opgegeven URI-schema.

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

Parameters

requestUri
Uri

Een Uri met de URI van de aangevraagde resource.

Retouren

Een WebRequest afstammeling voor het opgegeven URI-schema.

Uitzonderingen

Het opgegeven requestUri aanvraagschema is niet geregistreerd.

requestUri is null.

De beller is niet WebPermissionAttribute gemachtigd om verbinding te maken met de aangevraagde URI of een URI waarnaar de aanvraag wordt omgeleid.

Voorbeelden

In het volgende voorbeeld wordt een Create instantie geïnstitueren HttpWebRequest . Een URI die de doel-URL vertegenwoordigt, wordt gebruikt als de constructorparameter.

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

Opmerkingen

De Create methode retourneert een afstammeling van de WebRequest klasse die tijdens runtime is bepaald als de dichtstbijzijnde geregistreerde overeenkomst voor requestUri.

Als u bijvoorbeeld een WebRequest afstammeling, Handler1, maakt voor het verwerken van aanvragen naar http://www.contoso.com/text/ en een andere benoemde handler2 voor het verwerken van aanvragen http://www.contoso.com/code/, kunt u de methode gebruiken Create om de webrequest-afstammeling te retourneren die is gekoppeld aan een van de opgegeven URI's.

Als u een afstammeling van de WebRequest klasse wilt retourneren op basis van alleen het schemagedeelte van een URI, gebruikt u de CreateDefault methode.

Wanneer bijvoorbeeld een URI begint met http:// of https:// wordt doorgegeven requestUri, wordt er een HttpWebRequest geretourneerd door Create. Als in plaats daarvan ftp:// een URI wordt doorgegeven, retourneert de Create methode een FileWebRequest exemplaar. Als in plaats daarvan file:// een URI wordt doorgegeven, retourneert de Create methode een FileWebRequest exemplaar.

De vooraf geregistreerde reservetypen die al zijn geregistreerd, zijn onder andere:

  • http://

  • https://

  • ftp://

  • file://

.NET bevat ondersteuning voor de http://, https://, ftp:// en file:// URI-schema's. Aangepaste WebRequest afstammelingen voor het verwerken van andere aanvragen worden geregistreerd bij de RegisterPrefix methode.

Note

Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in the .NET Framework voor meer informatie.

Van toepassing op