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)

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 die Portable Class Library fangen Sie stattdessen die Basisklasse-Ausnahme ab. FormatException

Beispiele

Im folgenden Beispiel wird eine Create Instanz instanziieren HttpWebRequest . Eine Zeichenfolge, die die Ziel-URL darstellt, wird als Konstruktorparameter verwendet.

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 Absteigenden der WebRequest Klasse zurück, die zur Laufzeit als am nächsten registrierten Übereinstimmung für requestUri.

Wenn beispielsweise ein URI mit http:// oder https:// übergeben requestUriwird, wird eine HttpWebRequest von Create. Wenn stattdessen ein URI übergeben ftp:// wird, gibt die Create Methode eine FtpWebRequest Instanz zurück. Wenn stattdessen ein URI übergeben file:// 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 Untergeordnete, um andere Anforderungen zu behandeln, werden mit der RegisterPrefix Methode registriert.

Die Create Methode verwendet den requestUriString Parameter, um eine Uri Instanz zu erstellen, die an das neue WebRequestübergeben wird.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter "Netzwerkablaufverfolgung" im .NET Framework.

Siehe auch

Programmieren austauschbarer Protokolle

Gilt für

Create(Uri)

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 eine Create Instanz instanziieren HttpWebRequest . 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 Absteigenden der WebRequest Klasse zurück, die zur Laufzeit als am nächsten registrierten Übereinstimmung für requestUri.

Wenn Sie z. B. einen WebRequest Absteigenden, Handler1, zum Behandeln von Anforderungen http://www.contoso.com/text/ und einen anderen benannten Handler2 erstellen, um Anforderungen zu http://www.contoso.com/code/behandeln, können Sie die Methode verwenden Create , um den WebRequest-Absteigenden zurückzugeben, der einem angegebenen URI zugeordnet ist.

Verwenden Sie CreateDefault die Methode, um einen Absteigenden der WebRequest Klasse basierend auf nur dem Schemateil eines URI zurückzugeben.

Wenn beispielsweise ein URI mit http:// oder https:// übergeben requestUriwird, wird eine HttpWebRequest von Create. Wenn stattdessen ein URI übergeben ftp:// wird, gibt die Create Methode eine FileWebRequest Instanz zurück. Wenn stattdessen ein URI übergeben file:// wird, gibt die Create Methode eine FileWebRequest Instanz zurück.

Die bereits 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

Siehe auch

Gilt für

Create(Uri)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für

Zusätzliche Ressourcen