WebRequest.Create Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Initialisiert ein neues WebRequest.
Überlädt
| Name | Beschreibung |
|---|---|
| Create(String) |
Veraltet.
Initialisiert eine neue WebRequest Instanz für das angegebene URI-Schema. |
| Create(Uri) |
Veraltet.
Initialisiert eine neue WebRequest Instanz für das angegebene URI-Schema. |
Create(String)
- Quelle:
- WebRequest.cs
- Quelle:
- WebRequest.cs
- Quelle:
- WebRequest.cs
- Quelle:
- WebRequest.cs
- Quelle:
- WebRequest.cs
Achtung
WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.
Initialisiert eine neue WebRequest Instanz für das angegebene URI-Schema.
public:
static System::Net::WebRequest ^ Create(System::String ^ requestUriString);
public static System.Net.WebRequest Create(string requestUriString);
[System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static System.Net.WebRequest Create(string requestUriString);
static member Create : string -> System.Net.WebRequest
[<System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member Create : string -> System.Net.WebRequest
Public Shared Function Create (requestUriString As String) As WebRequest
Parameter
- requestUriString
- String
Der URI, der die Internetressource identifiziert.
Gibt zurück
Ein WebRequest untergeordnetes Element für das spezifische URI-Schema.
- Attribute
Ausnahmen
Das angegebene requestUriString Anforderungsschema wurde nicht registriert.
requestUriString ist null.
Der Aufrufer verfügt nicht WebPermissionAttribute über die Berechtigung zum Herstellen einer Verbindung mit dem angeforderten URI oder einem URI, an den die Anforderung umgeleitet wird.
Der angegebene requestUriString URI ist kein gültiger URI.
Beispiele
Im folgenden Beispiel wird Create eine HttpWebRequest Instanz instanziieren. Eine Zeichenfolge, die die Ziel-URL darstellt, wird als Konstruktorparameter verwendet.
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()
Hinweise
Die Create Methode gibt einen Nachfolger der Klasse zurück, die WebRequest zur Laufzeit als die am nächsten registrierte Übereinstimmung bestimmt requestUriwurde.
Wenn beispielsweise ein URI beginnt oder http://https:// übergeben requestUriwird, wird eine HttpWebRequest von Create. Wenn stattdessen ein URI ftp:// übergeben wird, gibt die Create Methode eine FtpWebRequest Instanz zurück. Wenn stattdessen ein URI file:// übergeben wird, gibt die Create Methode eine FileWebRequest Instanz zurück.
Die bereits registrierten Reservetypen umfassen Folgendes:
http://https://ftp://file://
.NET enthält Unterstützung für die http://Schemas , https://, , ftp://und file:// URI. Benutzerdefinierte WebRequest Nachfolger zum Behandeln anderer Anforderungen werden bei der RegisterPrefix Methode registriert.
Die Create Methode verwendet den requestUriString Parameter, um eine Uri Instanz zu erstellen, die an die neue WebRequestübergeben wird.
Note
Dieses Mitglied gibt Protokollierungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network-Ablaufverfolgung im .NET Framework.
Weitere Informationen
Gilt für:
Create(Uri)
- Quelle:
- WebRequest.cs
- Quelle:
- WebRequest.cs
- Quelle:
- WebRequest.cs
- Quelle:
- WebRequest.cs
- Quelle:
- WebRequest.cs
Achtung
WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.
Initialisiert eine neue WebRequest Instanz für das angegebene URI-Schema.
public:
static System::Net::WebRequest ^ Create(Uri ^ requestUri);
public static System.Net.WebRequest Create(Uri requestUri);
[System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static System.Net.WebRequest Create(Uri requestUri);
static member Create : Uri -> System.Net.WebRequest
[<System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member Create : Uri -> System.Net.WebRequest
Public Shared Function Create (requestUri As Uri) As WebRequest
Parameter
Gibt zurück
Ein WebRequest absteigender Wert für das angegebene URI-Schema.
- Attribute
Ausnahmen
Das angegebene requestUri Anforderungsschema ist nicht registriert.
requestUri ist null.
Der Aufrufer verfügt nicht WebPermissionAttribute über die Berechtigung zum Herstellen einer Verbindung mit dem angeforderten URI oder einem URI, an den die Anforderung umgeleitet wird.
Beispiele
Im folgenden Beispiel wird Create eine HttpWebRequest Instanz instanziieren. Ein URI, der die Ziel-URL darstellt, wird als Konstruktorparameter verwendet.
// 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()
Hinweise
Die Create Methode gibt einen Nachfolger der Klasse zurück, die WebRequest zur Laufzeit als die am nächsten registrierte Übereinstimmung bestimmt requestUriwurde.
Wenn Sie z. B. einen WebRequest absteigenden Handler1 erstellen, um Anforderungen an http://www.contoso.com/text/ und einen anderen benannten Handler2 zum Behandeln von Anforderungen http://www.contoso.com/code/zu verarbeiten, können Sie die Methode verwenden Create , um den webRequest-Nachfolger zurückzugeben, der einem der beiden angegebenen URI zugeordnet ist.
Verwenden Sie die CreateDefault Methode, um einen Nachfolger der WebRequest Klasse zurückzugeben, der nur auf dem Schemateil eines URI basiert.
Wenn beispielsweise ein URI beginnt oder http://https:// übergeben requestUriwird, wird eine HttpWebRequest von Create. Wenn stattdessen ein URI ftp:// übergeben wird, gibt die Create Methode eine FileWebRequest Instanz zurück. Wenn stattdessen ein URI file:// übergeben wird, gibt die Create Methode eine FileWebRequest Instanz zurück.
Die bereits registrierten Reservetypen umfassen Folgendes:
http://https://ftp://file://
.NET enthält Unterstützung für die http://Schemas , https://, , ftp://und file:// URI. Benutzerdefinierte WebRequest Nachfolger zum Behandeln anderer Anforderungen werden bei der RegisterPrefix Methode registriert.
Note
Dieses Mitglied gibt Protokollierungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Network-Ablaufverfolgung im .NET Framework.