Condividi tramite


WebRequest.RegisterPrefix(String, IWebRequestCreate) Metodo

Definizione

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 completo o URI che il WebRequest servizi discendenti.

creator
IWebRequestCreate

Metodo create che il WebRequest chiama per creare il WebRequest discendente.

Restituisce

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

Eccezioni

prefix è null

-o-

creator è null.

Commenti

Cautela

WebRequest, HttpWebRequest, ServicePointe WebClient sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.

Il metodo RegisterPrefix registra WebRequest discendenti alle richieste di servizio. WebRequest discendenti vengono in genere registrati per gestire un protocollo specifico, ad esempio HTTP o FTP, ma può essere registrato 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 metodi Create(String) e Create(Uri).

Non sono consentiti prefissi duplicati. RegisterPrefix restituisce false se si tenta di registrare un prefisso duplicato.

Nota

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

Si applica a