WebRequest.Create Méthode

Définition

Initialise un nouveau WebRequest.

Surcharges

Nom Description
Create(String)
Obsolète.

Initialise une nouvelle WebRequest instance pour le schéma d’URI spécifié.

Create(Uri)
Obsolète.

Initialise une nouvelle WebRequest instance pour le schéma d’URI spécifié.

Create(String)

Source:
WebRequest.cs
Source:
WebRequest.cs
Source:
WebRequest.cs
Source:
WebRequest.cs
Source:
WebRequest.cs

Attention

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

Initialise une nouvelle WebRequest instance pour le schéma 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 pour le schéma d’URI spécifique.

Attributs

Exceptions

Le schéma de requête spécifié dans requestUriString n’a pas été inscrit.

requestUriString a la valeur null.

L’appelant n’a WebPermissionAttribute pas l’autorisation de se connecter à l’URI demandé ou à un URI vers lequel la requête est redirigée.

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

Exemples

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

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 classe déterminée au moment de l’exécution WebRequest en tant que correspondance inscrite la plus proche pour requestUri.

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

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

  • http://

  • https://

  • ftp://

  • file://

.NET inclut la prise en charge des http://schémas , https://, ftp://et file:// URI. Les descendants personnalisés WebRequest pour gérer d’autres requêtes sont inscrits auprès de la RegisterPrefix méthode.

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

Note

Ce membre génère des informations de suivi lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Network Tracing in the .NET Framework.

Voir aussi

S’applique à

Create(Uri)

Source:
WebRequest.cs
Source:
WebRequest.cs
Source:
WebRequest.cs
Source:
WebRequest.cs
Source:
WebRequest.cs

Attention

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

Initialise une nouvelle WebRequest instance pour le schéma 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

Uri Uri contenant l’URI de la ressource demandée.

Retours

WebRequest Descendant pour le schéma d’URI spécifié.

Attributs

Exceptions

Le schéma de requête spécifié dans requestUri n’est pas inscrit.

requestUri a la valeur null.

L’appelant n’a WebPermissionAttribute pas l’autorisation de se connecter à l’URI demandé ou à un URI vers lequel la requête est redirigée.

Exemples

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

// 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 classe déterminée au moment de l’exécution WebRequest en tant que correspondance inscrite la plus proche pour requestUri.

Par exemple, si vous créez un WebRequest descendant, Handler1, pour gérer les requêtes vers http://www.contoso.com/text/ et un autre gestionnaire nommé pour gérer les requêtes à http://www.contoso.com/code/, vous pouvez utiliser Create la méthode pour renvoyer le descendant WebRequest associé à l’URI spécifié.

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

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

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

  • http://

  • https://

  • ftp://

  • file://

.NET inclut la prise en charge des http://schémas , https://, ftp://et file:// URI. Les descendants personnalisés WebRequest pour gérer d’autres requêtes sont inscrits auprès de la RegisterPrefix méthode.

Note

Ce membre génère des informations de suivi lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Network Tracing in the .NET Framework.

S’applique à