WebRequest.Create Metod

Definition

Initierar en ny WebRequest.

Överlagringar

Name Description
Create(String)

Initierar en ny WebRequest instans för det angivna URI-schemat.

Create(Uri)

Initierar en ny WebRequest instans för det angivna URI-schemat.

Create(String)

Initierar en ny WebRequest instans för det angivna URI-schemat.

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

Parametrar

requestUriString
String

Den URI som identifierar Internetresursen.

Returer

En WebRequest underordnad för det specifika URI-schemat.

Undantag

Det program för begäran som anges i requestUriString har inte registrerats.

requestUriString är null.

Anroparen har WebPermissionAttribute inte behörighet att ansluta till den begärda URI:n eller en URI som begäran omdirigeras till.

Den URI som anges i requestUriString är inte en giltig URI.

Obs! I .NET för Windows Store-appar eller Portable Class Library fångar du i stället basklassfelet FormatException.

Exempel

I följande exempel används Create för att instansiera en HttpWebRequest instans. En sträng som representerar mål-URL:en används som konstruktorparameter.

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

Kommentarer

Metoden Create returnerar en underordnad WebRequest till klassen som fastställs vid körning som den närmaste registrerade matchningen för requestUri.

När till exempel en URI som börjar med http:// eller https:// skickas i requestUrireturneras en HttpWebRequest av Create. Om en URI som börjar med ftp:// skickas i stället Create returnerar metoden en FtpWebRequest instans. Om en URI som börjar med file:// skickas i stället Create returnerar metoden en FileWebRequest instans.

De förregistrerade reservtyperna som redan har registrerats innehåller följande:

  • http://

  • https://

  • ftp://

  • file://

.NET innehåller stöd för http://, https://, ftp:// och file:// URI-scheman. Anpassade WebRequest underordnade för att hantera andra begäranden registreras med RegisterPrefix metoden.

Metoden Create använder parametern requestUriString för att skapa en Uri instans som den skickar till den nya WebRequest.

Note

Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing i .NET Framework.

Se även

Gäller för

Create(Uri)

Initierar en ny WebRequest instans för det angivna URI-schemat.

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

Parametrar

requestUri
Uri

En Uri som innehåller URI:n för den begärda resursen.

Returer

En WebRequest underordnad för det angivna URI-schemat.

Undantag

Det program för begäran som anges i requestUri är inte registrerat.

requestUri är null.

Anroparen har WebPermissionAttribute inte behörighet att ansluta till den begärda URI:n eller en URI som begäran omdirigeras till.

Exempel

I följande exempel används Create för att instansiera en HttpWebRequest instans. En URI som representerar mål-URL:en används som konstruktorparameter.

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

Kommentarer

Metoden Create returnerar en underordnad WebRequest till klassen som fastställs vid körning som den närmaste registrerade matchningen för requestUri.

Om du till exempel skapar en WebRequest underordnad, Handler1, för att hantera begäranden till http://www.contoso.com/text/ och en annan med namnet Handler2 för att hantera begäranden till http://www.contoso.com/code/, kan du använda Create metoden för att returnera den WebRequest-underordnade som är associerad med någon av de angivna URI:erna.

Om du vill returnera en underordnad WebRequest till klassen baserat på endast schemadelen av en URI använder du CreateDefault -metoden.

När till exempel en URI som börjar med http:// eller https:// skickas i requestUrireturneras en HttpWebRequest av Create. Om en URI som börjar med ftp:// skickas i stället Create returnerar metoden en FileWebRequest instans. Om en URI som börjar med file:// skickas i stället Create returnerar metoden en FileWebRequest instans.

De förregistrerade reservtyperna som redan har registrerats innehåller följande:

  • http://

  • https://

  • ftp://

  • file://

.NET innehåller stöd för http://, https://, ftp:// och file:// URI-scheman. Anpassade WebRequest underordnade för att hantera andra begäranden registreras med RegisterPrefix metoden.

Note

Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing i .NET Framework.

Gäller för