ConfigurationErrorsException Classe
TOC
Réduire la table des matières
Développer la table des matières
Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

ConfigurationErrorsException, classe

 

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

Espace de noms:   System.Configuration
Assembly:  System.Configuration (dans System.Configuration.dll)

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

[SerializableAttribute]
public class ConfigurationErrorsException : ConfigurationException

NomDescription
System_CAPS_pubmethodConfigurationErrorsException()

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Initialise une nouvelle instance de la classe ConfigurationErrorsException.

System_CAPS_protmethodConfigurationErrorsException(SerializationInfo, StreamingContext)

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Initialise une nouvelle instance de la classe ConfigurationErrorsException.

System_CAPS_pubmethodConfigurationErrorsException(String)

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Initialise une nouvelle instance de la classe ConfigurationErrorsException.

System_CAPS_pubmethodConfigurationErrorsException(String, Exception)

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Initialise une nouvelle instance de la classe ConfigurationErrorsException.

System_CAPS_pubmethodConfigurationErrorsException(String, Exception, String, Int32)

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Initialise une nouvelle instance d'une classe ConfigurationErrorsException.

System_CAPS_pubmethodConfigurationErrorsException(String, Exception, XmlNode)

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Initialise une nouvelle instance de la classe ConfigurationErrorsException.

System_CAPS_pubmethodConfigurationErrorsException(String, Exception, XmlReader)

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Initialise une nouvelle instance de la classe ConfigurationErrorsException.

System_CAPS_pubmethodConfigurationErrorsException(String, String, Int32)

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Initialise une nouvelle instance de la classe ConfigurationErrorsException.

System_CAPS_pubmethodConfigurationErrorsException(String, XmlNode)

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Initialise une nouvelle instance de la classe ConfigurationErrorsException.

System_CAPS_pubmethodConfigurationErrorsException(String, XmlReader)

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Initialise une nouvelle instance de la classe ConfigurationErrorsException.

NomDescription
System_CAPS_pubpropertyBareMessage

Obtient une description expliquant pourquoi cette exception de configuration a été levée.(Remplace ConfigurationException.BareMessage.)

System_CAPS_pubpropertyData

Obtient une collection de paires clé/valeur qui fournissent des informations supplémentaires définies par l'utilisateur sur l'exception.(Hérité de Exception.)

System_CAPS_pubpropertyErrors

Obtient une collection d'erreurs qui détaillent les raisons pour lesquelles cela ConfigurationErrorsException exception a été levée.

System_CAPS_pubpropertyFilename

Obtient le chemin d'accès au fichier de configuration qui a provoqué la levée de cette exception.(Remplace ConfigurationException.Filename.)

System_CAPS_pubpropertyHelpLink

Obtient ou définit un lien vers le fichier d'aide associé à cette exception.(Hérité de Exception.)

System_CAPS_pubpropertyHResult

Obtient ou définit HRESULT, valeur numérique codée qui est assignée à une exception spécifique.(Hérité de Exception.)

System_CAPS_pubpropertyInnerException

Obtient l'instance Exception qui a provoqué l'exception actuelle.(Hérité de Exception.)

System_CAPS_pubpropertyLine

Obtient le numéro de ligne dans le fichier de configuration dans laquelle cette exception de configuration a été levée.(Remplace ConfigurationException.Line.)

System_CAPS_pubpropertyMessage

Obtient une description détaillée expliquant pourquoi cette exception de configuration a été levée.(Remplace ConfigurationException.Message.)

System_CAPS_pubpropertySource

Obtient ou définit le nom de l'application ou de l'objet qui est à l'origine de l'erreur.(Hérité de Exception.)

System_CAPS_pubpropertyStackTrace

Obtient une représentation sous forme de chaîne des objets immédiats sur la pile des appels. (Hérité de Exception.)

System_CAPS_pubpropertyTargetSite

Obtient la méthode qui lève l'exception actuelle.(Hérité de Exception.)

NomDescription
System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodGetBaseException()

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.)

System_CAPS_pubmethodSystem_CAPS_staticGetFilename(XmlNode)

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Obtient le chemin d'accès au fichier de configuration à partir de laquelle interne XmlNode objet a été chargé lorsque cette exception de configuration a été levée.

System_CAPS_pubmethodSystem_CAPS_staticGetFilename(XmlReader)

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Obtient le chemin d'accès au fichier de configuration qui interne XmlReader lisait lorsque cette exception de configuration a été levée.

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodSystem_CAPS_staticGetLineNumber(XmlNode)

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Obtient le numéro de ligne dans le fichier de configuration qui interne XmlNode objet représenté lorsque cette exception de configuration a été levée.

System_CAPS_pubmethodSystem_CAPS_staticGetLineNumber(XmlReader)

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Obtient le numéro de ligne dans le fichier de configuration qui interne XmlReader objet traitait lorsque cette exception de configuration a été levée.

System_CAPS_pubmethodGetObjectData(SerializationInfo, StreamingContext)

Cette API prend en charge l'infrastructure produit et n'est pas destinée à être utilisée directement à partir de votre code. Définit le SerializationInfo objet avec le fichier nom et numéro de ligne à laquelle cette exception de configuration s'est produite.(Remplace ConfigurationException.GetObjectData(SerializationInfo, StreamingContext).)

System_CAPS_pubmethodGetType()

Obtient le type au moment de l'exécution de l'instance actuelle.(Hérité de Exception.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_pubmethodToString()

Crée et retourne une chaîne représentant l'exception actuelle.(Hérité de Exception.)

NomDescription
System_CAPS_proteventSerializeObjectState

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.)

Le ConfigurationErrorsException exception est levée lorsqu'une erreur se produit pendant que les informations de configuration sont lues ou écrites.

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.

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 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 depuis 2.0

Tous les membres statiques (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Retour au début
Afficher:
© 2016 Microsoft