ConfigurationErrorsException Classe

Définition

Espace de noms:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paquet:

System.Configuration.ConfigurationManager v8.0.0

Source:

ConfigurationErrorsException.cs

Exception levée lorsqu'une erreur de configuration s'est produite.

C#

[System.Serializable]
public class ConfigurationErrorsException : System.Configuration.ConfigurationException

Héritage

Object

Exception

SystemException

ConfigurationException

ConfigurationErrorsException

Attributs

SerializableAttribute

Exemples

L’exemple de code suivant crée une section personnalisée et génère une ConfigurationErrorsException exception lorsqu’elle modifie ses propriétés.

C#

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();
        }
    }
}

L’exemple suivant est un extrait de configuration utilisé par l’exemple précédent.

XML

<?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>  

Remarques

L’exception ConfigurationErrorsException est levée lorsqu’une erreur se produit pendant la lecture ou l’écriture des informations de configuration.

Constructeurs

ConfigurationErrorsException()	Initialise une nouvelle instance de la classe ConfigurationErrorsException.
ConfigurationErrorsException(SerializationInfo, StreamingContext)	Obsolète. Initialise une nouvelle instance de la classe ConfigurationErrorsException.
ConfigurationErrorsException(String)	Initialise une nouvelle instance de la classe ConfigurationErrorsException.
ConfigurationErrorsException(String, Exception)	Initialise une nouvelle instance de la classe ConfigurationErrorsException.
ConfigurationErrorsException(String, Exception, String, Int32)	Initialise une nouvelle instance de la classe ConfigurationErrorsException.
ConfigurationErrorsException(String, Exception, XmlNode)	Initialise une nouvelle instance de la classe ConfigurationErrorsException.
ConfigurationErrorsException(String, Exception, XmlReader)	Initialise une nouvelle instance de la classe ConfigurationErrorsException.
ConfigurationErrorsException(String, String, Int32)	Initialise une nouvelle instance de la classe ConfigurationErrorsException.
ConfigurationErrorsException(String, XmlNode)	Initialise une nouvelle instance de la classe ConfigurationErrorsException.
ConfigurationErrorsException(String, XmlReader)	Initialise une nouvelle instance de la classe ConfigurationErrorsException.

Propriétés

BareMessage	Obtient une description expliquant pourquoi cette exception de configuration a été levée. (Hérité de ConfigurationException)
Data	Obtient une collection de paires clé/valeur qui fournissent des informations définies par l'utilisateur supplémentaires sur l'exception. (Hérité de Exception)
Errors	Obtient une collection d'erreurs qui détaillent les raisons pour lesquelles cette exception ConfigurationErrorsException a été levée.
Filename	Obtient le chemin d'accès au fichier de configuration qui a provoqué la levée de cette exception.
HelpLink	Obtient ou définit un lien vers le fichier d'aide associé à cette exception. (Hérité de Exception)
HResult	Obtient ou définit HRESULT, valeur numérique codée qui est assignée à une exception spécifique. (Hérité de Exception)
InnerException	Obtient l'instance Exception qui a provoqué l'exception actuelle. (Hérité de Exception)
Line	Obtient le numéro de la ligne du fichier de configuration dans laquelle cette exception de configuration a été levée.
Message	Obtient une description détaillée expliquant pourquoi cette exception de configuration a été levée.
Source	Obtient ou définit le nom de l'application ou de l'objet qui est à l'origine de l'erreur. (Hérité de Exception)
StackTrace	Obtient une représentation sous forme de chaîne des frames immédiats sur la pile des appels. (Hérité de Exception)
TargetSite	Obtient la méthode qui lève l'exception actuelle. (Hérité de Exception)

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetBaseException()	En cas de substitution dans une classe dérivée, retourne la Exception qui est à l'origine d'une ou de plusieurs exceptions ultérieures. (Hérité de Exception)
GetFilename(XmlNode)	Obtient le chemin d'accès du fichier de configuration à partir duquel l'objet XmlNode interne a été chargé lorsque cette exception de configuration a été levée.
GetFilename(XmlReader)	Obtient le chemin d'accès au fichier de configuration que le XmlReader interne lisait lorsque cette exception de configuration a été levée.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetLineNumber(XmlNode)	Obtient le numéro de ligne du fichier de configuration que l'objet XmlNode interne représentait lorsque cette exception de configuration a été levée.
GetLineNumber(XmlReader)	Obtient le numéro de ligne du fichier de configuration que l'objet XmlReader interne traitait lorsque cette exception de configuration a été levée.
GetObjectData(SerializationInfo, StreamingContext)	Obsolète. Définit l'objet SerializationInfo avec le nom de fichier et le numéro de ligne au niveau desquels cette exception de configuration s'est produite.
GetType()	Obtient le type au moment de l'exécution de l'instance actuelle. (Hérité de Exception)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Crée et retourne une chaîne représentant l'exception actuelle. (Hérité de Exception)

Événements

SerializeObjectState

Se produit quand une exception est sérialisée pour créer un objet d'état d'exception qui contient des données sérialisées concernant l'exception. (Hérité de Exception)

S’applique à