WebRequest.RegisterPrefix(String, IWebRequestCreate) Metodo

Definizione

Spazio dei nomi:
System.Net
Assembly:
System.dll, System.Net.Requests.dll
Assembly:
netstandard.dll, System.Net.Requests.dll
Assembly:
System.Net.Requests.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Origine:
WebRequest.cs
Origine:
WebRequest.cs
Origine:
WebRequest.cs
Origine:
WebRequest.cs
Origine:
WebRequest.cs

Registra un WebRequest discendente per l'URI specificato.

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

Parametri

prefix
String

Prefisso URI o URI completo che i WebRequest servizi discendenti.

creator
IWebRequestCreate

Metodo create che chiama WebRequest per creare il WebRequest discendente.

Valori restituiti

Boolean

true se la registrazione ha esito positivo; in caso contrario, false.

Eccezioni

ArgumentNullException

prefix è null

oppure

creator è null.

Commenti

Attenzione

WebRequest HttpWebRequest, ServicePoint, e WebClient sono obsoleti e non è consigliabile usarli per il nuovo sviluppo. Utilizzare invece HttpClient.

Il RegisterPrefix metodo registra WebRequest discendenti alle richieste di servizio. WebRequest I discendenti vengono in genere registrati per gestire un protocollo specifico, ad esempio HTTP o FTP, ma possono essere registrati per gestire una richiesta a un server o un percorso specifico in un server.

I tipi di riserva preregistrato già registrati includono quanto segue:

  • http://

  • https://

  • ftp://

  • file://

Per altre informazioni, vedere i Create(String) metodi e Create(Uri) .

Non sono consentiti prefissi duplicati. RegisterPrefix restituisce false se viene effettuato un tentativo di registrare un prefisso duplicato.

Note

La HttpWebRequest classe viene registrata per le richieste di servizio per schemi HTTP e HTTPS per impostazione predefinita. I tentativi di registrare un discendente diverso WebRequest per questi schemi avranno esito negativo.

Si applica a