WebRequest.RegisterPrefix(String, IWebRequestCreate) Metodo

  • Riferimento

Definizione

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

Registra un oggetto 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

URI completo o prefisso URI gestito dal discendente WebRequest.

creator
IWebRequestCreate

Metodo di creazione chiamato da WebRequest per creare il discendente WebRequest.

Restituisce

Boolean

true se la registrazione viene eseguita correttamente; in caso contrario, false.

Eccezioni

ArgumentNullException

prefix è null

-oppure-

creator è null.

Commenti

Il RegisterPrefix metodo registra WebRequest discendenti alle richieste di servizio. WebRequest i discendenti sono 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) .

I prefissi duplicati non sono consentiti. RegisterPrefix restituisce se viene eseguito un tentativo di registrare un prefisso duplicato false .

Nota

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