WebRequest.RegisterPrefix(String, IWebRequestCreate) Méthode

  • Référence

Définition

Espace de noms:
System.Net
Assembly:
System.Net.Requests.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Source:
WebRequest.cs
Source:
WebRequest.cs
Source:
WebRequest.cs

Inscrit un descendant de WebRequest 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 traité par le descendant de WebRequest.

creator
IWebRequestCreate

Méthode de création appelée par l'élément WebRequest pour créer le descendant de WebRequest.

Retours

Boolean

true si l'inscription a réussi ; sinon, false.

Exceptions

ArgumentNullException

prefix a la valeur null.

- ou -

creator a la valeur null.

Remarques

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 demande adressée à un serveur ou 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 Create(String) méthodes 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.

Notes

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

S’applique à