WebRequest.Create WebRequest.Create WebRequest.Create WebRequest.Create Method

Definition

Initialisiert eine neue WebRequest.Initializes a new WebRequest.

Überlädt

Create(String) Create(String) Create(String) Create(String)

Initialisiert eine neue WebRequest-Instanz für das angegebene URI-Schema.Initializes a new WebRequest instance for the specified URI scheme.

Create(Uri) Create(Uri) Create(Uri) Create(Uri)

Initialisiert eine neue WebRequest-Instanz für das angegebene URI-Schema.Initializes a new WebRequest instance for the specified URI scheme.

Create(String) Create(String) Create(String) Create(String)

Initialisiert eine neue WebRequest-Instanz für das angegebene URI-Schema.Initializes a new WebRequest instance for the specified URI scheme.

public:
 static System::Net::WebRequest ^ Create(System::String ^ requestUriString);
public static System.Net.WebRequest Create (string requestUriString);
static member Create : string -> System.Net.WebRequest
Public Shared Function Create (requestUriString As String) As WebRequest

Parameter

requestUriString
String String String String

Der URI, der die Internetressource bezeichnet.The URI that identifies the Internet resource.

Gibt zurück

Ein WebRequest-Nachfolger für ein bestimmtes URI-Schema.A WebRequest descendant for the specific URI scheme.

Ausnahmen

Das in requestUriString angegebene Anforderungsschema wurde nicht registriert.The request scheme specified in requestUriString has not been registered.

requestUriString ist null.requestUriString is null.

Der Aufrufer besitzt keine WebPermissionAttribute-Berechtigung zum Herstellen einer Verbindung mit dem angeforderten URI oder einem URI, an den die Anforderung umgeleitet wurde.The caller does not have WebPermissionAttribute permission to connect to the requested URI or a URI that the request is redirected to.

Fangen Sie in .NET für Windows Store-Apps oder der portablen Klassenbibliothek stattdessen die Basisklassenausnahme FormatException ab.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

Der in requestUriString angegebene URI ist kein gültiger URI.The URI specified in requestUriString is not a valid URI.

Beispiele

Im folgenden Beispiel wird Create verwendet, um eine HttpWebRequest -Instanz zu instanziieren.The following example uses Create to instantiate an HttpWebRequest instance. Eine Zeichenfolge, die die Ziel-URL darstellt, wird als Konstruktorparameter verwendet.A string representing the target URL is used as the constructor parameter.

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 WebRequest der-Klasse zurück, die zur Laufzeit als die nächstliegende requestUriregistrierte Entsprechung für festgelegt wurde.The Create method returns a descendant of the WebRequest class determined at run time as the closest registered match for requestUri.

Wenn z. b. ein URI, http:// der https:// mit oder beginnt requestUri, an HttpWebRequest gesendet wird, Createwird ein von zurückgegeben.For example, when a URI beginning with http:// or https:// is passed in requestUri, an HttpWebRequest is returned by Create. Wenn ein URI, der ftp:// mit beginnt, stattdessen über Create mittelt wird, gibt FtpWebRequest die Methode eine-Instanz zurück.If a URI beginning with ftp:// is passed instead, the Create method will return a FtpWebRequest instance. Wenn ein URI, der file:// mit beginnt, stattdessen über Create mittelt wird, gibt FileWebRequest die Methode eine-Instanz zurück.If a URI beginning with file:// is passed instead, the Create method will return a FileWebRequest instance.

Die bereits registrierten Reserve Typen umfassen Folgendes:The pre-registered reserve types already registered include the following:

  • http://

  • https://

  • ftp://

  • file://

.Net bietet Unterstützung für http://die https://URI ftp://-Schemas,, und file:// ..NET includes support for the http://, https://, ftp://, and file:// URI schemes. Benutzer WebRequest definierte Nachfolger, die andere Anforderungen verarbeiten, werden RegisterPrefix bei der-Methode registriert.Custom WebRequest descendants to handle other requests are registered with the RegisterPrefix method.

Die Create -Methode verwendet requestUriString den-Parameter, Uri um eine-Instanz zu erstellen, WebRequestdie Sie an die neue übergibt.The Create method uses the requestUriString parameter to create a Uri instance that it passes to the new WebRequest.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren.This member outputs trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerk Ablauf Verfolgung in der .NET Framework.For more information, see Network Tracing in the .NET Framework.

Siehe auch

Create(Uri) Create(Uri) Create(Uri) Create(Uri)

Initialisiert eine neue WebRequest-Instanz für das angegebene URI-Schema.Initializes a new WebRequest instance for the specified URI scheme.

public:
 static System::Net::WebRequest ^ Create(Uri ^ requestUri);
public static System.Net.WebRequest Create (Uri requestUri);
static member Create : Uri -> System.Net.WebRequest
Public Shared Function Create (requestUri As Uri) As WebRequest

Parameter

requestUri
Uri Uri Uri Uri

Ein Uri mit dem URI der angeforderten Ressource.A Uri containing the URI of the requested resource.

Gibt zurück

Ein WebRequest-Nachfolger für das angegebene URI-Schema.A WebRequest descendant for the specified URI scheme.

Ausnahmen

Das in requestUri angegebene Anforderungsschema wurde nicht registriert.The request scheme specified in requestUri is not registered.

Der Aufrufer besitzt keine WebPermissionAttribute-Berechtigung zum Herstellen einer Verbindung mit dem angeforderten URI oder einem URI, an den die Anforderung umgeleitet wurde.The caller does not have WebPermissionAttribute permission to connect to the requested URI or a URI that the request is redirected to.

Beispiele

Im folgenden Beispiel wird Create verwendet, um eine HttpWebRequest -Instanz zu instanziieren.The following example uses Create to instantiate an HttpWebRequest instance. Ein URI, der die Ziel-URL darstellt, wird als Konstruktorparameter verwendet.A Uri representing the target URL is used as the constructor parameter.

// 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 WebRequest der-Klasse zurück, die zur Laufzeit als die nächstliegende requestUriregistrierte Entsprechung für festgelegt wurde.The Create method returns a descendant of the WebRequest class determined at run time as the closest registered match for requestUri.

Wenn Sie z. b. einen WebRequest Nachfolger, handler1, zum Verarbeiten von Anforderungen http://www.contoso.com/text/ an und einen anderen benannten handler2 zum verarbeiten http://www.contoso.com/code/von Anforderungen an erstellen Create , können Sie die-Methode verwenden, um den WebRequest-Nachfolger zurückzugeben, der mit einem der beiden der angegebene URI.For example, if you create a WebRequest descendant, Handler1, to handle requests to http://www.contoso.com/text/ and another named Handler2 to handle requests to http://www.contoso.com/code/, you can use Create method to return the WebRequest descendant associated with either specified URI.

Um einen Nachfolger der WebRequest -Klasse auf Grundlage des Schema Teils eines URI zurückzugeben, verwenden Sie die CreateDefault -Methode.To return a descendant of the WebRequest class based on only the scheme portion of a URI, use the CreateDefault method.

Wenn z. b. ein URI, http:// der https:// mit oder beginnt requestUri, an HttpWebRequest gesendet wird, Createwird ein von zurückgegeben.For example, when a URI beginning with http:// or https:// is passed in requestUri, an HttpWebRequest is returned by Create. Wenn ein URI, der ftp:// mit beginnt, stattdessen über Create mittelt wird, gibt FileWebRequest die Methode eine-Instanz zurück.If a URI beginning with ftp:// is passed instead, the Create method will return a FileWebRequest instance. Wenn ein URI, der file:// mit beginnt, stattdessen über Create mittelt wird, gibt FileWebRequest die Methode eine-Instanz zurück.If a URI beginning with file:// is passed instead, the Create method will return a FileWebRequest instance.

Die bereits registrierten Reserve Typen umfassen Folgendes:The pre-registered reserve types already registered include the following:

  • http://

  • https://

  • ftp://

  • file://

.Net bietet Unterstützung für http://die https://URI ftp://-Schemas,, und file:// ..NET includes support for the http://, https://, ftp://, and file:// URI schemes. Benutzer WebRequest definierte Nachfolger, die andere Anforderungen verarbeiten, werden RegisterPrefix bei der-Methode registriert.Custom WebRequest descendants to handle other requests are registered with the RegisterPrefix method.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren.This member outputs trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerk Ablauf Verfolgung in der .NET Framework.For more information, see Network Tracing in the .NET Framework.

Gilt für: