ConnectionStringsSection Classe

Définition

Espace de noms:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Fournit un accès programmatique à la section configuration-fichier de chaînes de connexion.

public ref class ConnectionStringsSection sealed : System::Configuration::ConfigurationSection

public sealed class ConnectionStringsSection : System.Configuration.ConfigurationSection

type ConnectionStringsSection = class
    inherit ConfigurationSection

Public NotInheritable Class ConnectionStringsSection
Inherits ConfigurationSection

Héritage

Object

ConfigurationElement

ConfigurationSection

ConnectionStringsSection

Exemples

L’exemple suivant montre comment utiliser la ConnectionStringsSection.

// Create a connection string element and add it to
// the connection strings section.
static ConnectionStrings()
{
    // Get the application configuration file.
    System.Configuration.Configuration config =
            ConfigurationManager.OpenExeConfiguration(
            ConfigurationUserLevel.None);

    // Get the current connection strings count.
    int connStrCnt =
        ConfigurationManager.ConnectionStrings.Count;

    // Create the connection string name.
    string csName =
        "ConnStr" + connStrCnt.ToString();

    // Create a connection string element and
    // save it to the configuration file.

    // Create a connection string element.
    ConnectionStringSettings csSettings =
            new ConnectionStringSettings(csName,
            "LocalSqlServer: data source=127.0.0.1;Integrated Security=True;" +
            "Initial Catalog=aspnetdb", "System.Data.SqlClient");

    // Get the connection strings section.
    ConnectionStringsSection csSection =
        config.ConnectionStrings;

    // Add the new element.
    csSection.ConnectionStrings.Add(csSettings);

    // Save the configuration file.
    config.Save(ConfigurationSaveMode.Modified);
}

' Create a connectionn string element and add it to
' the connection strings section.
Shared Sub New() 

    ' Get the application configuration file.
    Dim config _
    As System.Configuration.Configuration = _
    ConfigurationManager.OpenExeConfiguration( _
    ConfigurationUserLevel.None)
    
    ' Get the current connection strings count.
    Dim connStrCnt As Integer = _
    ConfigurationManager.ConnectionStrings.Count
    
    ' Create the connection string name. 
    Dim csName As String = "ConnStr" + connStrCnt.ToString()
    
    ' Create a connection string element and
    ' save it to the configuration file.
    ' Create a connection string element.
    Dim csSettings _
    As New ConnectionStringSettings( _
    csName, _
    "LocalSqlServer: data source=127.0.0.1;Integrated Security=SSPI;" + _
    "Initial Catalog=aspnetdb", "System.Data.SqlClient")
    
    ' Get the connection strings section.
    Dim csSection _
    As ConnectionStringsSection = _
    config.ConnectionStrings
    
    ' Add the new element.
    csSection.ConnectionStrings.Add(csSettings)
    
    ' Save the configuration file.
    config.Save(ConfigurationSaveMode.Modified)

End Sub

Remarques

La classe ConnectionStringsSection vous permet de modifier par programmation la section connectionStrings du fichier de configuration. Les chaînes de connexion sont fournies sous la forme d’un ConnectionStringSettingsCollection d’éléments de configuration ConnectionStringSettingsadd.

Constructeurs

ConnectionStringsSection()

Initialise une nouvelle instance de la classe ConnectionStringsSection.

Propriétés

ConnectionStrings	Obtient une collection ConnectionStringSettingsCollection d’objets ConnectionStringSettings.
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)
ElementProperty	Obtient l’objet ConfigurationElementProperty qui représente l’objet ConfigurationElement lui-même. (Hérité de ConfigurationElement)
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)
Item[ConfigurationProperty]	Obtient ou définit une propriété ou un attribut de cet élément de configuration. (Hérité de ConfigurationElement)
Item[String]	Obtient ou définit une propriété, un attribut ou un élément enfant de cet élément de configuration. (Hérité de ConfigurationElement)
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)
SectionInformation	Obtient un objet SectionInformation qui contient les informations et fonctionnalités non personnalisables de l’objet ConfigurationSection. (Hérité de ConfigurationSection)

Méthodes

DeserializeElement(XmlReader, Boolean)	Lit le code XML à partir du fichier de configuration. (Hérité de ConfigurationElement)
DeserializeSection(XmlReader)	Lit le code XML à partir du fichier de configuration. (Hérité de ConfigurationSection)
Equals(Object)	Compare l’instance de ConfigurationElement actuelle à l’objet spécifié. (Hérité de ConfigurationElement)
GetHashCode()	Obtient une valeur unique représentant l’instance de ConfigurationElement actuelle. (Hérité de ConfigurationElement)
GetRuntimeObject()	Retourne un objet personnalisé en cas de substitution dans une classe dérivée. (Hérité de ConfigurationSection)
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)
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)
IsModified()	Indique si cet élément de configuration a été modifié depuis son dernier enregistrement ou chargé lors de l’implémentation dans une classe dérivée. (Hérité de ConfigurationSection)
IsReadOnly()	Obtient une valeur indiquant si l’objet ConfigurationElement est en lecture seule. (Hérité de ConfigurationElement)
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)	Obtient une valeur indiquant si un élément inconnu est rencontré lors de la désérialisation. (Hérité de ConfigurationElement)
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)
Reset(ConfigurationElement)	Réinitialise l’état interne de l’objet ConfigurationElement, y compris les verrous et les collections de propriétés. (Hérité de ConfigurationElement)
ResetModified()	Réinitialise la valeur de la méthode IsModified() à false en cas d’implémentation dans une classe dérivée. (Hérité de ConfigurationSection)
SerializeElement(XmlWriter, Boolean)	Écrit le contenu 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)
SerializeSection(ConfigurationElement, String, ConfigurationSaveMode)	Crée une chaîne XML contenant une vue non fusionnée de l’objet ConfigurationSection en tant que section unique à écrire dans un fichier. (Hérité de ConfigurationSection)
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 ConfigurationElement et tous les sous-éléments. (Hérité de ConfigurationElement)
ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName)	Indique si l’élément spécifié doit être sérialisé lorsque la hiérarchie d’objets de configuration est sérialisée pour la version cible spécifiée du .NET Framework. (Hérité de ConfigurationSection)
ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement)	Indique si la propriété spécifiée doit être sérialisée lorsque la hiérarchie d’objets de configuration est sérialisée pour la version cible spécifiée du .NET Framework. (Hérité de ConfigurationSection)
ShouldSerializeSectionInTargetVersion(FrameworkName)	Indique si l’instance de ConfigurationSection actuelle doit être sérialisée lorsque la hiérarchie d’objets de configuration est sérialisée pour la version cible spécifiée du .NET Framework. (Hérité de ConfigurationSection)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Modifie l’objet ConfigurationElement pour supprimer toutes les valeurs qui ne doivent pas être enregistrées. (Hérité de ConfigurationElement)

Voir aussi

• ConnectionStringSettingsCollection
• ConnectionStringSettings