Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase ConfigurationErrorsException

 

Publicado: octubre de 2016

La excepción que se produce cuando se ha producido un error de configuración.

Espacio de nombres:   System.Configuration
Ensamblado:  System.Configuration (en System.Configuration.dll)

System.Object
  System.Exception
    System.SystemException
      System.Configuration.ConfigurationException
        System.Configuration.ConfigurationErrorsException

[SerializableAttribute]
public class ConfigurationErrorsException : ConfigurationException

NombreDescripción
System_CAPS_pubmethodConfigurationErrorsException()

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Inicializa una nueva instancia de la clase ConfigurationErrorsException.

System_CAPS_protmethodConfigurationErrorsException(SerializationInfo, StreamingContext)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Inicializa una nueva instancia de la clase ConfigurationErrorsException.

System_CAPS_pubmethodConfigurationErrorsException(String)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Inicializa una nueva instancia de la clase ConfigurationErrorsException.

System_CAPS_pubmethodConfigurationErrorsException(String, Exception)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Inicializa una nueva instancia de la clase ConfigurationErrorsException.

System_CAPS_pubmethodConfigurationErrorsException(String, Exception, String, Int32)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Inicializa una nueva instancia de una clase ConfigurationErrorsException.

System_CAPS_pubmethodConfigurationErrorsException(String, Exception, XmlNode)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Inicializa una nueva instancia de la clase ConfigurationErrorsException.

System_CAPS_pubmethodConfigurationErrorsException(String, Exception, XmlReader)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Inicializa una nueva instancia de la clase ConfigurationErrorsException.

System_CAPS_pubmethodConfigurationErrorsException(String, String, Int32)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Inicializa una nueva instancia de la clase ConfigurationErrorsException.

System_CAPS_pubmethodConfigurationErrorsException(String, XmlNode)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Inicializa una nueva instancia de la clase ConfigurationErrorsException.

System_CAPS_pubmethodConfigurationErrorsException(String, XmlReader)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Inicializa una nueva instancia de la clase ConfigurationErrorsException.

NombreDescripción
System_CAPS_pubpropertyBareMessage

Obtiene una descripción de por qué se produjo esta excepción de configuración.(Invalida ConfigurationException.BareMessage).

System_CAPS_pubpropertyData

Obtiene una colección de pares clave-valor que proporcionan más información definida por el usuario sobre la excepción.(Heredado de Exception).

System_CAPS_pubpropertyErrors

Obtiene una colección de errores que detallan las razones de este ConfigurationErrorsException de excepción.

System_CAPS_pubpropertyFilename

Obtiene la ruta de acceso al archivo de configuración que causó esta excepción de configuración.(Invalida ConfigurationException.Filename).

System_CAPS_pubpropertyHelpLink

Obtiene o establece un vínculo al archivo de ayuda asociado a esta excepción.(Heredado de Exception).

System_CAPS_pubpropertyHResult

Obtiene o establece HRESULT, un valor numérico codificado que se asigna a una excepción específica.(Heredado de Exception).

System_CAPS_pubpropertyInnerException

Obtiene la instancia Exception que produjo la excepción actual.(Heredado de Exception).

System_CAPS_pubpropertyLine

Obtiene el número de línea del archivo de configuración en el que se produjo esta excepción de configuración.(Invalida ConfigurationException.Line).

System_CAPS_pubpropertyMessage

Obtiene una descripción extensa de por qué se produjo esta excepción de configuración.(Invalida ConfigurationException.Message).

System_CAPS_pubpropertySource

Devuelve o establece el nombre de la aplicación o del objeto que generó el error.(Heredado de Exception).

System_CAPS_pubpropertyStackTrace

Obtiene una representación de cadena de los marcos inmediatos en la pila de llamadas.(Heredado de Exception).

System_CAPS_pubpropertyTargetSite

Obtiene el método que produjo la excepción actual.(Heredado de Exception).

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodGetBaseException()

Cuando se invalida en una clase derivada, devuelve la clase Exception que representa la causa principal de una o más excepciones posteriores.(Heredado de Exception).

System_CAPS_pubmethodSystem_CAPS_staticGetFilename(XmlNode)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene la ruta de acceso al archivo de configuración desde el que interna XmlNode se cargó el objeto cuando se produce esta excepción de configuración.

System_CAPS_pubmethodSystem_CAPS_staticGetFilename(XmlReader)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene la ruta de acceso al archivo de configuración que interna XmlReader estaba leyendo al producirse esta excepción de configuración.

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodSystem_CAPS_staticGetLineNumber(XmlNode)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene el número de línea del archivo de configuración que interna XmlNode objeto representado cuando se produce esta excepción de configuración.

System_CAPS_pubmethodSystem_CAPS_staticGetLineNumber(XmlReader)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Obtiene el número de línea del archivo de configuración que interna XmlReader objeto estaba procesando cuando se produce esta excepción de configuración.

System_CAPS_pubmethodGetObjectData(SerializationInfo, StreamingContext)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Establece la SerializationInfo objeto con el archivo nombre y número de línea en que se produjo esta excepción de configuración.(Invalida ConfigurationException.GetObjectData(SerializationInfo, StreamingContext)).

System_CAPS_pubmethodGetType()

Obtiene el tipo en tiempo de ejecución de la instancia actual.(Heredado de Exception).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodToString()

Crea y devuelve una representación de cadena de la excepción actual.(Heredado de Exception).

NombreDescripción
System_CAPS_proteventSerializeObjectState

Ocurre cuando una excepción se serializa para crear un objeto de estado de excepción que contenga datos serializados sobre la excepción.(Heredado de Exception).

El ConfigurationErrorsException excepción se produce cuando se produce un error mientras la información de configuración se leen o escriben.

En el ejemplo de código siguiente se crea una sección personalizada y genera un ConfigurationErrorsException excepción cuando se modifican sus propiedades.

using System;
using System.Configuration;
using System.Collections.Specialized;
using System.Collections;

namespace Samples.AspNet
{

    // Define a custom section.
    public sealed class CustomSection :
       ConfigurationSection
    {
        public CustomSection()
        {
        }

        [ConfigurationProperty("fileName", DefaultValue = "default.txt",
                    IsRequired = true, IsKey = false)]
        [StringValidator(InvalidCharacters = " ~!@#$%^&*()[]{}/;'\"|\\",
            MinLength = 1, MaxLength = 60)]
        public string FileName
        {
            get
            {
                return (string)this["fileName"];
            }
            set
            {
                this["fileName"] = value;
            }
        }

        [ConfigurationProperty("maxUsers", DefaultValue = (long)10,
            IsRequired = false)]
        [LongValidator(MinValue = 1, MaxValue = 100,
            ExcludeRange = false)]
        public long MaxUsers
        {
            get
            {
                return (long)this["maxUsers"];
            }
            set
            {
                this["maxUsers"] = value;
            }
        }

    }


    // Create the custom section and write it to
    // the configuration file.
    class UsingConfigurationErrorsException
    {
        // Create a custom section.
        static UsingConfigurationErrorsException()
        {
            // Get the application configuration file.
            System.Configuration.Configuration config =
                    ConfigurationManager.OpenExeConfiguration(
                    ConfigurationUserLevel.None);

            // If the section does not exist in the configuration
            // file, create it and save it to the file.
            if (config.Sections["CustomSection"] == null)
            {
                CustomSection custSection = new CustomSection();
                config.Sections.Add("CustomSection", custSection);
                custSection =
                    config.GetSection("CustomSection") as CustomSection;
                custSection.SectionInformation.ForceSave = true;
                config.Save(ConfigurationSaveMode.Full);
            }
        }

        // Modify a custom section and cause configuration 
        // error exceptions.
        static void ModifyCustomSection()
        {

            try
            {
                // Get the application configuration file.
                System.Configuration.Configuration config =
                        ConfigurationManager.OpenExeConfiguration(
                        ConfigurationUserLevel.None);

                CustomSection custSection =
                   config.Sections["CustomSection"] as CustomSection;

                // Change the section properties.
                custSection.FileName = "newName.txt";

                // Cause an exception.
                custSection.MaxUsers = custSection.MaxUsers + 100;

                if (!custSection.ElementInformation.IsLocked)
                    config.Save();
                else
                    Console.WriteLine(
                        "Section was locked, could not update.");
            }
            catch (ConfigurationErrorsException err)
            {

                string msg = err.Message;
                Console.WriteLine("Message: {0}", msg);

                string fileName = err.Filename;
                Console.WriteLine("Filename: {0}", fileName);

                int lineNumber = err.Line;
                Console.WriteLine("Line: {0}", lineNumber.ToString());

                string bmsg = err.BareMessage;
                Console.WriteLine("BareMessage: {0}", bmsg);

                string source = err.Source;
                Console.WriteLine("Source: {0}", source);

                string st = err.StackTrace;
                Console.WriteLine("StackTrace: {0}", st);

            }
        }

        static void Main(string[] args)
        {
            ModifyCustomSection();
        }


    }
}

El ejemplo siguiente es un fragmento de la configuración utilizada en el ejemplo anterior.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <configSections>
    <section name="CustomSection" type="Samples.AspNet.CustomSection, 
      ConfigurationErrorsException, Version=1.0.0.0, Culture=neutral, 
      PublicKeyToken=null" allowDefinition="Everywhere" 
      allowExeDefinition="MachineToApplication" 
      restartOnExternalChanges="true" />
  </configSections>
  <CustomSection fileName="default.txt" maxUsers="10" />
</configuration>

.NET Framework
Disponible desde 2.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: