WebRequest.Create Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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.