EntityConnectionStringBuilder Classe

Definição

Namespace:

System.Data.EntityClient

Assembly:

System.Data.Entity.dll

Fornece uma maneira simples de criar e gerenciar o conteúdo das cadeias de conexão usadas pelo EntityClient.

public ref class EntityConnectionStringBuilder sealed : System::Data::Common::DbConnectionStringBuilder

public sealed class EntityConnectionStringBuilder : System.Data.Common.DbConnectionStringBuilder

type EntityConnectionStringBuilder = class
    inherit DbConnectionStringBuilder

Public NotInheritable Class EntityConnectionStringBuilder
Inherits DbConnectionStringBuilder

Herança

Object

DbConnectionStringBuilder

EntityConnectionStringBuilder

Exemplos

O exemplo a seguir demonstra como usar em EntityConnectionStringBuilder conjunto com um SqlConnectionStringBuilder.

// Specify the provider name, server and database.
string providerName = "System.Data.SqlClient";
string serverName = ".";
string databaseName = "AdventureWorks";

// Initialize the connection string builder for the
// underlying provider.
SqlConnectionStringBuilder sqlBuilder =
    new SqlConnectionStringBuilder();

// Set the properties for the data source.
sqlBuilder.DataSource = serverName;
sqlBuilder.InitialCatalog = databaseName;
sqlBuilder.IntegratedSecurity = true;

// Build the SqlConnection connection string.
string providerString = sqlBuilder.ToString();

// Initialize the EntityConnectionStringBuilder.
EntityConnectionStringBuilder entityBuilder =
    new EntityConnectionStringBuilder();

//Set the provider name.
entityBuilder.Provider = providerName;

// Set the provider-specific connection string.
entityBuilder.ProviderConnectionString = providerString;

// Set the Metadata location.
entityBuilder.Metadata = @"res://*/AdventureWorksModel.csdl|
                            res://*/AdventureWorksModel.ssdl|
                            res://*/AdventureWorksModel.msl";
Console.WriteLine(entityBuilder.ToString());

using (EntityConnection conn =
    new EntityConnection(entityBuilder.ToString()))
{
    conn.Open();
    Console.WriteLine("Just testing the connection.");
    conn.Close();
}

' Specify the provider name, server and database.
Dim providerName As String = "System.Data.SqlClient"
Dim serverName As String = "."
Dim databaseName As String = "AdventureWorks"

' Initialize the connection string builder for the
' underlying provider.
Dim sqlBuilder As New SqlConnectionStringBuilder

' Set the properties for the data source.
sqlBuilder.DataSource = serverName
sqlBuilder.InitialCatalog = databaseName
sqlBuilder.IntegratedSecurity = True

' Build the SqlConnection connection string.
Dim providerString As String = sqlBuilder.ToString

' Initialize the EntityConnectionStringBuilder.
Dim entityBuilder As New EntityConnectionStringBuilder

'Set the provider name.
entityBuilder.Provider = providerName
' Set the provider-specific connection string.
entityBuilder.ProviderConnectionString = providerString
' Set the Metadata location to the current directory.
entityBuilder.Metadata = "res://*/AdventureWorksModel.csdl|" & _
                            "res://*/AdventureWorksModel.ssdl|" & _
                            "res://*/AdventureWorksModel.msl"

Console.WriteLine(entityBuilder.ToString)

Using conn As EntityConnection = New EntityConnection(entityBuilder.ToString)
    conn.Open()
    Console.WriteLine("Just testing the connection.")
    conn.Close()
End Using

Comentários

O construtor de cadeias de conexão permite que os desenvolvedores criem programaticamente cadeias de conexão sintaticamente corretas e analisem e recompilem cadeias de conexão existentes usando propriedades e métodos da classe. O construtor de cadeias de conexão fornece propriedades fortemente tipadas correspondentes aos pares de palavra-chave/valor conhecidos. Os desenvolvedores que devem criar cadeias de conexão como parte de aplicativos podem usar a EntityConnectionStringBuilder classe para criar e modificar cadeias de conexão.

A EntityConnectionStringBuilder execução verifica se há pares válidos de palavra-chave/valor, cada um deles exposto como um EntityConnectionStringBuilder valor de propriedade.

Observação

A cadeia de conexão para a fonte de dados subjacente é fornecida pela ProviderConnectionString propriedade. A cadeia de conexão do provedor fornecido não está marcada para pares válidos de palavra-chave/valor.

Construtores

Nome	Description
EntityConnectionStringBuilder()	Inicializa uma nova instância da classe EntityConnectionStringBuilder.
EntityConnectionStringBuilder(String)	Inicializa uma nova instância da EntityConnectionStringBuilder classe usando a cadeia de conexão fornecida.

Propriedades

Nome	Description
BrowsableConnectionString	Obtém ou define um valor que indica se a ConnectionString propriedade está visível em designers do Visual Studio. (Herdado de DbConnectionStringBuilder)
ConnectionString	Obtém ou define a cadeia de conexão associada ao DbConnectionStringBuilder. (Herdado de DbConnectionStringBuilder)
Count	Obtém o número atual de chaves contidas na ConnectionString propriedade. (Herdado de DbConnectionStringBuilder)
IsFixedSize	Obtém um valor que indica se o EntityConnectionStringBuilder tem um tamanho fixo.
IsReadOnly	Obtém um valor que indica se o DbConnectionStringBuilder valor é somente leitura. (Herdado de DbConnectionStringBuilder)
Item[String]	Obtém ou define o valor associado à chave especificada. Em C#, essa propriedade é o indexador.
Keys	Obtém um ICollection que contém as chaves no EntityConnectionStringBuilder.
Metadata	Obtém ou define os locais de metadados na cadeia de conexão.
Name	Obtém ou define o nome de uma seção conforme definido em um arquivo de configuração.
Provider	Obtém ou define o nome do provedor de dados do .NET Framework subjacente na cadeia de conexão.
ProviderConnectionString	Obtém ou define a cadeia de conexão interna específica do provedor.
Values	Obtém um ICollection que contém os valores no DbConnectionStringBuilder. (Herdado de DbConnectionStringBuilder)

Métodos

Nome	Description
Add(String, Object)	Adiciona uma entrada com a chave e o valor especificados ao DbConnectionStringBuilder. (Herdado de DbConnectionStringBuilder)
Clear()	Limpa o conteúdo da EntityConnectionStringBuilder instância.
ClearPropertyDescriptors()	Limpa a coleção de PropertyDescriptor objetos no associado DbConnectionStringBuilder. (Herdado de DbConnectionStringBuilder)
ContainsKey(String)	Determina se a EntityConnectionStringBuilder chave contém uma chave específica.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
EquivalentTo(DbConnectionStringBuilder)	Compara as informações de conexão neste DbConnectionStringBuilder objeto com as informações de conexão no objeto fornecido. (Herdado de DbConnectionStringBuilder)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetProperties(Hashtable)	Preenche um fornecido Hashtable com informações sobre todas as propriedades deste DbConnectionStringBuilder. (Herdado de DbConnectionStringBuilder)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
Remove(String)	Remove a entrada com a chave especificada da EntityConnectionStringBuilder instância.
ShouldSerialize(String)	Indica se a chave especificada existe nesta DbConnectionStringBuilder instância. (Herdado de DbConnectionStringBuilder)
ToString()	Retorna a cadeia de conexão associada a isso DbConnectionStringBuilder. (Herdado de DbConnectionStringBuilder)
TryGetValue(String, Object)	Recupera um valor correspondente à chave fornecida a partir deste EntityConnectionStringBuilder.

Implantações explícitas de interface

Nome	Description
ICollection.CopyTo(Array, Int32)	Copia os elementos de ICollection um Array, começando em um índice específico Array . (Herdado de DbConnectionStringBuilder)
ICollection.IsSynchronized	Obtém um valor que indica se o ICollection acesso ao é sincronizado (thread safe). (Herdado de DbConnectionStringBuilder)
ICollection.SyncRoot	Obtém um objeto que pode ser usado para sincronizar o acesso ao ICollection. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()	Retorna uma coleção de atributos personalizados para esta instância de um componente. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()	Retorna o nome da classe dessa instância de um componente. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()	Retorna o nome dessa instância de um componente. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()	Retorna um conversor de tipo para esta instância de um componente. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()	Retorna o evento padrão para esta instância de um componente. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()	Retorna a propriedade padrão para esta instância de um componente. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)	Retorna um editor do tipo especificado para esta instância de um componente. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()	Retorna os eventos para esta instância de um componente. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])	Retorna os eventos dessa instância de um componente usando a matriz de atributo especificada como um filtro. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()	Retorna as propriedades dessa instância de um componente. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])	Retorna as propriedades dessa instância de um componente usando a matriz de atributos como um filtro. (Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)	Retorna um objeto que contém a propriedade descrita pelo descritor de propriedade especificado. (Herdado de DbConnectionStringBuilder)
IDictionary.Add(Object, Object)	Adiciona um elemento com a chave e o valor fornecidos IDictionary ao objeto. (Herdado de DbConnectionStringBuilder)
IDictionary.Contains(Object)	Determina se o IDictionary objeto contém um elemento com a chave especificada. (Herdado de DbConnectionStringBuilder)
IDictionary.GetEnumerator()	Retorna um IDictionaryEnumerator objeto para o IDictionary objeto. (Herdado de DbConnectionStringBuilder)
IDictionary.Item[Object]	Obtém ou define o elemento com a chave especificada. (Herdado de DbConnectionStringBuilder)
IDictionary.Remove(Object)	Remove o elemento com a chave especificada do IDictionary objeto. (Herdado de DbConnectionStringBuilder)
IEnumerable.GetEnumerator()	Retorna um enumerador que itera por meio de uma coleção. (Herdado de DbConnectionStringBuilder)

Métodos de Extensão

Nome	Description
AsParallel(IEnumerable)	Habilita a paralelização de uma consulta.
AsQueryable(IEnumerable)	Converte um IEnumerable em um IQueryable.
Cast<TResult>(IEnumerable)	Converte os elementos de um IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)	Filtra os elementos de um IEnumerable com base em um tipo especificado.

Confira também

• EntityConnection
• Strings de Conexão
• Trabalhando com o EntityClient