WebRequest.Create Méthode

Définition

Initialise un nouveau WebRequest.

Surcharges

Create(String)
Obsolète.

Initialise une nouvelle instance de WebRequest pour le modèle d'URI spécifié.

Create(Uri)
Obsolète.

Initialise une nouvelle instance de WebRequest pour le modèle d'URI spécifié.

Create(String)

Attention

WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.

Initialise une nouvelle instance de WebRequest pour le modèle d'URI spécifié.

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

Paramètres

requestUriString
String

URI qui identifie la ressource Internet.

Retours

WebRequest

Descendant de WebRequest pour le modèle d'URI spécifique.

Attributs

Exceptions

Le schéma de demande spécifié dans requestUriString n’a pas été enregistré.

requestUriString a la valeur 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.

L’URI spécifié dans requestUriString n’est pas un URI valide.

remarque : dans .net pour les applications du windows Store Windows ou la bibliothèque de classes Portable, interceptez l’exception de la classe de base,, à la FormatException place.

Exemples

L’exemple suivant utilise Create pour instancier une HttpWebRequest instance de. Une chaîne représentant l’URL cible est utilisée comme paramètre de constructeur.

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 inscrite pour requestUri .

Par exemple, lorsqu’un URI commençant par http:// ou https:// est passé requestUri , une HttpWebRequest est retournée par Create . Si un URI commençant par ftp:// est passé à la place, la Create méthode retourne une FtpWebRequest instance de. Si un URI commençant par file:// est passé à la place, la Create méthode retourne une FileWebRequest instance de.

Les types de réserve pré-inscrits déjà inscrits sont les suivants :

  • http://

  • https://

  • ftp://

  • file://

.NET prend en charge les http:// https:// schémas d’URI,, ftp:// et file:// . WebRequestLes descendants personnalisés pour gérer d’autres demandes sont inscrits avec la RegisterPrefix méthode.

La Create méthode utilise le requestUriString paramètre pour créer une Uri instance qu’il transmet au nouveau WebRequest .

Notes

Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application. Pour plus d’informations, consultez la page traçage réseau dans le .NET Framework.

Voir aussi

S’applique à

Create(Uri)

Attention

WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.

Initialise une nouvelle instance de WebRequest pour le modèle d'URI spécifié.

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

Paramètres

requestUri
Uri

Élément Uri contenant l'URI de la ressource demandée.

Retours

WebRequest

Descendant de WebRequest pour le modèle d'URI spécifié.

Attributs

Exceptions

Le schéma de demande spécifié dans requestUri n'est pas inscrit.

requestUri a la valeur 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.

Exemples

L’exemple suivant utilise Create pour instancier une HttpWebRequest instance de. Un Uri représentant l’URL cible est utilisé comme paramètre de constructeur.

// 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 inscrite pour 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 à, vous pouvez utiliser Create la méthode pour retourner le descendant WebRequest associé à l’URI spécifié.

Pour retourner un descendant de la WebRequest classe uniquement en fonction de la partie schéma d’un URI, utilisez la CreateDefault méthode.

Par exemple, lorsqu’un URI commençant par http:// ou https:// est passé requestUri , une HttpWebRequest est retournée par Create . Si un URI commençant par ftp:// est passé à la place, la Create méthode retourne une FileWebRequest instance de. Si un URI commençant par file:// est passé à la place, la Create méthode retourne une FileWebRequest instance de.

Les types de réserve pré-inscrits déjà inscrits sont les suivants :

  • http://

  • https://

  • ftp://

  • file://

.NET prend en charge les http:// https:// schémas d’URI,, ftp:// et file:// . WebRequestLes descendants personnalisés pour gérer d’autres demandes sont inscrits avec la RegisterPrefix méthode.

Notes

Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application. Pour plus d’informations, consultez la page traçage réseau dans le .NET Framework.

S’applique à