WebRequest.RegisterPrefix(String, IWebRequestCreate) 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.
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 -> boolPublic Shared Function RegisterPrefix (prefix As String, creator As IWebRequestCreate) As BooleanParamè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
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.
