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 eine neue WebRequest.
Überlädt
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
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 bezeichnet.
Gibt zurück
Ein WebRequest-Nachfolger für ein bestimmtes URI-Schema.
- Attribute
Ausnahmen
Das in requestUriString
angegebene Anforderungsschema wurde nicht registriert.
requestUriString
ist null
.
Der Aufrufer besitzt keine WebPermissionAttribute-Berechtigung zum Herstellen einer Verbindung mit dem angeforderten URI oder einem URI, an den die Anforderung umgeleitet wurde.
Der in requestUriString
angegebene URI ist kein gültiger URI.
Hinweis: In .NET für Windows Store-Apps oder der portablen Klassenbibliothek sollten Sie stattdessen die Basisklassen-Ausnahme FormatExceptionabfangen.
Beispiele
Im folgenden Beispiel wird verwendetCreate, um eine HttpWebRequest instance zu instanziieren. Als Konstruktorparameter wird eine Zeichenfolge verwendet, die die Ziel-URL darstellt.
Uri^ ourUri = gcnew 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();
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 nächstgelegene registrierte Übereinstimmung für requestUri
festgelegt wurde.
Wenn beispielsweise ein URI, der mit http://
oder https://
beginnt, in requestUri
übergeben wird, wird von HttpWebRequestCreatezurückgegeben. Wenn stattdessen ein URI, der mit ftp://
beginnt, übergeben wird, gibt die Create Methode einen FtpWebRequest instance zurück. Wenn stattdessen ein URI, der mit file://
beginnt, übergeben wird, gibt die Create Methode einen FileWebRequest instance zurück.
Die bereits registrierten vorab registrierten Reservetypen umfassen Folgendes:
http://
https://
ftp://
file://
.NET bietet Unterstützung für die http://
URI-Schemas , https://
, ftp://
und file://
. Benutzerdefinierte WebRequest Nachfolger zum Verarbeiten anderer Anforderungen werden bei der RegisterPrefix -Methode registriert.
Die Create -Methode verwendet den requestUriString
-Parameter, um eine Uri instance zu erstellen, die sie an die neue WebRequestübergibt.
Hinweis
Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung im .NET Framework.
Weitere Informationen
Gilt für:
Create(Uri)
- 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-Nachfolger für das angegebene URI-Schema.
- Attribute
Ausnahmen
Das in requestUri
angegebene Anforderungsschema wurde nicht registriert.
requestUri
ist null
.
Der Aufrufer besitzt keine WebPermissionAttribute-Berechtigung zum Herstellen einer Verbindung mit dem angeforderten URI oder einem URI, an den die Anforderung umgeleitet wurde.
Beispiele
Im folgenden Beispiel wird verwendetCreate, um eine HttpWebRequest instance zu instanziieren. Ein URI, der die Ziel-URL darstellt, wird als Konstruktorparameter verwendet.
// Create a new 'Uri' object with the specified string.
Uri^ myUri = gcnew 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.
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 nächstgelegene registrierte Übereinstimmung für requestUri
festgelegt wurde.
Wenn Sie beispielsweise einen WebRequest Nachfolger Handler1 erstellen, um Anforderungen an http://www.contoso.com/text/
und einen anderen namens Handler2 zum Verarbeiten von Anforderungen an http://www.contoso.com/code/
zu behandeln, können Sie die -Methode verwenden Create , um den WebRequest-Nachfolger zurückzugeben, der einem angegebenen URI zugeordnet ist.
Verwenden Sie CreateDefault die -Methode, um einen Nachfolger der WebRequest -Klasse zurückzugeben, der nur auf dem Schemateil eines URI basiert.
Wenn beispielsweise ein URI, der mit http://
oder https://
beginnt, in requestUri
übergeben wird, wird von HttpWebRequestCreatezurückgegeben. Wenn stattdessen ein URI, der mit ftp://
beginnt, übergeben wird, gibt die Create Methode einen FileWebRequest instance zurück. Wenn stattdessen ein URI, der mit file://
beginnt, übergeben wird, gibt die Create Methode einen FileWebRequest instance zurück.
Die bereits registrierten vorab registrierten Reservetypen umfassen Folgendes:
http://
https://
ftp://
file://
.NET bietet Unterstützung für die http://
URI-Schemas , https://
, ftp://
und file://
. Benutzerdefinierte WebRequest Nachfolger zum Verarbeiten anderer Anforderungen werden bei der RegisterPrefix -Methode registriert.
Hinweis
Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung im .NET Framework.
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für