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 zum Instanziieren einer HttpWebRequest Instanz.The following example uses Create to instantiate an HttpWebRequest instance. Eine Zeichenfolge mit der Ziel-URLs 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 Methodenrückgabe einen Nachfolger von der WebRequest bestimmt zur Laufzeit als die nächste Übereinstimmung für die registrierten Klasse requestUri.The Create method returns a descendant of the WebRequest class determined at run time as the closest registered match for requestUri.

Beispielsweise, wenn ein URI, beginnt mit http:// oder https:// übergeben requestUri, HttpWebRequest wird zurückgegeben, indem Create.For example, when a URI beginning with http:// or https:// is passed in requestUri, an HttpWebRequest is returned by Create. Wenn ein URI, beginnt mit ftp:// übergeben wird, die Create Methode gibt eine FtpWebRequest Instanz.If a URI beginning with ftp:// is passed instead, the Create method will return a FtpWebRequest instance. Wenn ein URI, beginnt mit file:// übergeben wird, die Create Methode gibt eine FileWebRequest Instanz.If a URI beginning with file:// is passed instead, the Create method will return a FileWebRequest instance.

Die folgenden: die vorregistrierte Reservetypen, die bereits registriertThe pre-registered reserve types already registered include the following:

  • http://

  • https://

  • ftp://

  • file://

.NET bietet Unterstützung für die http://, https://, ftp://, und file:// URI-Schemas..NET includes support for the http://, https://, ftp://, and file:// URI schemes. Benutzerdefinierte WebRequest Nachfolger zur Verarbeitung von anderen Anforderungen werden registriert, mit der RegisterPrefix Methode.Custom WebRequest descendants to handle other requests are registered with the RegisterPrefix method.

Die Create -Methode verwendet die requestUriString Parameter zum Erstellen einer Uri -Instanz, die mit dem neuen übergibt WebRequest.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 Netzwerkablaufverfolgung in .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 zum Instanziieren einer HttpWebRequest Instanz.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 Methodenrückgabe einen Nachfolger von der WebRequest bestimmt zur Laufzeit als die nächste Übereinstimmung für die registrierten Klasse requestUri.The Create method returns a descendant of the WebRequest class determined at run time as the closest registered match for requestUri.

Angenommen, Sie erstellen eine WebRequest Nachfolgerelements Handler1, zur Verarbeitung von Anforderungen zum http://www.contoso.com/text/ und eine andere benannte Handler2 zur Verarbeitung von Anforderungen zum http://www.contoso.com/code/, können Sie Create -Methode zur Rückgabe des WebRequest-Nachfolgers, die entweder zugeordnet angegebenen 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.

Einen Nachfolger des zurückzugebenden der WebRequest -Klasse auf der Grundlage von nur den Schemateil eines URI, 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.

Beispielsweise, wenn ein URI, beginnt mit http:// oder https:// übergeben requestUri, HttpWebRequest wird zurückgegeben, indem Create.For example, when a URI beginning with http:// or https:// is passed in requestUri, an HttpWebRequest is returned by Create. Wenn ein URI, beginnt mit ftp:// übergeben wird, die Create Methode gibt eine FileWebRequest Instanz.If a URI beginning with ftp:// is passed instead, the Create method will return a FileWebRequest instance. Wenn ein URI, beginnt mit file:// übergeben wird, die Create Methode gibt eine FileWebRequest Instanz.If a URI beginning with file:// is passed instead, the Create method will return a FileWebRequest instance.

Die folgenden: die vorregistrierte Reservetypen, die bereits registriertThe pre-registered reserve types already registered include the following:

  • http://

  • https://

  • ftp://

  • file://

.NET bietet Unterstützung für die http://, https://, ftp://, und file:// URI-Schemas..NET includes support for the http://, https://, ftp://, and file:// URI schemes. Benutzerdefinierte WebRequest Nachfolger zur Verarbeitung von anderen Anforderungen werden registriert, mit der RegisterPrefix Methode.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 Netzwerkablaufverfolgung in .NET Framework.For more information, see Network Tracing in the .NET Framework.

Gilt für: