WebRequest.RegisterPrefix(String, IWebRequestCreate) Méthode

Définition

Inscrit un WebRequest descendant pour l’URI spécifié.

public:
 static bool RegisterPrefix(System::String ^ prefix, System::Net::IWebRequestCreate ^ creator);
public static bool RegisterPrefix (string prefix, System.Net.IWebRequestCreate creator);
static member RegisterPrefix : string * System.Net.IWebRequestCreate -> bool
Public Shared Function RegisterPrefix (prefix As String, creator As IWebRequestCreate) As Boolean

Paramètres

prefix
String

Préfixe d’URI ou d’URI complet que les services descendants WebRequest.

creator
IWebRequestCreate

Méthode create que le WebRequest appelle pour créer le descendant WebRequest.

Retours

true si l’inscription réussit ; sinon, false.

Exceptions

prefix est null

-ou-

creator est null.

Remarques

Prudence

WebRequest, HttpWebRequest, ServicePointet WebClient sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.

La méthode RegisterPrefix inscrit WebRequest descendants aux demandes de service. WebRequest descendants sont généralement inscrits pour gérer un protocole spécifique, tel que HTTP ou FTP, mais peuvent être inscrits pour gérer une requête auprès d’un serveur ou d’un chemin d’accès spécifique sur un serveur.

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

  • http://

  • https://

  • ftp://

  • file://

Pour plus d’informations, consultez les méthodes Create(String) et Create(Uri).

Les préfixes en double ne sont pas autorisés. RegisterPrefix retourne false si une tentative d’inscription d’un préfixe en double est effectuée.

Note

La classe HttpWebRequest est inscrite pour les demandes de service pour les schémas HTTP et HTTPS par défaut. Les tentatives d’inscription d’un autre descendant WebRequest pour ces schémas échoueront.

S’applique à