WebRequest.Create Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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
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.