WebRequest.Create Méthode

Référence

Définition

Espace de noms:: System.Net

Assembly:: System.Net.Requests.dll

Assembly:: System.dll

Assembly:: netstandard.dll

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

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: ObsoleteAttribute

Exceptions

NotSupportedException

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

ArgumentNullException

requestUriString a la valeur null.

SecurityException

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

UriFormatException

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

Remarque : dans .NET pour les applications Windows Store ou la bibliothèque de classes portables, 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 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 ftp:// par est passé à la place, la Create méthode retourne une FtpWebRequest instance. Si un URI commençant file:// par est passé à la place, la Create méthode retourne une FileWebRequest instance.

Les types de réserves 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 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

programmation de protocoles enfichables

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: ObsoleteAttribute

Exceptions

NotSupportedException

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

ArgumentNullException

requestUri a la valeur null.

SecurityException

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. 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 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 demandes adressées à http://www.contoso.com/text/ un autre gestionnaire nommé pour gérer les demandes, http://www.contoso.com/code/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 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 ftp:// par est passé à la place, la Create méthode retourne une FileWebRequest instance. Si un URI commençant file:// par est passé à la place, la Create méthode retourne une FileWebRequest instance.

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

http://
https://
ftp://
file://

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 à

WebRequest.Create Méthode

Définition

Surcharges

Create(String)

Paramètres

Retours

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

Create(Uri)

Paramètres

Retours

Exceptions

Exemples

Remarques

S’applique à

Ressources supplémentaires