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)

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

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

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 ou la bibliothèque de classes portable, interceptez l’exception de classe de base, FormatException, à la place.

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 = 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ée au moment de l’exécution comme correspondance inscrite la plus proche pour requestUri.

Par exemple, lorsqu’un URI commençant http:// par ou https:// est passé dans requestUri, un HttpWebRequest 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 prend en charge les http://schémas d’URI , https://, ftp://et file:// . Les descendants personnalisés WebRequest 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’elle 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 Suivi réseau dans le .NET Framework.

Voir aussi

S’applique à

Create(Uri)

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

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

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. 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ée au moment de l’exécution comme correspondance inscrite la plus proche pour requestUri.

Par exemple, si vous créez un WebRequest descendant, Handler1, pour gérer les demandes adressées à http://www.contoso.com/text/ et un autre nommé Handler2 pour gérer les demandes adressées à http://www.contoso.com/code/, vous pouvez utiliser Create la méthode pour renvoyer le descendant WebRequest associé à l’UN des URI spécifiés.

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é dans requestUri, un HttpWebRequest 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 prend en charge les http://schémas d’URI , https://, ftp://et file:// . Les descendants personnalisés WebRequest 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 Suivi réseau dans le .NET Framework.

S’applique à