Elemento <add> per webRequestModules (Impostazioni di rete)

Articolo
08/11/2011

Consente di aggiungere un modulo di richiesta Web personalizzato all'applicazione.

<add 
  prefix = "URI prefix" 
  type = "module name, Version, Culture, PublicKeyToken" 
/>

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Attributi

Attributo	Descrizione
prefix	Prefisso URI per le richieste gestite da questo modulo di richiesta Web.
type	Nome di classe e assembly del modulo che implementa questo modulo di richiesta Web.

Elementi figlio

Nessuno.

Elementi padre

Elemento	Oggetto di descrizione
<webRequestModules>	Selezione dei moduli da utilizzare per richiedere informazioni agli host di rete.

Note

L'attributo prefix definisce il prefisso URI che utilizza il modulo di richiesta Web specificato. I moduli di richiesta Web vengono registrati, in genere, per gestire un protocollo specifico, come HTTP o FTP, ma è possibile registrarli per gestire una richiesta inviata a un server o a un percorso su un server specifico.

Il modulo di richiesta Web viene creato quando al metodo WebRequest.Create viene passato un prefisso corrispondente a un URI.

Il valore dell'attributo prefix deve corrispondere ai caratteri iniziali di un URI valido, ad esempio "http" o "https://www.contoso.com".

Il valore dell'attributo type deve essere costituito da un nome DLL valido e un nome di classe corrispondente, separati da una virgola.

File di configurazione

L'elemento può essere utilizzato nel file di configurazione dell'applicazione o nel file di configurazione del computer (Machine.config).

Esempio

Nell'esempio di codice riportato di seguito viene registrato un modulo di richiesta Web per HTTP personalizzato. È necessario sostituire i valori di Version e PublicKeyToken con i valori corretti per il modulo specificato.

<configuration>
  <system.net>
    <webRequestModules>
      <add prefix="http"
           type="System.Net.HttpRequestCreator, System, Version=2.0.3600.0,
           Culture=neutral, PublicKeyToken=b77a5c561934e089"
      />
    </webRequestModules>
  </system.net>
</configuration>

Vedere anche

Riferimenti

Schema delle impostazioni di rete

WebRequest

Condividi tramite