Elemento <add> per webRequestModules (Impostazioni di rete)

Articolo
09/12/2008

Aggiornamento: novembre 2007

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

Elemento <Configuration>
  Elemento <system.Net> (Impostazioni di rete)
    Elemento <webRequestModules> (Impostazioni di rete)
      Elemento <add> per webRequestModules (Impostazioni di rete)

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

Attributi ed elementi

Nelle sezioni riportate di seguito vengono illustrati attributi, elementi figlio ed elementi 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	Descrizione
webRequestModules	Specifica i 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