WebRequest.RegisterPrefix(String, IWebRequestCreate) Methode

Definitie

Registreert een WebRequest afstammeling voor de opgegeven 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

Het volledige URI- of URI-voorvoegsel dat de WebRequest onderliggende services bevat.

creator
IWebRequestCreate

De create-methode die de WebRequest aanroept om de WebRequest afstammeling te maken.

Retouren

true als de registratie is geslaagd; anders, false.

Uitzonderingen

prefix Is null

– of –

creator is null.

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

De RegisterPrefix methode registreert WebRequest afstammelingen bij serviceaanvragen. WebRequest afstammelingen worden doorgaans geregistreerd voor het verwerken van een specifiek protocol, zoals HTTP of FTP, maar kunnen worden geregistreerd om een aanvraag naar een specifieke server of een specifiek pad op een server te verwerken.

De vooraf geregistreerde reservetypen die al zijn geregistreerd, zijn onder andere:

  • http://

  • https://

  • ftp://

  • file://

Zie de Create(String) en Create(Uri) methoden voor meer informatie.

Dubbele voorvoegsels zijn niet toegestaan. RegisterPrefix retourneert false als er een poging wordt gedaan om een dubbel voorvoegsel te registreren.

Note

De HttpWebRequest klasse is standaard geregistreerd bij serviceaanvragen voor HTTP- en HTTPS-schema's. Pogingen om een andere WebRequest afstammeling voor deze schema's te registreren, mislukken.

Van toepassing op