NameValueConfigurationCollection Classe

Definizione

Spazio dei nomi:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacchetto:

System.Configuration.ConfigurationManager v8.0.0

Source:

NameValueConfigurationCollection.cs

Contiene una raccolta di oggetti NameValueConfigurationElement. La classe non può essere ereditata.

public ref class NameValueConfigurationCollection sealed : System::Configuration::ConfigurationElementCollection

[System.Configuration.ConfigurationCollection(typeof(System.Configuration.NameValueConfigurationElement))]
public sealed class NameValueConfigurationCollection : System.Configuration.ConfigurationElementCollection

[<System.Configuration.ConfigurationCollection(typeof(System.Configuration.NameValueConfigurationElement))>]
type NameValueConfigurationCollection = class
    inherit ConfigurationElementCollection

Public NotInheritable Class NameValueConfigurationCollection
Inherits ConfigurationElementCollection

Ereditarietà

Object

ConfigurationElement

ConfigurationElementCollection

NameValueConfigurationCollection

Attributi

ConfigurationCollectionAttribute

Esempio

Nell'esempio di codice seguente viene illustrato come usare il NameValueConfigurationCollection tipo .

#region Using directives

using System;
using System.Configuration;
using System.Web.Configuration;
using System.Collections;
using System.Text;

#endregion

namespace Samples.AspNet
{
    class UsingNameValueConfigurationCollection
    {
        static void Main(string[] args)
        {
            try
            {
                // Set the path of the config file.
                // Make sure that you have a Web site on the
                // same server called TestConfig.
                string configPath = "/TestConfig";

                // Get the Web application configuration object.
                Configuration config =
                  WebConfigurationManager.OpenWebConfiguration(configPath);

                // Get the section related object.
                AnonymousIdentificationSection configSection =
                  (AnonymousIdentificationSection)config.GetSection
                  ("system.web/anonymousIdentification");

                // Display title and info.
                Console.WriteLine("Configuration Info");
                Console.WriteLine();

                // Display Config details.
                Console.WriteLine("File Path: {0}",
                  config.FilePath);
                Console.WriteLine("Section Path: {0}",
                  configSection.SectionInformation.Name);
                Console.WriteLine();

                // Create a NameValueConfigurationCollection object.
                NameValueConfigurationCollection myNameValConfigCollection =
                  new NameValueConfigurationCollection();

                foreach (PropertyInformation propertyItem in
                  configSection.ElementInformation.Properties)
                {
                    // Assign  domain name.
                    if (propertyItem.Name == "domain")
                        propertyItem.Value = "MyDomain";

                    if (propertyItem.Value != null)
                    {
                        // Enable SSL for cookie exchange.
                        if (propertyItem.Name == "cookieRequireSSL")
                            propertyItem.Value = true;

                        NameValueConfigurationElement nameValConfigElement =
                            new NameValueConfigurationElement
                                (propertyItem.Name.ToString(), propertyItem.Value.ToString());

                        // Add a NameValueConfigurationElement
                        // to the collection.
                        myNameValConfigCollection.Add(nameValConfigElement);
                    }
                }

                // Count property.
                Console.WriteLine("Collection Count: {0}",
                 myNameValConfigCollection.Count);

                // Item property.
                Console.WriteLine("Value of property 'enabled': {0}",
                 myNameValConfigCollection["enabled"].Value);

                // Display the contents of the collection.
                foreach (NameValueConfigurationElement configItem
                  in myNameValConfigCollection)
                {
                    Console.WriteLine();
                    Console.WriteLine("Configuration Details:");
                    Console.WriteLine("Name: {0}", configItem.Name);
                    Console.WriteLine("Value: {0}", configItem.Value);
                }

                // Assign the domain calue.
                configSection.Domain = myNameValConfigCollection["domain"].Value;
                // Assign the SSL required value.
                if (myNameValConfigCollection["cookieRequireSSL"].Value == "true")
                    configSection.CookieRequireSSL = true;

                // Remove domain from the collection.
                NameValueConfigurationElement myConfigElement =
                    myNameValConfigCollection["domain"];
                // Remove method.
                myNameValConfigCollection.Remove(myConfigElement);

                // Save changes to the configuration file.
                // This modifies the Web.config of the TestConfig site.
                config.Save(ConfigurationSaveMode.Minimal, true);

                // Clear the collection.
                myNameValConfigCollection.Clear();
            }

            catch (Exception e)
            {
                // Unknown error.
                Console.WriteLine(e.ToString());
            }

            // Display and wait.
            Console.ReadLine();
        }
    }
}

Imports System.Configuration
Imports System.Web
Imports System.Collections
Imports System.Text


Namespace Samples.AspNet
    Class UsingNameValueConfigurationCollection
        Public Shared Sub Main(ByVal args As String())
            Try
                ' Set the path of the config file. 
                ' Make sure that you have a Web site on the
                ' same server called TestConfig.
                Dim configPath As String = "/TestConfig"

                ' Get the Web application configuration object.
                Dim config As Configuration = _
                System.Web.Configuration.WebConfigurationManager.OpenWebConfiguration(configPath)

                ' Get the section related object.
                Dim configSection _
                As System.Web.Configuration.AnonymousIdentificationSection = _
                DirectCast(config.GetSection("system.web/anonymousIdentification"),  _
                System.Web.Configuration.AnonymousIdentificationSection)

                ' Display title and info.
                Console.WriteLine("Configuration Info")
                Console.WriteLine()

                ' Display Config details.
                Console.WriteLine("File Path: {0}", config.FilePath)
                Console.WriteLine("Section Path: {0}", configSection.SectionInformation.Name)
                Console.WriteLine()

                ' Create a NameValueConfigurationCollection object.
                Dim myNameValConfigCollection As New NameValueConfigurationCollection()

                For Each propertyItem As PropertyInformation In configSection.ElementInformation.Properties
                    ' Assign  domain name.
                    If propertyItem.Name = "domain" Then
                        propertyItem.Value = "MyDomain"
                    End If

                    If propertyItem.Value <> Nothing Then
                        ' Enable SSL for cookie exchange.
                        If propertyItem.Name = "cookieRequireSSL" Then
                            propertyItem.Value = True
                        End If

                        Dim nameValConfigElement As New NameValueConfigurationElement(propertyItem.Name.ToString(), propertyItem.Value.ToString())

                        ' Add a NameValueConfigurationElement
                        ' to the collection.

                        myNameValConfigCollection.Add(nameValConfigElement)
                    End If
                Next

                ' Count property.
                Console.WriteLine("Collection Count: {0}", myNameValConfigCollection.Count)

                ' Item property.
                Console.WriteLine("Value of property 'enabled': {0}", myNameValConfigCollection("enabled").Value)

                ' Display the contents of the collection.
                For Each configItem As NameValueConfigurationElement In myNameValConfigCollection
                    Console.WriteLine()
                    Console.WriteLine("Configuration Details:")
                    Console.WriteLine("Name: {0}", configItem.Name)
                    Console.WriteLine("Value: {0}", configItem.Value)
                Next

                ' Assign the domain calue.
                configSection.Domain = myNameValConfigCollection("domain").Value
                ' Assign the SSL required value.
                If myNameValConfigCollection("cookieRequireSSL").Value = "true" Then
                    configSection.CookieRequireSSL = True
                End If

                ' Remove domain from the collection.
                Dim myConfigElement As NameValueConfigurationElement = myNameValConfigCollection("domain")
                ' Remove method.
                myNameValConfigCollection.Remove(myConfigElement)

                ' Save changes to the configuration file.
                ' This modifies the Web.config of the TestConfig site.
                config.Save(ConfigurationSaveMode.Minimal, True)

                ' Clear the collection.
                myNameValConfigCollection.Clear()
            Catch e As Exception

                ' Unknown error.
                Console.WriteLine(e.ToString())
            End Try

            ' Display and wait.
            Console.ReadLine()
        End Sub
    End Class
End Namespace

Commenti

La NameValueConfigurationCollection classe consente di accedere a livello di codice a una raccolta di NameValueConfigurationElement oggetti.

Costruttori

NameValueConfigurationCollection()

Inizializza una nuova istanza della classe NameValueConfigurationCollection.

Proprietà

AddElementName	Ottiene o imposta il nome della classe ConfigurationElement da associare all'operazione di aggiunta nella classe ConfigurationElementCollection quando viene sottoposto a override in un classe derivata. (Ereditato da ConfigurationElementCollection)
AllKeys	Ottiene le chiavi per tutti gli elementi contenuti nella classe NameValueConfigurationCollection.
ClearElementName	Ottiene o imposta il nome della classe ConfigurationElement da associare all'operazione di cancellazione nella classe ConfigurationElementCollection quando viene sottoposto a override in un classe derivata. (Ereditato da ConfigurationElementCollection)
CollectionType	Ottiene il tipo di ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
Count	Ottiene il numero di elementi nella raccolta. (Ereditato da ConfigurationElementCollection)
CurrentConfiguration	Ottiene un riferimento all'istanza di Configuration di livello superiore che rappresenta la gerarchia di configurazione cui appartiene l'istanza corrente di ConfigurationElement. (Ereditato da ConfigurationElement)
ElementInformation	Ottiene un oggetto ElementInformation contenente le funzionalità e le informazioni non personalizzabili dell'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
ElementName	Ottiene il nome utilizzato per identificare questo insieme di elementi nel file di configurazione quando è sottoposto a override in un classe derivata. (Ereditato da ConfigurationElementCollection)
ElementProperty	Ottiene l'oggetto ConfigurationElementProperty che rappresenta l'oggetto ConfigurationElement stesso. (Ereditato da ConfigurationElement)
EmitClear	Ottiene o imposta un valore che specifica se l'insieme è stato cancellato. (Ereditato da ConfigurationElementCollection)
EvaluationContext	Ottiene l'oggetto ContextInformation per l'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
HasContext	Ottiene un valore che indica se la proprietà CurrentConfiguration è null. (Ereditato da ConfigurationElement)
IsSynchronized	Ottiene un valore che indica se l'accesso alla raccolta è sincronizzato. (Ereditato da ConfigurationElementCollection)
Item[ConfigurationProperty]	Ottiene o imposta una proprietà o un attributo di questo elemento di configurazione. (Ereditato da ConfigurationElement)
Item[String]	Ottiene o imposta l'oggetto NameValueConfigurationElement in base al parametro specificato.
LockAllAttributesExcept	Ottiene l'insieme di attributi bloccati. (Ereditato da ConfigurationElement)
LockAllElementsExcept	Ottiene l'insieme di elementi bloccati. (Ereditato da ConfigurationElement)
LockAttributes	Ottiene l'insieme di attributi bloccati. (Ereditato da ConfigurationElement)
LockElements	Ottiene l'insieme di elementi bloccati. (Ereditato da ConfigurationElement)
LockItem	Ottiene o imposta un valore che indica se l'elemento è bloccato. (Ereditato da ConfigurationElement)
Properties	Ottiene la raccolta di proprietà. (Ereditato da ConfigurationElement)
RemoveElementName	Ottiene o imposta il nome della classe ConfigurationElement da associare all'operazione di rimozione nella classe ConfigurationElementCollection quando viene sottoposto a override in un classe derivata. (Ereditato da ConfigurationElementCollection)
SyncRoot	Ottiene un oggetto utilizzato per sincronizzare l'accesso alla classe ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
ThrowOnDuplicate	Ottiene un valore che indica se il tentativo di aggiungere una classe ConfigurationElement duplicata alla classe ConfigurationElementCollection genererà un'eccezione. (Ereditato da ConfigurationElementCollection)

Metodi

Add(NameValueConfigurationElement)	Aggiunge un oggetto NameValueConfigurationElement alla raccolta.
BaseAdd(ConfigurationElement)	Aggiunge un elemento di configurazione a ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
BaseAdd(ConfigurationElement, Boolean)	Aggiunge un elemento di configurazione all'insieme di elementi di configurazione. (Ereditato da ConfigurationElementCollection)
BaseAdd(Int32, ConfigurationElement)	Aggiunge un elemento di configurazione all'insieme di elementi di configurazione. (Ereditato da ConfigurationElementCollection)
BaseClear()	Rimuove tutti gli oggetti dell'elemento di configurazione dall'insieme. (Ereditato da ConfigurationElementCollection)
BaseGet(Int32)	Ottiene l'elemento di configurazione in corrispondenza della posizione di indice specificata. (Ereditato da ConfigurationElementCollection)
BaseGet(Object)	Restituisce l'elemento di configurazione con la chiave specificata. (Ereditato da ConfigurationElementCollection)
BaseGetAllKeys()	Restituisce una matrice delle chiavi di tutti gli elementi di configurazione inclusi nella classe ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
BaseGetKey(Int32)	Ottiene la chiave per la classe ConfigurationElement in corrispondenza della posizione di indice specificata. (Ereditato da ConfigurationElementCollection)
BaseIndexOf(ConfigurationElement)	Indica l'indice della classe ConfigurationElement specificata. (Ereditato da ConfigurationElementCollection)
BaseIsRemoved(Object)	Indica se la classe ConfigurationElement con la chiave specificata è stata rimossa dalla classe ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
BaseRemove(Object)	Rimuove un oggetto ConfigurationElement dalla raccolta. (Ereditato da ConfigurationElementCollection)
BaseRemoveAt(Int32)	Rimuove la classe ConfigurationElement in corrispondenza della posizione di indice specificata. (Ereditato da ConfigurationElementCollection)
Clear()	Cancella la classe NameValueConfigurationCollection.
CopyTo(ConfigurationElement[], Int32)	Copia il contenuto della classe ConfigurationElementCollection in una matrice. (Ereditato da ConfigurationElementCollection)
CreateNewElement()	Quando è sottoposto a override in una classe derivata, crea un nuovo elemento ConfigurationElement. (Ereditato da ConfigurationElementCollection)
CreateNewElement(String)	Crea una nuova classe ConfigurationElement quando è sottoposto a override in una classe derivata. (Ereditato da ConfigurationElementCollection)
DeserializeElement(XmlReader, Boolean)	Legge il codice XML dal file di configurazione. (Ereditato da ConfigurationElement)
Equals(Object)	Confronta la classe ConfigurationElementCollection con l'oggetto specificato. (Ereditato da ConfigurationElementCollection)
GetElementKey(ConfigurationElement)	Ottiene la chiave per un elemento di configurazione specificato quando viene sottoposto a override in un classe derivata. (Ereditato da ConfigurationElementCollection)
GetEnumerator()	Ottiene un'interfaccia IEnumerator utilizzata per scorrere la classe ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
GetHashCode()	Ottiene un valore univoco che rappresenta l'istanza di ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
GetTransformedAssemblyString(String)	Restituisce la versione trasformata del nome di assembly specificato. (Ereditato da ConfigurationElement)
GetTransformedTypeString(String)	Restituisce la versione trasformata del nome del tipo specificato. (Ereditato da ConfigurationElement)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Init()	Ripristina lo stato iniziale dell'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
InitializeDefault()	Da utilizzare per inizializzare un insieme predefinito di valori per l'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
IsElementName(String)	Indica se la classe ConfigurationElement specificata esiste nella classe ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
IsElementRemovable(ConfigurationElement)	Indica se è possibile rimuovere l'oggetto ConfigurationElement da ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
IsModified()	Indica se questa classe ConfigurationElementCollection è stata modificata dall'ultimo salvataggio o caricamento durante l'override in una classe derivata. (Ereditato da ConfigurationElementCollection)
IsReadOnly()	Indica se l'oggetto ConfigurationElementCollection è in sola lettura. (Ereditato da ConfigurationElementCollection)
ListErrors(IList)	Aggiunge all'elenco passato gli errori di proprietà non valida di questo oggetto ConfigurationElement e di tutti i sottoelementi. (Ereditato da ConfigurationElement)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnDeserializeUnrecognizedAttribute(String, String)	Ottiene un valore che indica se viene incontrato un attributo sconosciuto durante la deserializzazione. (Ereditato da ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Fa generare un'eccezione al sistema di configurazione. (Ereditato da ConfigurationElementCollection)
OnRequiredPropertyNotFound(String)	Genera un'eccezione quando una proprietà obbligatoria non viene trovata. (Ereditato da ConfigurationElement)
PostDeserialize()	Da chiamare dopo la deserializzazione. (Ereditato da ConfigurationElement)
PreSerialize(XmlWriter)	Da chiamare prima della serializzazione. (Ereditato da ConfigurationElement)
Remove(NameValueConfigurationElement)	Rimuove un oggetto NameValueConfigurationElement dall'insieme in base al parametro specificato.
Remove(String)	Rimuove un oggetto NameValueConfigurationElement dall'insieme in base al parametro specificato.
Reset(ConfigurationElement)	Reimposta la classe ConfigurationElementCollection sullo stato non modificato quando viene sottoposta a override in una classe derivata. (Ereditato da ConfigurationElementCollection)
ResetModified()	Reimposta il valore della proprietà IsModified() su false quando viene sottoposto a override in una classe derivata. (Ereditato da ConfigurationElementCollection)
SerializeElement(XmlWriter, Boolean)	Scrive i dati di configurazione in un elemento XML del file di configurazione quando vengono sottoposti a override in una classe derivata. (Ereditato da ConfigurationElementCollection)
SerializeToXmlElement(XmlWriter, String)	Scrive i tag esterni di questo elemento di configurazione nel file di configurazione in caso di implementazione in una classe derivata. (Ereditato da ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Imposta una proprietà sul valore specificato. (Ereditato da ConfigurationElement)
SetReadOnly()	Imposta la proprietà IsReadOnly() per l'oggetto ConfigurationElementCollection e per tutti i sottoelementi. (Ereditato da ConfigurationElementCollection)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Inverte l'effetto di unione delle informazioni sulla configurazione da livelli diversi della gerarchia di configurazione. (Ereditato da ConfigurationElementCollection)

Implementazioni dell'interfaccia esplicita

ICollection.CopyTo(Array, Int32)

Copia ConfigurationElementCollection in una matrice. (Ereditato da ConfigurationElementCollection)

Metodi di estensione

Vedi anche

• NameValueConfigurationElement