Elemento <agregar> para webRequestModules (configuración de red)
Agrega un módulo de solicitud web personalizado a la aplicación.
<configuración>
<system.net>
<webRequestModules>
<agregar>
Sintaxis
<add
prefix="URI prefix"
type="type_fullname, assembly_fullname"
/>
Atributos y elementos
En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.
Atributos
Atributo | Descripción |
---|---|
prefix |
Prefijo de URI para las solicitudes administradas por este módulo de solicitud web. |
type |
El nombre de tipo completo (indicado por la propiedad FullName) y el nombre del ensamblado (indicado por la propiedad FullName), separados por una coma, que se utiliza para implementar este módulo de solicitud Web. |
Elementos secundarios
Ninguno.
Elementos primarios
Element | Descripción |
---|---|
webRequestModules | Especifica los módulos que se usarán para solicitar información de los anfitriones de red. |
Comentarios
El prefix
atributo define el prefijo URI que usa el módulo de solicitud web especificado. Normalmente, los módulos de solicitud web se registran para controlar un protocolo específico, como HTTP o FTP, pero se pueden registrar para controlar una solicitud a un servidor o una ruta de acceso específicos en un servidor.
El módulo de solicitud web se crea cuando se pasa un prefijo coincidente de URI al método WebRequest.Create.
El valor del atributo prefix
debe ser los caracteres iniciales de un URI válido. Por ejemplo, http
o http://www.contoso.com
.
El valor del atributo type
, que debe ser un nombre de tipo válido, y el nombre del ensamblado correspondiente, separados por una coma.
Archivos de configuración
Este elemento se puede usar en el archivo de configuración de la aplicación o en el archivo de configuración del equipo (Machine.config).
Ejemplo
En el ejemplo siguiente se registra un módulo de solicitud web personalizado para HTTP. Debe reemplazar los valores de Version y PublicKeyToken por los valores correctos del módulo especificado.
<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>