WebRequest.RegisterPrefix(String, IWebRequestCreate) Method

Definition

Inscrit un descendant de WebRequest pour l'URI spécifié.Registers a WebRequest descendant for the specified URI.

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

Parameters

prefix
String

URI complet ou préfixe d'URI traité par le descendant de WebRequest.The complete URI or URI prefix that the WebRequest descendant services.

creator
IWebRequestCreate

Méthode de création appelée par l'élément WebRequest pour créer le descendant de WebRequest.The create method that the WebRequest calls to create the WebRequest descendant.

Returns

Boolean

true si l'inscription a réussi ; sinon, false.true if registration is successful; otherwise, false.

Exceptions

prefix est nullprefix is null

-ou--or- creator a la valeur null.creator is null.

Remarks

La méthode RegisterPrefix inscrit WebRequest descendants pour les demandes de service.The RegisterPrefix method registers WebRequest descendants to service requests. WebRequest les descendants sont généralement enregistrés pour gérer un protocole spécifique, tel que HTTP ou FTP, mais peuvent être inscrits pour gérer une demande à un serveur ou à un chemin d’accès spécifique sur un serveur.WebRequest descendants are typically registered to handle a specific protocol, such HTTP or FTP, but can be registered to handle a request to a specific server or path on a server.

Les types de réserve pré-inscrits déjà inscrits sont les suivants :The pre-registered reserve types already registered include the following:

  • http://

  • https://

  • ftp://

  • file://

Pour plus d’informations, consultez les méthodes Create(String) et Create(Uri).For more information, see the Create(String) and Create(Uri) methods.

Les préfixes dupliqués ne sont pas autorisés.Duplicate prefixes are not allowed. RegisterPrefix retourne false si une tentative est effectuée pour enregistrer un préfixe dupliqué.RegisterPrefix returns false if an attempt is made to register a duplicate prefix.

Note

La classe HttpWebRequest est inscrite aux demandes de service pour les schémas HTTP et HTTPs par défaut.The HttpWebRequest class is registered to service requests for HTTP and HTTPS schemes by default. Toute tentative d’inscription d’un autre descendant de WebRequest pour ces schémas échouera.Attempts to register a different WebRequest descendant for these schemes will fail.

Applies to