WebRequest.RegisterPrefix(String, IWebRequestCreate) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 -> boolPublic Shared Function RegisterPrefix (prefix As String, creator As IWebRequestCreate) As BooleanParametri
- 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
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.
