ConfigurationErrorsException Classe

Definizione

Spazio dei nomi:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacchetto:

System.Configuration.ConfigurationManager v8.0.0

Origine:

ConfigurationErrorsException.cs

Eccezione generata quando si verifica un errore di configurazione.

C#

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

Ereditarietà

Object

Exception

SystemException

ConfigurationException

ConfigurationErrorsException

Attributi

SerializableAttribute

Esempio

Nell'esempio di codice seguente viene creata una sezione personalizzata e viene generata un'eccezione ConfigurationErrorsException quando modifica le proprietà.

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'esempio seguente è un estratto di configurazione usato dall'esempio precedente.

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>  

Commenti

L'eccezione ConfigurationErrorsException viene generata quando si verifica un errore durante la lettura o la scrittura delle informazioni di configurazione.

Costruttori

ConfigurationErrorsException()	Inizializza una nuova istanza della classe ConfigurationErrorsException.
ConfigurationErrorsException(SerializationInfo, StreamingContext)	Obsoleti. Inizializza una nuova istanza della classe ConfigurationErrorsException.
ConfigurationErrorsException(String)	Inizializza una nuova istanza della classe ConfigurationErrorsException.
ConfigurationErrorsException(String, Exception)	Inizializza una nuova istanza della classe ConfigurationErrorsException.
ConfigurationErrorsException(String, Exception, String, Int32)	Inizializza una nuova istanza della classe ConfigurationErrorsException.
ConfigurationErrorsException(String, Exception, XmlNode)	Inizializza una nuova istanza della classe ConfigurationErrorsException.
ConfigurationErrorsException(String, Exception, XmlReader)	Inizializza una nuova istanza della classe ConfigurationErrorsException.
ConfigurationErrorsException(String, String, Int32)	Inizializza una nuova istanza della classe ConfigurationErrorsException.
ConfigurationErrorsException(String, XmlNode)	Inizializza una nuova istanza della classe ConfigurationErrorsException.
ConfigurationErrorsException(String, XmlReader)	Inizializza una nuova istanza della classe ConfigurationErrorsException.

Proprietà

BareMessage	Ottiene una descrizione del motivo della generazione di questa eccezione di configurazione. (Ereditato da ConfigurationException)
Data	Ottiene una raccolta di coppie chiave/valore che forniscono informazioni definite dall'utente aggiuntive sull'eccezione. (Ereditato da Exception)
Errors	Ottiene un insieme di errori in cui vengono illustrati i motivi della generazione di questa eccezione ConfigurationErrorsException.
Filename	Ottiene il percorso del file di configurazione che ha causato la generazione di questa eccezione di configurazione.
HelpLink	Ottiene o imposta un collegamento al file della Guida associato all'eccezione. (Ereditato da Exception)
HResult	Ottiene o imposta HRESULT, un valore numerico codificato che viene assegnato a un'eccezione specifica. (Ereditato da Exception)
InnerException	Ottiene l'istanza di Exception che ha causato l'eccezione corrente. (Ereditato da Exception)
Line	Ottiene il numero di riga del file di configurazione in corrispondenza del quale è stata generata questa eccezione di configurazione.
Message	Ottiene una descrizione dettagliata del motivo della generazione di questa eccezione di configurazione.
Source	Ottiene o imposta il nome dell'oggetto o dell'applicazione che ha generato l'errore. (Ereditato da Exception)
StackTrace	Ottiene una rappresentazione di stringa dei frame immediati nello stack di chiamate. (Ereditato da Exception)
TargetSite	Ottiene il metodo che genera l'eccezione corrente. (Ereditato da Exception)

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetBaseException()	Quando ne viene eseguito l'override in una classe derivata, restituisce l'Exception che è la causa radice di una o più eccezioni successive. (Ereditato da Exception)
GetFilename(XmlNode)	Ottiene il percorso del file di configurazione da cui è stato caricato l'oggetto XmlNode interno quando è stata generata questa eccezione di configurazione.
GetFilename(XmlReader)	Ottiene il percorso del file di configurazione letto dall'oggetto XmlReader interno quando è stata generata questa eccezione di configurazione.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLineNumber(XmlNode)	Ottiene il numero di riga del file di configurazione rappresentato dall'oggetto XmlNode interno quando è stata generata questa eccezione di configurazione.
GetLineNumber(XmlReader)	Ottiene il numero di riga del file di configurazione elaborato dall'oggetto XmlReader interno quando è stata generata questa eccezione di configurazione.
GetObjectData(SerializationInfo, StreamingContext)	Obsoleti. Imposta l'oggetto SerializationInfo con il nome file e il numero di riga in corrispondenza del quale si è verificata questa eccezione di configurazione.
GetType()	Ottiene il tipo di runtime dell'istanza corrente. (Ereditato da Exception)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Crea e restituisce una rappresentazione di stringa dell'eccezione corrente. (Ereditato da Exception)

Eventi

SerializeObjectState

Si verifica quando un'eccezione viene serializzata per creare un oggetto di stato eccezione contenente i dati serializzati relativi all'eccezione. (Ereditato da Exception)

Si applica a