WebRequest.Create Méthode

Définition

Initialise un nouveau WebRequest.Initializes a new WebRequest.

Surcharges

Create(String)

Initialise une nouvelle instance de WebRequest pour le modèle d'URI spécifié.Initializes a new WebRequest instance for the specified URI scheme.

Create(Uri)

Initialise une nouvelle instance de WebRequest pour le modèle d'URI spécifié.Initializes a new WebRequest instance for the specified URI scheme.

Create(String)

Initialise une nouvelle instance de WebRequest pour le modèle d'URI spécifié.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

Paramètres

requestUriString
String

URI qui identifie la ressource Internet.The URI that identifies the Internet resource.

Retours

Descendant de WebRequest pour le modèle d'URI spécifique.A WebRequest descendant for the specific URI scheme.

Exceptions

Le schéma de demande spécifié dans requestUriString n’a pas été enregistré.The request scheme specified in requestUriString has not been registered.

requestUriString a la valeur null.requestUriString is null.

L’appelant n’a pas l’autorisation WebPermissionAttribute de se connecter à l’URI demandé ou à un URI vers lequel la demande est redirigée.The caller does not have WebPermissionAttribute permission to connect to the requested URI or a URI that the request is redirected to.

Dans .NET pour les applications du Windows Store ou la Bibliothèque de classes portable, interceptez l’exception de la classe de base, FormatException, à la place.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

L’URI spécifié dans requestUriString n’est pas un URI valide.The URI specified in requestUriString is not a valid URI.

Exemples

L’exemple suivant utilise Create pour instancier HttpWebRequest une instance de.The following example uses Create to instantiate an HttpWebRequest instance. Une chaîne représentant l’URL cible est utilisée comme paramètre de constructeur.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()

Remarques

La Create méthode retourne un descendant de la WebRequest classe déterminé au moment de l’exécution comme correspondance la plus proche requestUriinscrite pour.The Create method returns a descendant of the WebRequest class determined at run time as the closest registered match for requestUri.

Par exemple, lorsqu’un URI commençant par http:// ou https:// est passé requestUri, une HttpWebRequest est retournée par Create.For example, when a URI beginning with http:// or https:// is passed in requestUri, an HttpWebRequest is returned by Create. Si un URI commençant par ftp:// est passé à la place Create , la méthode retourne FtpWebRequest une instance de.If a URI beginning with ftp:// is passed instead, the Create method will return a FtpWebRequest instance. Si un URI commençant par file:// est passé à la place Create , la méthode retourne FileWebRequest une instance de.If a URI beginning with file:// is passed instead, the Create method will return a FileWebRequest instance.

Les types de réserve pré-inscrits déjà inscrits sont les suivants :The pre-registered reserve types already registered include the following:

  • http://

  • https://

  • ftp://

  • file://

.NET prend en charge les http://schémas https://d' ftp://URI, file:// , et..NET includes support for the http://, https://, ftp://, and file:// URI schemes. Les WebRequest descendants personnalisés pour gérer d’autres demandes sont inscrits RegisterPrefix avec la méthode.Custom WebRequest descendants to handle other requests are registered with the RegisterPrefix method.

La Create méthode utilise le requestUriString paramètre pour créer une Uri instance qu’il transmet au nouveau WebRequest.The Create method uses the requestUriString parameter to create a Uri instance that it passes to the new WebRequest.

Notes

Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application.This member outputs trace information when you enable network tracing in your application. Pour plus d’informations, consultez la page traçage réseau dans le .NET Framework.For more information, see Network Tracing in the .NET Framework.

Voir aussi

Create(Uri)

Initialise une nouvelle instance de WebRequest pour le modèle d'URI spécifié.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

Paramètres

requestUri
Uri

Uri contenant l'URI de la ressource demandée.A Uri containing the URI of the requested resource.

Retours

Descendant WebRequest pour le modèle URI spécifié.A WebRequest descendant for the specified URI scheme.

Exceptions

Le schéma de demande spécifié dans requestUri n'est pas inscrit.The request scheme specified in requestUri is not registered.

requestUri est null.requestUri is null.

L’appelant n’a pas l’autorisation WebPermissionAttribute de se connecter à l’URI demandé ou à un URI vers lequel la demande est redirigée.The caller does not have WebPermissionAttribute permission to connect to the requested URI or a URI that the request is redirected to.

Exemples

L’exemple suivant utilise Create pour instancier HttpWebRequest une instance de.The following example uses Create to instantiate an HttpWebRequest instance. Un Uri représentant l’URL cible est utilisé comme paramètre de constructeur.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()

Remarques

La Create méthode retourne un descendant de la WebRequest classe déterminé au moment de l’exécution comme correspondance la plus proche requestUriinscrite pour.The Create method returns a descendant of the WebRequest class determined at run time as the closest registered match for requestUri.

Par exemple, si vous créez un WebRequest descendant, Handler1, pour gérer les demandes http://www.contoso.com/text/ à et un autre handler2 nommé pour gérer http://www.contoso.com/code/les demandes à, Create vous pouvez utiliser la méthode pour retourner le descendant WebRequest associé à l’un ou l’autre URI spécifié.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.

Pour retourner un descendant de la WebRequest classe uniquement en fonction de la partie schéma d’un URI, utilisez CreateDefault la méthode.To return a descendant of the WebRequest class based on only the scheme portion of a URI, use the CreateDefault method.

Par exemple, lorsqu’un URI commençant par http:// ou https:// est passé requestUri, une HttpWebRequest est retournée par Create.For example, when a URI beginning with http:// or https:// is passed in requestUri, an HttpWebRequest is returned by Create. Si un URI commençant par ftp:// est passé à la place Create , la méthode retourne FileWebRequest une instance de.If a URI beginning with ftp:// is passed instead, the Create method will return a FileWebRequest instance. Si un URI commençant par file:// est passé à la place Create , la méthode retourne FileWebRequest une instance de.If a URI beginning with file:// is passed instead, the Create method will return a FileWebRequest instance.

Les types de réserve pré-inscrits déjà inscrits sont les suivants :The pre-registered reserve types already registered include the following:

  • http://

  • https://

  • ftp://

  • file://

.NET prend en charge les http://schémas https://d' ftp://URI, file:// , et..NET includes support for the http://, https://, ftp://, and file:// URI schemes. Les WebRequest descendants personnalisés pour gérer d’autres demandes sont inscrits RegisterPrefix avec la méthode.Custom WebRequest descendants to handle other requests are registered with the RegisterPrefix method.

Notes

Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application.This member outputs trace information when you enable network tracing in your application. Pour plus d’informations, consultez la page traçage réseau dans le .NET Framework.For more information, see Network Tracing in the .NET Framework.

S’applique à