INFO: ASP.NET Configuration Overview

Seleccione idioma Seleccione idioma
Id. de artículo: 307626 - Ver los productos a los que se aplica este artículo
Este artículo se publicó anteriormente con el número E307626
En este artículo se refiere a la siguiente de Microsoft.NET Framework clase Espacio de nombres de biblioteca:
  • System.Configuration
Expandir todo | Contraer todo

En esta página

Resumen

Este artículo proporciona una introducción a la aplicación ASP.NET página marco de trabajo.

Para páginas ASP.NET, consulte el siguiente Artículo de Microsoft Knowledge Base:
305140 INFO: ASP.Guía básica de red

Más información

La configuración implica todo, desde la configuración de la aplicación como las conexiones de base de datos para obtener detalles de seguridad e información acerca de cómo deben ser manejados los errores. Los archivos de configuración proporcionan una ubicación para información específica del equipo y específica de la aplicación que se puede cambiar sin tener que compilar el código.

En este artículo se trata los temas de configuración siguientes:

Configuración: Novedades

En contraste con la configuración de la aplicación de páginas Active Server (ASP) que están almacena en el de Microsoft Internet Information Services Metabase (IIS), ASP.NET se almacena de marcado Extensible Archivos de lenguaje (XML). Esto proporciona las siguientes ventajas cuando se necesita cambiar opciones de configuración e implementar aplicaciones:
  • ASP.Los archivos de configuración de red se almacenan en la misma directorio que el contenido del sitio. En tiempo de implementación, sólo necesita copiar el directorio de contenido para obtener el contenido y la aplicación configuración.
  • Puede utilizar editores de texto estándar para modificar la configuración archivos. Así resulta más sencillo cambiar la configuración tanto localmente y de forma remota.
  • Los archivos de configuración son extensibles; como resultado, usted puede agregar sus propios valores de configuración personalizados.
  • El sistema detecta automáticamente los cambios realizados en ASP.NET archivos de configuración. No es necesario reiniciar IIS ni el servidor Web para la configuración surta efecto.

Formato de archivo y la jerarquía de configuración

Hay dos tipos de archivos de configuración con la que debería se trate de ASP.NET applications: Machine.config y Web.config. Ambos los archivos están basados en XML y contienen secciones de configuración similar. Sin embargo, el Archivo Machine.config contiene información de configuración de todos.NET las aplicaciones para una versión específica del marco, mientras que el archivo Web.config los archivos contienen los valores de configuración más granulares acerca de determinadas aplicaciones ASP.NET aplicaciones. Es el texto en el archivo Machine.config y Web.config distingue mayúsculas de minúsculas.

Para obtener más información acerca del formato de ASP.NET archivos de configuración, consulte el tema siguiente en el.NET Framework Documentación del Software Development Kit (SDK):
Formato de ASP.Archivos de configuración de red
http://msdn2.Microsoft.com/en-us/library/ackhksh7 (vs.71) .aspx
Cuando se realiza una solicitud para una página .aspx, los archivos de configuración se compilan de forma que un valor de configuración en un archivo Web.config que se almacena en un reemplazos de subdirectorio una configuración en un archivo Web.config de archivos en un directorio de aplicación, que suplanta la configuración en el nivel de sitio Web y configuración en el archivo Machine.config. Después de las opciones de configuración compila, se almacenan en caché para las futuras solicitudes hasta que uno de la configuración los archivos se modifica.

La tabla siguiente muestra la configuración de ejemplo ubicaciones de archivos para el http://myserver/myapplication/mydir/mypage.aspx DIRECCIÓN URL:

Contraer esta tablaAmpliar esta tabla
NivelRuta de acceso
Opciones de configuración para esta versión de la.NET Marco de trabajoWinnt\Microsoft.net\Framework\v.versión\CONFIG\Machine.config
Configuración del sitio WebInetpub\Wwwroot\Web.config
Aplicación ConfiguraciónInetpub\Wwwroot\Myapplication\Web.config
Subdirectorio ConfiguraciónInetpub\Wwwroot\Myapplication\Mydir\Web.config

Un archivo Web.config en cualquier nivel es opcional, pero un Falta el archivo Machine.config.

Para obtener más información acerca de jerarquía de configuración, consulte el tema siguiente en el.NET Framework SDK documentación:
Arquitectura de configuración jerárquica
http://msdn.Microsoft.com/en-us/library/aa720128 (v=vs.71) .aspx
Para aplicar la configuración a recursos específicos, utilice un <location></location> etiqueta con un atributo path adecuado. Puede utilizar la ruta de acceso atributo para identificar un archivo o directorio secundario específico al que único aplicarán valores de configuración.

Para obtener más información acerca de la <location></location> de etiquetas, consulte el tema siguiente en el.NET Framework SDK documentación:
Configuración <Location>configuración
</Location>http://msdn.Microsoft.com/en-us/library/6hbkh9s7 (v=vs.71) .aspx

ASP.Secciones de configuración de red

La aplicación de ASP.NET están contenidas en el <system.web></system.web> sección, que está contenida en el <configuration></configuration> etiqueta:
   <configuration>
      <appSettings></appSettings>
      <system.web>
         ...
         <webServices></webServices>
      </system.web>
   </configuration>
				
La tabla siguiente enumeran todas las aplicaciones ASP.Configuración de red secciones:

Contraer esta tablaAmpliar esta tabla
SecciónDescripción
<appSettings></appSettings>Configura configuración personalizada para una aplicación. Puede ser la configuración de esta sección en comparación con las variables de aplicación.
<authentication></authentication>Configura el modo de autenticación para determinar qué tipo de autenticación que se utilice.
<authorization></authorization>Configura autorización de apoyo y controla el acceso de cliente a los recursos de dirección URL.
<browserCaps></browserCaps>Configura la configuración del componente browser capabilities.
<compilation></compilation>Configura todas las opciones de compilación que ASP.NET utiliza.
<customErrors></customErrors>Proporciona información acerca de los mensajes de error personalizado para una aplicación ASP.NET existente.
<globalization></globalization>Configura la configuración de globalización de la aplicación.
<httpHandlers></httpHandlers>Mapas de solicitudes de URL entrantes a las clases IHttpHandler .
<httpModules></httpModules>Agrega, Quita o borra módulos HTTP dentro de una aplicación.
<httpRuntime></httpRuntime>Configura ASP.Configuración de tiempo de ejecución de NET HTTP.
<identity></identity>Controles la identidad de la aplicación Web.
<machineKey></machineKey>Configura teclas para utilizar para el cifrado y descifrado de datos de cookies de autenticación de formularios. En esta sección le permite configurar una clave de validación que realiza el mensaje la autenticación comprueba en los datos de estado de vista y vales de autenticación de formularios.
<pages></pages>Identifica Opciones de configuración de la específica de la página.
<processModel></processModel>Configura la aplicación de ASP.Configuración del modelo de proceso neto en los sistemas de servidor Web de IIS. Tenga en cuenta que se puede sólo puede utilizar esta etiqueta en el archivo Machine.config.
<securityPolicy></securityPolicy>Define asignaciones válidas de niveles de seguridad con nombre a archivos de directivas.
<sessionState></sessionState>Configura el módulo de estado de sesión.
<trace></trace>Configura la aplicación de ASP.Servicio NET trace.
<trust></trust>Configura el conjunto de permisos de seguridad de acceso a código que se utiliza para ejecutar una determinada aplicación.
<webServices></webServices>Controles la configuración de ASP.NET Web Services.

Recuperando información de configuración

Puede recuperar la información que se almacena en la configuración archivo, pero los métodos varían para los valores de configuración diferente. Algunos valores se exponen como propiedades de los objetos intrínsecos y otros valores son inaccesibles porque son valores internos de ASP.NET.

Por ejemplo, puede utilizar lo siguiente código de acceso a la <browserCaps></browserCaps> configuración mediante el objeto Request.Browser :

Microsoft Visual Basic.NET
Response.Write(Request.Browser.VBScript.ToString())
				
Microsoft Visual C#.NET
Response.Write(Request.Browser.VBScript.ToString());
				
Para obtener más información acerca de cómo recuperar valores de configuración, consulte el tema siguiente en el.Documentación de NET Framework SDK:
Acceso a los valores de configuración
http://msdn.Microsoft.com/en-us/library/4c2kcht0.aspx

Ampliación de la sección de configuración

El.NET Framework es totalmente extensible. Hay dos formas en que puede ampliar configuración:
  • Crear un controlador de sección de configuración personalizado.

    Para adicional información acerca de cómo crear controles de servidor ASP.Controladores de sección de configuración de red Haga clic en el número de artículo siguiente para verlo en Microsoft Knowledge Base:
    309045 Cómo: Crear un servidor de ASP.Controlador de sección de configuración NET en Visual C#.NET
  • Uso del <appSettings></appSettings> sección para almacenar datos específicos de aplicación. Para obtener información sobre la sintaxis de la <appSettings></appSettings> la sección, consulte el tema siguiente en el.NET Framework SDK documentación:
    http://msdn.Microsoft.com/en-us/library/aa903313 (v=vs.71) .aspx
    Para recuperar los valores de la <appSettings></appSettings> la sección, utilice el siguiente código en el archivo. config:
            <appSettings>
    		<add key="MySetting" value="Valuable Information" />
            </appSettings>
    						
    A continuación, utilice el siguiente código para recuperar el valor:

    Nota: debe incluir el espacio de nombres System.Configuration para tener acceso a appSettings.

    Visual Basic .NET
        Label1.Text = ConfigurationSettings.AppSettings.Item("MySetting")
    					
    Visual C#.NET
        Label1.Text = ConfigurationSettings.AppSettings["MySetting"];
    					

Propiedades

Id. de artículo: 307626 - Última revisión: miércoles, 20 de junio de 2012 - Versión: 1.0
La información de este artículo se refiere a:
  • Microsoft ASP.NET 1.0
  • Microsoft ASP.NET 1.1
Palabras clave: 
kbproductlink kbarttyperoadmap kbconfig kbinfo kbweb kbmt KB307626 KbMtes
Traducción automática
IMPORTANTE: Este artículo ha sido traducido por un software de traducción automática de Microsoft (http://support.microsoft.com/gp/mtdetails) en lugar de un traductor humano. Microsoft le ofrece artículos traducidos por un traductor humano y artículos traducidos automáticamente para que tenga acceso en su propio idioma a todos los artículos de nuestra base de conocimientos (Knowledge Base). Sin embargo, los artículos traducidos automáticamente pueden contener errores en el vocabulario, la sintaxis o la gramática, como los que un extranjero podría cometer al hablar el idioma. Microsoft no se hace responsable de cualquier imprecisión, error o daño ocasionado por una mala traducción del contenido o como consecuencia de su utilización por nuestros clientes. Microsoft suele actualizar el software de traducción frecuentemente.
Haga clic aquí para ver el artículo original (en inglés): 307626

Enviar comentarios

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com