SectionInformation.ConfigSource Propiedad

Definición

Obtiene o establece el nombre del archivo de inclusión en el que se define la sección de configuración asociada, si existe tal archivo.

public:
 property System::String ^ ConfigSource { System::String ^ get(); void set(System::String ^ value); };
public string ConfigSource { get; set; }
member this.ConfigSource : string with get, set
Public Property ConfigSource As String

Valor de propiedad

Nombre del archivo de inclusión en el que se define el objeto ConfigurationSection asociado, si existe tal archivo; de lo contrario, se trata de una cadena vacía ("").

Comentarios

La ConfigSource propiedad representa el valor del configSource atributo especificado para un ConfigurationSection objeto asociado al SectionInformation objeto .

Opcionalmente, una ConfigurationSection implementación puede especificar un archivo independiente en el que se definen los valores de configuración de esa sección. Esto puede ser útil de varias maneras:

  • El uso de archivos de inclusión puede dar lugar a una estructura más lógica y modular para los archivos de configuración.

  • La seguridad y los permisos de acceso a archivos se pueden usar para restringir el acceso a secciones de opciones de configuración.

  • La configuración de un archivo de inclusión que no se usa durante la inicialización de la aplicación se puede modificar y volver a cargar sin necesidad de reiniciar la aplicación.

En el ejemplo siguiente se muestra cómo se usa este atributo en un archivo de configuración para especificar que la pages sección se define en un archivo de inclusión externo:

<pages configSource="pages.config"/>

Si alguna de las opciones de un archivo de inclusión de configuración requiere que la aplicación se reinicie cuando se modifiquen, establezca la RestartOnExternalChanges propiedad trueen .

En ASP.NET aplicaciones, en tiempo de ejecución puede asignar a la propiedad el ConfigSource nombre de un archivo de configuración alternativo. En ese caso, el contenido del archivo se sobrescribe mediante la información de cadena de conexión predeterminada contenida en el archivo Web.config. Esto ocurre también cuando el archivo alternativo no existe y se crea en tiempo de ejecución. Si el archivo Web.config no contiene ninguna información de cadena de conexión, se agrega una sección vacía al archivo alternativo.

Se aplica a

Consulte también