ConnectionStringSettingsCollection Classe

Définition

Espace de noms:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paquet:

System.Configuration.ConfigurationManager v9.0.0-rc.2.24473.5

Source:

ConnectionStringSettingsCollection.cs

Contient une collection d’objets ConnectionStringSettings.

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

[System.Configuration.ConfigurationCollection(typeof(System.Configuration.ConnectionStringSettings))]
public sealed class ConnectionStringSettingsCollection : System.Configuration.ConfigurationElementCollection

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

Public NotInheritable Class ConnectionStringSettingsCollection
Inherits ConfigurationElementCollection

Héritage

Object

ConfigurationElement

ConfigurationElementCollection

ConnectionStringSettingsCollection

Attributs

ConfigurationCollectionAttribute

Exemples

L’exemple suivant montre comment accéder au ConnectionStringSettingsCollection.

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

    // Get the connectionStrings section.
    ConnectionStringsSection csSection =
        config.ConnectionStrings;

    for (int i = 0; i <
        ConfigurationManager.ConnectionStrings.Count; i++)
    {
        ConnectionStringSettings cs =
            csSection.ConnectionStrings[i];

        Console.WriteLine($"  Connection String: \"{cs.ConnectionString}\"");

        Console.WriteLine($"#{i}");
        Console.WriteLine($"  Name: {cs.Name}");

        Console.WriteLine($"  Provider Name: {cs.ProviderName}");
    }
}

Shared Sub ShowConnectionStrings() 

    ' Get the application configuration file.
    Dim config _
    As System.Configuration.Configuration = _
    ConfigurationManager.OpenExeConfiguration( _
    ConfigurationUserLevel.None)

    ' Get the conectionStrings section.
    Dim csSection _
    As ConnectionStringsSection = _
    config.ConnectionStrings
    
    For i As Integer = 0 To ConfigurationManager.ConnectionStrings.Count - 1
        Dim cs As ConnectionStringSettings = _
        csSection.ConnectionStrings(i)
        
        Console.WriteLine( _
        "  Connection String: ""{0}""", cs.ConnectionString)
        Console.WriteLine("#{0}", i)
        Console.WriteLine("  Name: {0}", cs.Name)
        
        Console.WriteLine( _
        "  Provider Name: {0}", cs.ProviderName)

    Next i

End Sub

Remarques

Un objet ConnectionStringSettingsCollection contient une collection d’objets ConnectionStringSettings. Chaque objet ConnectionStringSettings représente une entrée unique dans la section <connectionStrings> fichier de configuration.

Constructeurs

ConnectionStringSettingsCollection()

Initialise une nouvelle instance de la classe ConnectionStringSettingsCollection.

Propriétés

AddElementName	Obtient ou définit le nom de l'ConfigurationElement à associer à l’opération d’ajout dans le ConfigurationElementCollection en cas de substitution dans une classe dérivée. (Hérité de ConfigurationElementCollection)
ClearElementName	Obtient ou définit le nom de l'ConfigurationElement à associer à l’opération clear dans le ConfigurationElementCollection en cas de substitution dans une classe dérivée. (Hérité de ConfigurationElementCollection)
CollectionType	Obtient le type du ConfigurationElementCollection. (Hérité de ConfigurationElementCollection)
Count	Obtient le nombre d’éléments de la collection. (Hérité de ConfigurationElementCollection)
CurrentConfiguration	Obtient une référence à l’instance de niveau supérieur Configuration qui représente la hiérarchie de configuration à laquelle appartient l’instance ConfigurationElement actuelle. (Hérité de ConfigurationElement)
ElementInformation	Obtient un objet ElementInformation qui contient les informations et fonctionnalités non personnalisables de l’objet ConfigurationElement. (Hérité de ConfigurationElement)
ElementName	Obtient le nom utilisé pour identifier cette collection d’éléments dans le fichier de configuration en cas de substitution dans une classe dérivée. (Hérité de ConfigurationElementCollection)
ElementProperty	Obtient l’objet ConfigurationElementProperty qui représente l’objet ConfigurationElement lui-même. (Hérité de ConfigurationElement)
EmitClear	Obtient ou définit une valeur qui spécifie si la collection a été effacée. (Hérité de ConfigurationElementCollection)
EvaluationContext	Obtient l’objet ContextInformation de l’objet ConfigurationElement. (Hérité de ConfigurationElement)
HasContext	Obtient une valeur qui indique si la propriété CurrentConfiguration est null. (Hérité de ConfigurationElement)
IsSynchronized	Obtient une valeur indiquant si l’accès à la collection est synchronisé. (Hérité de ConfigurationElementCollection)
Item[ConfigurationProperty]	Obtient ou définit une propriété ou un attribut de cet élément de configuration. (Hérité de ConfigurationElement)
Item[Int32]	Obtient ou définit la chaîne de connexion à l’index spécifié dans la collection.
Item[String]	Obtient ou définit l’objet ConnectionStringSettings avec le nom spécifié dans la collection.
LockAllAttributesExcept	Obtient la collection d’attributs verrouillés. (Hérité de ConfigurationElement)
LockAllElementsExcept	Obtient la collection d’éléments verrouillés. (Hérité de ConfigurationElement)
LockAttributes	Obtient la collection d’attributs verrouillés. (Hérité de ConfigurationElement)
LockElements	Obtient la collection d’éléments verrouillés. (Hérité de ConfigurationElement)
LockItem	Obtient ou définit une valeur indiquant si l’élément est verrouillé. (Hérité de ConfigurationElement)
Properties	Obtient la collection de propriétés. (Hérité de ConfigurationElement)
RemoveElementName	Obtient ou définit le nom du ConfigurationElement à associer à l’opération de suppression dans le ConfigurationElementCollection en cas de substitution dans une classe dérivée. (Hérité de ConfigurationElementCollection)
SyncRoot	Obtient un objet utilisé pour synchroniser l’accès au ConfigurationElementCollection. (Hérité de ConfigurationElementCollection)
ThrowOnDuplicate	Obtient une valeur indiquant si une tentative d’ajout d’une ConfigurationElement en double à l'ConfigurationElementCollection entraîne la levée d’une exception. (Hérité de ConfigurationElementCollection)

Méthodes

Add(ConnectionStringSettings)	Ajoute un objet ConnectionStringSettings à la collection.
BaseAdd(ConfigurationElement, Boolean)	Ajoute un élément de configuration à la collection d’éléments de configuration. (Hérité de ConfigurationElementCollection)
BaseAdd(ConfigurationElement)	Ajoute un élément de configuration au ConfigurationElementCollection. (Hérité de ConfigurationElementCollection)
BaseAdd(Int32, ConfigurationElement)	Ajoute un élément de configuration à la collection d’éléments de configuration. (Hérité de ConfigurationElementCollection)
BaseClear()	Supprime tous les objets d’élément de configuration de la collection. (Hérité de ConfigurationElementCollection)
BaseGet(Int32)	Obtient l’élément de configuration à l’emplacement d’index spécifié. (Hérité de ConfigurationElementCollection)
BaseGet(Object)	Retourne l’élément de configuration avec la clé spécifiée. (Hérité de ConfigurationElementCollection)
BaseGetAllKeys()	Retourne un tableau des clés pour tous les éléments de configuration contenus dans la ConfigurationElementCollection. (Hérité de ConfigurationElementCollection)
BaseGetKey(Int32)	Obtient la clé du ConfigurationElement à l’emplacement d’index spécifié. (Hérité de ConfigurationElementCollection)
BaseIndexOf(ConfigurationElement)	Indique l’index du ConfigurationElementspécifié. (Hérité de ConfigurationElementCollection)
BaseIsRemoved(Object)	Indique si la ConfigurationElement avec la clé spécifiée a été supprimée du ConfigurationElementCollection. (Hérité de ConfigurationElementCollection)
BaseRemove(Object)	Supprime une ConfigurationElement de la collection. (Hérité de ConfigurationElementCollection)
BaseRemoveAt(Int32)	Supprime la ConfigurationElement à l’emplacement d’index spécifié. (Hérité de ConfigurationElementCollection)
Clear()	Supprime tous les objets ConnectionStringSettings de la collection.
CopyTo(ConfigurationElement[], Int32)	Copie le contenu du ConfigurationElementCollection dans un tableau. (Hérité de ConfigurationElementCollection)
CreateNewElement()	En cas de substitution dans une classe dérivée, crée une nouvelle ConfigurationElement. (Hérité de ConfigurationElementCollection)
CreateNewElement(String)	Crée une ConfigurationElement en cas de substitution dans une classe dérivée. (Hérité de ConfigurationElementCollection)
DeserializeElement(XmlReader, Boolean)	Lit le code XML à partir du fichier de configuration. (Hérité de ConfigurationElement)
Equals(Object)	Compare la ConfigurationElementCollection à l’objet spécifié. (Hérité de ConfigurationElementCollection)
GetElementKey(ConfigurationElement)	Obtient la clé d’élément pour un élément de configuration spécifié en cas de substitution dans une classe dérivée. (Hérité de ConfigurationElementCollection)
GetEnumerator()	Obtient une IEnumerator utilisée pour itérer au sein de l'ConfigurationElementCollection. (Hérité de ConfigurationElementCollection)
GetHashCode()	Obtient une valeur unique représentant l’instance de ConfigurationElementCollection. (Hérité de ConfigurationElementCollection)
GetTransformedAssemblyString(String)	Retourne la version transformée du nom d’assembly spécifié. (Hérité de ConfigurationElement)
GetTransformedTypeString(String)	Retourne la version transformée du nom de type spécifié. (Hérité de ConfigurationElement)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
IndexOf(ConnectionStringSettings)	Retourne l’index de collection de l’objet ConnectionStringSettings passé.
Init()	Définit l’objet ConfigurationElement à son état initial. (Hérité de ConfigurationElement)
InitializeDefault()	Permet d’initialiser un jeu de valeurs par défaut pour l’objet ConfigurationElement. (Hérité de ConfigurationElement)
IsElementName(String)	Indique si le ConfigurationElement spécifié existe dans le ConfigurationElementCollection. (Hérité de ConfigurationElementCollection)
IsElementRemovable(ConfigurationElement)	Indique si le ConfigurationElement spécifié peut être supprimé de l'ConfigurationElementCollection. (Hérité de ConfigurationElementCollection)
IsModified()	Indique si cette ConfigurationElementCollection a été modifiée depuis son dernier enregistrement ou son chargement en cas de substitution dans une classe dérivée. (Hérité de ConfigurationElementCollection)
IsReadOnly()	Indique si l’objet ConfigurationElementCollection est en lecture seule. (Hérité de ConfigurationElementCollection)
ListErrors(IList)	Ajoute les erreurs de propriété non valides dans cet objet ConfigurationElement et, dans tous les sous-éléments, à la liste passée. (Hérité de ConfigurationElement)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnDeserializeUnrecognizedAttribute(String, String)	Obtient une valeur indiquant si un attribut inconnu est rencontré lors de la désérialisation. (Hérité de ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Provoque la levée d’une exception par le système de configuration. (Hérité de ConfigurationElementCollection)
OnRequiredPropertyNotFound(String)	Lève une exception lorsqu’une propriété requise est introuvable. (Hérité de ConfigurationElement)
PostDeserialize()	Appelé après la désérialisation. (Hérité de ConfigurationElement)
PreSerialize(XmlWriter)	Appelé avant la sérialisation. (Hérité de ConfigurationElement)
Remove(ConnectionStringSettings)	Supprime l’objet ConnectionStringSettings spécifié de la collection.
Remove(String)	Supprime l’objet ConnectionStringSettings spécifié de la collection.
RemoveAt(Int32)	Supprime l’objet ConnectionStringSettings à l’index spécifié dans la collection.
Reset(ConfigurationElement)	Réinitialise le ConfigurationElementCollection à son état non modifié en cas de substitution dans une classe dérivée. (Hérité de ConfigurationElementCollection)
ResetModified()	Réinitialise la valeur de la propriété IsModified() à false en cas de substitution dans une classe dérivée. (Hérité de ConfigurationElementCollection)
SerializeElement(XmlWriter, Boolean)	Écrit les données de configuration dans un élément XML dans le fichier de configuration en cas de substitution dans une classe dérivée. (Hérité de ConfigurationElementCollection)
SerializeToXmlElement(XmlWriter, String)	Écrit les balises externes de cet élément de configuration dans le fichier de configuration en cas d’implémentation dans une classe dérivée. (Hérité de ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Définit une propriété sur la valeur spécifiée. (Hérité de ConfigurationElement)
SetReadOnly()	Définit la propriété IsReadOnly() pour l’objet ConfigurationElementCollection et pour tous les sous-éléments. (Hérité de ConfigurationElementCollection)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Inverse l’effet de la fusion des informations de configuration à partir de différents niveaux de la hiérarchie de configuration. (Hérité de ConfigurationElementCollection)

Implémentations d’interfaces explicites

ICollection.CopyTo(Array, Int32)

Copie le ConfigurationElementCollection dans un tableau. (Hérité de ConfigurationElementCollection)

Méthodes d’extension

Cast<TResult>(IEnumerable)	Convertit les éléments d’un IEnumerable en type spécifié.
OfType<TResult>(IEnumerable)	Filtre les éléments d’une IEnumerable en fonction d’un type spécifié.
AsParallel(IEnumerable)	Active la parallélisation d’une requête.
AsQueryable(IEnumerable)	Convertit un IEnumerable en IQueryable.

Voir aussi

• ConnectionStringsSection
• ConnectionStringSettings