Teilen über


WebRequest.Create Methode

Definition

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: 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

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

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 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 WebRequestCreateDefault -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://

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

Hinweis

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

Gilt für: