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: Erfassen Sie in .NET für Windows Store-Apps oder der portablen Klassenbibliothek stattdessen die Basisklassen-Ausnahme FormatException.

Beispiele

Im folgenden Beispiel wird Create verwendet, um eine HttpWebRequest Instanz 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 ein Nachkomme der Klasse zurück, die WebRequest zur Laufzeit als nächstgelegene registrierte Übereinstimmung für requestUribestimmt wurde.

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

Zu den bereits registrierten vorregistrierten Reservetypen gehören:

http://
https://
ftp://
file://

.NET bietet Unterstützung für die http://URI-Schemas , https://, ftp://und file:// . Benutzerdefinierte WebRequest Abhängige zum Verarbeiten 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.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .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 Create verwendet, um eine HttpWebRequest Instanz zu instanziieren. Als Konstruktorparameter wird ein URI verwendet, der die Ziel-URL darstellt.

// 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 ein Nachkomme der Klasse zurück, die WebRequest zur Laufzeit als nächstgelegene registrierte Übereinstimmung für requestUribestimmt wurde.

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

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

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

Zu den bereits registrierten vorregistrierten Reservetypen gehören:

http://
https://
ftp://
file://

Hinweis

Gilt für:

Teilen über

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:

Zusätzliche Ressourcen