WebRequest.Create Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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
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.