WebRequest.Create Methode

Referenz

Definition

Namespace:: System.Net

Assembly:: System.Net.Requests.dll

Assembly:: System.dll

Assembly:: netstandard.dll

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

WebRequest

Ein WebRequest-Nachfolger für ein bestimmtes URI-Schema.

Attribute: ObsoleteAttribute

Ausnahmen

NotSupportedException

Das in requestUriString angegebene Anforderungsschema wurde nicht registriert.

ArgumentNullException

requestUriString ist null.

SecurityException

Der Aufrufer besitzt keine WebPermissionAttribute-Berechtigung zum Herstellen einer Verbindung mit dem angeforderten URI oder einem URI, an den die Anforderung umgeleitet wurde.

UriFormatException

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 requestUrifestgelegt wurde.

Wenn beispielsweise ein URI, der mit http:// oder https:// beginnt, in requestUriübergeben wird, wird von HttpWebRequest Createzurü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

Programmieren austauschbarer Protokolle

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

requestUri: Uri

Ein Uri mit dem URI der angeforderten Ressource.

Gibt zurück

WebRequest

Ein WebRequest-Nachfolger für das angegebene URI-Schema.

Attribute: ObsoleteAttribute

Ausnahmen

NotSupportedException

Das in requestUri angegebene Anforderungsschema wurde nicht registriert.

ArgumentNullException

requestUri ist null.

SecurityException

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 requestUrifestgelegt 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 HttpWebRequest Createzurü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://

Hinweis

Gilt für:

WebRequest.Create Methode

Definition

Überlädt

Create(String)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Create(Uri)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

Feedback

Zusätzliche Ressourcen