ConnectionStringsSection Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece acesso programático à seção arquivo de configuração de cadeias de conexão.
public ref class ConnectionStringsSection sealed : System::Configuration::ConfigurationSectionpublic sealed class ConnectionStringsSection : System.Configuration.ConfigurationSectiontype ConnectionStringsSection = class
inherit ConfigurationSectionPublic NotInheritable Class ConnectionStringsSection
Inherits ConfigurationSection- Herança
Exemplos
O exemplo a seguir mostra como usar o 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
O trecho a seguir mostra a configuração usada pelo exemplo anterior.
<?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>
Comentários
A classe ConnectionStringsSection permite modificar programaticamente a seção connectionStrings do arquivo de configuração. As cadeias de conexão são fornecidas como um ConnectionStringSettingsCollection de elementos de configuração ConnectionStringSettingsadd.
Construtores
| ConnectionStringsSection() |
Inicializa uma nova instância da classe ConnectionStringsSection. |
Propriedades
| ConnectionStrings |
Obtém uma coleção ConnectionStringSettingsCollection de objetos ConnectionStringSettings. |
| CurrentConfiguration |
Obtém uma referência à instância de Configuration de nível superior que representa a hierarquia de configuração à qual a instância ConfigurationElement atual pertence. (Herdado de ConfigurationElement) |
| ElementInformation |
Obtém um objeto ElementInformation que contém as informações e a funcionalidade não personalizáveis do objeto ConfigurationElement. (Herdado de ConfigurationElement) |
| ElementProperty |
Obtém o objeto ConfigurationElementProperty que representa o próprio objeto ConfigurationElement. (Herdado de ConfigurationElement) |
| EvaluationContext |
Obtém o objeto ContextInformation do objeto ConfigurationElement. (Herdado de ConfigurationElement) |
| HasContext |
Obtém um valor que indica se a propriedade CurrentConfiguration é |
| Item[ConfigurationProperty] |
Obtém ou define uma propriedade ou atributo desse elemento de configuração. (Herdado de ConfigurationElement) |
| Item[String] |
Obtém ou define uma propriedade, um atributo ou um elemento filho desse elemento de configuração. (Herdado de ConfigurationElement) |
| LockAllAttributesExcept |
Obtém a coleção de atributos bloqueados. (Herdado de ConfigurationElement) |
| LockAllElementsExcept |
Obtém a coleção de elementos bloqueados. (Herdado de ConfigurationElement) |
| LockAttributes |
Obtém a coleção de atributos bloqueados. (Herdado de ConfigurationElement) |
| LockElements |
Obtém a coleção de elementos bloqueados. (Herdado de ConfigurationElement) |
| LockItem |
Obtém ou define um valor que indica se o elemento está bloqueado. (Herdado de ConfigurationElement) |
| Properties |
Obtém a coleção de propriedades. (Herdado de ConfigurationElement) |
| SectionInformation |
Obtém um objeto SectionInformation que contém as informações e funcionalidades não personalizáveis do objeto ConfigurationSection. (Herdado de ConfigurationSection) |
Métodos
| DeserializeElement(XmlReader, Boolean) |
Lê XML do arquivo de configuração. (Herdado de ConfigurationElement) |
| DeserializeSection(XmlReader) |
Lê XML do arquivo de configuração. (Herdado de ConfigurationSection) |
| Equals(Object) |
Compara a instância ConfigurationElement atual com o objeto especificado. (Herdado de ConfigurationElement) |
| GetHashCode() |
Obtém um valor exclusivo que representa a instância de ConfigurationElement atual. (Herdado de ConfigurationElement) |
| GetRuntimeObject() |
Retorna um objeto personalizado quando substituído em uma classe derivada. (Herdado de ConfigurationSection) |
| GetTransformedAssemblyString(String) |
Retorna a versão transformada do nome do assembly especificado. (Herdado de ConfigurationElement) |
| GetTransformedTypeString(String) |
Retorna a versão transformada do nome de tipo especificado. (Herdado de ConfigurationElement) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| Init() |
Define o objeto ConfigurationElement como seu estado inicial. (Herdado de ConfigurationElement) |
| InitializeDefault() |
Usado para inicializar um conjunto padrão de valores para o objeto ConfigurationElement. (Herdado de ConfigurationElement) |
| IsModified() |
Indica se esse elemento de configuração foi modificado desde que foi salvo ou carregado pela última vez quando implementado em uma classe derivada. (Herdado de ConfigurationSection) |
| IsReadOnly() |
Obtém um valor que indica se o objeto ConfigurationElement é somente leitura. (Herdado de ConfigurationElement) |
| ListErrors(IList) |
Adiciona os erros de propriedade inválido neste objeto ConfigurationElement e em todos os subelementos à lista passada. (Herdado de ConfigurationElement) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| OnDeserializeUnrecognizedAttribute(String, String) |
Obtém um valor que indica se um atributo desconhecido é encontrado durante a desserialização. (Herdado de ConfigurationElement) |
| OnDeserializeUnrecognizedElement(String, XmlReader) |
Obtém um valor que indica se um elemento desconhecido é encontrado durante a desserialização. (Herdado de ConfigurationElement) |
| OnRequiredPropertyNotFound(String) |
Gera uma exceção quando uma propriedade necessária não é encontrada. (Herdado de ConfigurationElement) |
| PostDeserialize() |
Chamado após a desserialização. (Herdado de ConfigurationElement) |
| PreSerialize(XmlWriter) |
Chamado antes da serialização. (Herdado de ConfigurationElement) |
| Reset(ConfigurationElement) |
Redefine o estado interno do objeto ConfigurationElement, incluindo os bloqueios e as coleções de propriedades. (Herdado de ConfigurationElement) |
| ResetModified() |
Redefine o valor do método IsModified() para |
| SerializeElement(XmlWriter, Boolean) |
Grava o conteúdo desse elemento de configuração no arquivo de configuração quando implementado em uma classe derivada. (Herdado de ConfigurationElement) |
| SerializeSection(ConfigurationElement, String, ConfigurationSaveMode) |
Cria uma cadeia de caracteres XML que contém uma exibição não mesclada do objeto ConfigurationSection como uma única seção para gravar em um arquivo. (Herdado de ConfigurationSection) |
| SerializeToXmlElement(XmlWriter, String) |
Grava as marcas externas desse elemento de configuração no arquivo de configuração quando implementado em uma classe derivada. (Herdado de ConfigurationElement) |
| SetPropertyValue(ConfigurationProperty, Object, Boolean) |
Define uma propriedade como o valor especificado. (Herdado de ConfigurationElement) |
| SetReadOnly() |
Define a propriedade IsReadOnly() para o objeto ConfigurationElement e todos os subelementos. (Herdado de ConfigurationElement) |
| ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName) |
Indica se o elemento especificado deve ser serializado quando a hierarquia de objetos de configuração é serializada para a versão de destino especificada do .NET Framework. (Herdado de ConfigurationSection) |
| ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement) |
Indica se a propriedade especificada deve ser serializada quando a hierarquia de objetos de configuração é serializada para a versão de destino especificada do .NET Framework. (Herdado de ConfigurationSection) |
| ShouldSerializeSectionInTargetVersion(FrameworkName) |
Indica se a instância de ConfigurationSection atual deve ser serializada quando a hierarquia de objetos de configuração é serializada para a versão de destino especificada do .NET Framework. (Herdado de ConfigurationSection) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
| Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode) |
Modifica o objeto ConfigurationElement para remover todos os valores que não devem ser salvos. (Herdado de ConfigurationElement) |
