WebRequest.RegisterPrefix(String, IWebRequestCreate) Méthode

Définition

Espace de noms:
System.Net
Assemblys:
System.dll, System.Net.Requests.dll
Assembly:
System.dll
Assembly:
netstandard.dll

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

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

creator
IWebRequestCreate

Méthode de création que les WebRequest appels permettent de créer le WebRequest descendant.

Retours

Boolean

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

Exceptions

ArgumentNullException

prefix est null

-ou-

creator a la valeur null.

Remarques

Avertissement

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

La RegisterPrefix méthode inscrit les WebRequest descendants aux demandes de service. WebRequest Les 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 et Create(String) les Create(Uri) méthodes.

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

Note

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

S’applique à