ConnectionStringsSection Clase

Definición

Proporciona acceso mediante programación a la sección de archivos de configuración relacionados con cadenas de conexión.Provides programmatic access to the connection strings configuration-file section.

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
Herencia

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar el ConnectionStringsSection.The following example shows how to use the ConnectionStringsSection.

       // Create a connectionn 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=SSPI;" +
                   "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
 

En el siguiente fragmento se muestra la configuración utilizada en el ejemplo anterior.The following excerpt shows the configuration used by the previous example.

<?xml version="1.0" encoding="utf-8"?>  
<configuration>  
  <connectionStrings>  
    <add name="ConnStr1" connectionString="LocalSqlServer: data source=127.0.0.1;Integrated Security=SSPI;Initial Catalog=aspnetdb"  
      providerName="System.Data.SqlClient" />  
  </connectionStrings>  
</configuration>  

Comentarios

La clase ConnectionStringsSection permite modificar mediante programación la sección connectionStrings del archivo de configuración.The ConnectionStringsSection class allows you to programmatically modify the connectionStrings section of the configuration file. Las cadenas de conexión se proporcionan como ConnectionStringSettingsCollection de ConnectionStringSettingsadd elementos de configuración.The connection strings are provided as a ConnectionStringSettingsCollection of ConnectionStringSettingsadd configuration elements.

Constructores

ConnectionStringsSection()

Inicializa una nueva instancia de la clase ConnectionStringsSection.Initializes a new instance of the ConnectionStringsSection class.

Propiedades

ConnectionStrings

Obtiene una colección ConnectionStringSettingsCollection de objetos ConnectionStringSettings.Gets a ConnectionStringSettingsCollection collection of ConnectionStringSettings objects.

CurrentConfiguration

Obtiene una referencia a la instancia de Configuration de nivel superior que representa la jerarquía de configuración a la que pertenece la instancia actual de ConfigurationElement.Gets a reference to the top-level Configuration instance that represents the configuration hierarchy that the current ConfigurationElement instance belongs to.

(Heredado de ConfigurationElement)
ElementInformation

Obtiene un objeto ElementInformation que contiene la funcionalidad e información no personalizable del objeto ConfigurationElement.Gets an ElementInformation object that contains the non-customizable information and functionality of the ConfigurationElement object.

(Heredado de ConfigurationElement)
ElementProperty

Obtiene el objeto ConfigurationElementProperty que representa al propio objeto ConfigurationElement.Gets the ConfigurationElementProperty object that represents the ConfigurationElement object itself.

(Heredado de ConfigurationElement)
EvaluationContext

Obtiene el objeto ContextInformation para el objeto ConfigurationElement.Gets the ContextInformation object for the ConfigurationElement object.

(Heredado de ConfigurationElement)
HasContext

Obtiene un valor que indica si la propiedad CurrentConfiguration es null.Gets a value that indicates whether the CurrentConfiguration property is null.

(Heredado de ConfigurationElement)
Item[ConfigurationProperty]

Obtiene o establece una propiedad o atributo de este elemento de configuración.Gets or sets a property or attribute of this configuration element.

(Heredado de ConfigurationElement)
Item[String]

Obtiene o establece una propiedad, atributo o elemento secundario de este elemento de configuración.Gets or sets a property, attribute, or child element of this configuration element.

(Heredado de ConfigurationElement)
LockAllAttributesExcept

Obtiene la colección de atributos bloqueados.Gets the collection of locked attributes.

(Heredado de ConfigurationElement)
LockAllElementsExcept

Obtiene la colección de elementos bloqueados.Gets the collection of locked elements.

(Heredado de ConfigurationElement)
LockAttributes

Obtiene la colección de atributos bloqueados.Gets the collection of locked attributes.

(Heredado de ConfigurationElement)
LockElements

Obtiene la colección de elementos bloqueados.Gets the collection of locked elements.

(Heredado de ConfigurationElement)
LockItem

Obtiene o establece un valor que indica si el elemento está bloqueado.Gets or sets a value indicating whether the element is locked.

(Heredado de ConfigurationElement)
Properties

Obtiene la colección de propiedades.Gets the collection of properties.

(Heredado de ConfigurationElement)
SectionInformation

Obtiene un objeto SectionInformation que contiene la funcionalidad e información no personalizable del objeto ConfigurationSection.Gets a SectionInformation object that contains the non-customizable information and functionality of the ConfigurationSection object.

(Heredado de ConfigurationSection)

Métodos

DeserializeElement(XmlReader, Boolean)

Lee XML del archivo de configuración.Reads XML from the configuration file.

(Heredado de ConfigurationElement)
DeserializeSection(XmlReader)

Lee XML del archivo de configuración.Reads XML from the configuration file.

(Heredado de ConfigurationSection)
Equals(Object)

Compara la instancia actual de ConfigurationElement con el objeto especificado.Compares the current ConfigurationElement instance to the specified object.

(Heredado de ConfigurationElement)
GetHashCode()

Obtiene un valor único que representa la instancia ConfigurationElement actual.Gets a unique value representing the current ConfigurationElement instance.

(Heredado de ConfigurationElement)
GetRuntimeObject()

Devuelve un objeto personalizado cuando se reemplaza en una clase derivada.Returns a custom object when overridden in a derived class.

(Heredado de ConfigurationSection)
GetTransformedAssemblyString(String)

Devuelve la versión transformada del nombre de ensamblado especificado.Returns the transformed version of the specified assembly name.

(Heredado de ConfigurationElement)
GetTransformedTypeString(String)

Devuelve la versión transformada del nombre de tipo especificado.Returns the transformed version of the specified type name.

(Heredado de ConfigurationElement)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
Init()

Establece el objeto ConfigurationElement en su estado inicial.Sets the ConfigurationElement object to its initial state.

(Heredado de ConfigurationElement)
InitializeDefault()

Se utiliza para inicializar un conjunto predeterminado de valores para el objeto ConfigurationElement.Used to initialize a default set of values for the ConfigurationElement object.

(Heredado de ConfigurationElement)
IsModified()

Indica si se ha modificado este elemento de configuración desde la última vez en que se guardo o cargó al implementarlo en una clase derivada.Indicates whether this configuration element has been modified since it was last saved or loaded when implemented in a derived class.

(Heredado de ConfigurationSection)
IsReadOnly()

Obtiene un valor que indica si el objeto ConfigurationElement es de solo lectura.Gets a value indicating whether the ConfigurationElement object is read-only.

(Heredado de ConfigurationElement)
ListErrors(IList)

Agrega a la lista que se pasa los errores de propiedad no válida que hay en este objeto ConfigurationElement y en todos los subelementos.Adds the invalid-property errors in this ConfigurationElement object, and in all subelements, to the passed list.

(Heredado de ConfigurationElement)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
OnDeserializeUnrecognizedAttribute(String, String)

Obtiene un valor que indica si se ha encontrado un atributo desconocido durante la deserialización.Gets a value indicating whether an unknown attribute is encountered during deserialization.

(Heredado de ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)

Obtiene un valor que indica si se ha encontrado un elemento desconocido durante la deserialización.Gets a value indicating whether an unknown element is encountered during deserialization.

(Heredado de ConfigurationElement)
OnRequiredPropertyNotFound(String)

Se inicia una excepción cuando no se encuentra una propiedad necesaria.Throws an exception when a required property is not found.

(Heredado de ConfigurationElement)
PostDeserialize()

Se llama a este método después de la deserialización.Called after deserialization.

(Heredado de ConfigurationElement)
PreSerialize(XmlWriter)

Se llama a este método antes de la serialización.Called before serialization.

(Heredado de ConfigurationElement)
Reset(ConfigurationElement)

Restablece el estado interno del objeto ConfigurationElement, incluyendo los bloqueos y las colecciones de propiedades.Resets the internal state of the ConfigurationElement object, including the locks and the properties collections.

(Heredado de ConfigurationElement)
ResetModified()

Restablece el valor del método IsModified() en false cuando se implementa en una clase derivada.Resets the value of the IsModified() method to false when implemented in a derived class.

(Heredado de ConfigurationSection)
SerializeElement(XmlWriter, Boolean)

Escribe el contenido de este elemento de configuración en el archivo de configuración cuando se implementa en una clase derivada.Writes the contents of this configuration element to the configuration file when implemented in a derived class.

(Heredado de ConfigurationElement)
SerializeSection(ConfigurationElement, String, ConfigurationSaveMode)

Crea una cadena XML que contiene una vista separada del objeto ConfigurationSection como una sección única para escribir en un archivo.Creates an XML string containing an unmerged view of the ConfigurationSection object as a single section to write to a file.

(Heredado de ConfigurationSection)
SerializeToXmlElement(XmlWriter, String)

Escribe las etiquetas externas de este elemento de configuración en el archivo de configuración cuando se implementa en una clase derivada.Writes the outer tags of this configuration element to the configuration file when implemented in a derived class.

(Heredado de ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)

Establece una propiedad en el valor especificado.Sets a property to the specified value.

(Heredado de ConfigurationElement)
SetReadOnly()

Establece la propiedad IsReadOnly() para el objeto ConfigurationElement y todos los subelementos.Sets the IsReadOnly() property for the ConfigurationElement object and all subelements.

(Heredado de ConfigurationElement)
ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName)

Indica si se debe serializar el elemento especificado cuando la jerarquía de objetos de configuración se serializa para la versión de destino especificada de .NET Framework.NET Framework.Indicates whether the specified element should be serialized when the configuration object hierarchy is serialized for the specified target version of the .NET Framework.NET Framework.

(Heredado de ConfigurationSection)
ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement)

Indica si se debe serializar la propiedad especificada cuando la jerarquía de objetos de configuración se serializa para la versión de destino especificada de .NET Framework.NET Framework.Indicates whether the specified property should be serialized when the configuration object hierarchy is serialized for the specified target version of the .NET Framework.NET Framework.

(Heredado de ConfigurationSection)
ShouldSerializeSectionInTargetVersion(FrameworkName)

Indica si se debe serializar la instancia actual de ConfigurationSection cuando la jerarquía de objetos de configuración se serializa para la versión de destino especificada de .NET Framework.NET Framework.Indicates whether the current ConfigurationSection instance should be serialized when the configuration object hierarchy is serialized for the specified target version of the .NET Framework.NET Framework.

(Heredado de ConfigurationSection)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)

Modifica el objeto ConfigurationElement para quitar todos los valores que no se deben guardar.Modifies the ConfigurationElement object to remove all values that should not be saved.

(Heredado de ConfigurationElement)

Se aplica a

Consulte también: