EntityConnectionStringBuilder Classe

Definição

Fornece uma forma simples de criar e gerir o conteúdo das strings de ligaçã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
EntityConnectionStringBuilder

Exemplos

O exemplo seguinte demonstra como usar o EntityConnectionStringBuilder em 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

Observações

O cadeia de ligação builder permite aos desenvolvedores criar programaticamente cadeias de ligação sintaticamente corretas, e analisar e reconstruir cadeias de ligação existentes, utilizando propriedades e métodos da classe. O construtor de cadeia de ligação fornece propriedades fortemente tipadas correspondentes aos pares de palavras-chave e valores conhecidos. Os programadores que têm de criar strings de ligação como parte de aplicações podem usar a EntityConnectionStringBuilder classe para construir e modificar strings de ligação.

Realiza EntityConnectionStringBuilder verificações para pares válidos de palavras-chave/valor, cada um dos quais é exposto como valor de EntityConnectionStringBuilder propriedade.

Note

A cadeia de ligação para a fonte de dados subjacente é fornecida pela propriedade ProviderConnectionString. A cadeia de ligação do fornecedor fornecida não é verificada para pares de palavra-chave/valor válidos.

Construtores

Name Description
EntityConnectionStringBuilder()

Inicializa uma nova instância da EntityConnectionStringBuilder classe.

EntityConnectionStringBuilder(String)

Inicializa uma nova instância da classe EntityConnectionStringBuilder usando a cadeia de ligação fornecida.

Propriedades

Name Description
BrowsableConnectionString

Obtém ou define um valor que indica se a propriedade ConnectionString é visível em Visual Studio designers.

(Herdado de DbConnectionStringBuilder)
ConnectionString

Obtém ou define o cadeia de ligação associado 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 é apenas de leitura.

(Herdado de DbConnectionStringBuilder)
Item[String]

Obtém ou define o valor associado à chave especificada. Em C#, esta propriedade é o indexador.

Keys

Obtém um ICollection que contém as chaves no EntityConnectionStringBuilder.

Metadata

Obtém ou define as localizações dos metadados na cadeia de ligação.

Name

Recebe ou define o nome de uma secção conforme definido num ficheiro de configuração.

Provider

Obtém ou define o nome do fornecedor de dados subjacente do .NET Framework na cadeia de ligação.

ProviderConnectionString

Obtém ou define a cadeia de ligação interna, específica do fornecedor.

Values

Obtém-se um ICollection que contém os valores no DbConnectionStringBuilder.

(Herdado de DbConnectionStringBuilder)

Métodos

Name Description
Add(String, Object)

Adiciona uma entrada com a chave e valor especificados no DbConnectionStringBuilder.

(Herdado de DbConnectionStringBuilder)
Clear()

Limpa o conteúdo da EntityConnectionStringBuilder instância.

ClearPropertyDescriptors()

Limpa a coleção de PropertyDescriptor objetos no .DbConnectionStringBuilder

(Herdado de DbConnectionStringBuilder)
ContainsKey(String)

Determina se o EntityConnectionStringBuilder contém uma chave específica.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
EquivalentTo(DbConnectionStringBuilder)

Compara a informação de ligação neste DbConnectionStringBuilder objeto com a informação de ligação no objeto fornecido.

(Herdado de DbConnectionStringBuilder)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetProperties(Hashtable)

Preenche um fornecimento 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 atual Object.

(Herdado de Object)
Remove(String)

Remove a entrada com a chave especificada da EntityConnectionStringBuilder instância.

ShouldSerialize(String)

Indica se a chave especificada existe neste DbConnectionStringBuilder caso.

(Herdado de DbConnectionStringBuilder)
ToString()

Devolve o cadeia de ligação associado a este DbConnectionStringBuilder.

(Herdado de DbConnectionStringBuilder)
TryGetValue(String, Object)

Recupera um valor correspondente à chave fornecida a partir desta EntityConnectionStringBuilder.

Implementações de Interface Explícita

Name Description
ICollection.CopyTo(Array, Int32)

Copia os elementos do ICollection para um Array, começando num índice particular Array .

(Herdado de DbConnectionStringBuilder)
ICollection.IsSynchronized

Recebe um valor que indica se o acesso ao ICollection é 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()

Devolve uma coleção de atributos personalizados para esta instância de um componente.

(Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()

Devolve o nome da classe desta instância de um componente.

(Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()

Devolve o nome desta instância de um componente.

(Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()

Devolve um conversor de tipos para esta instância de um componente.

(Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()

Devolve o evento predefinido para esta instância de um componente.

(Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()

Devolve a propriedade padrão para esta instância de um componente.

(Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)

Devolve um editor do tipo especificado para esta instância de um componente.

(Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()

Devolve os eventos para esta instância de um componente.

(Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])

Devolve os eventos para esta instância de um componente usando o array de atributos especificado como filtro.

(Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()

Devolve as propriedades para esta instância de um componente.

(Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])

Devolve as propriedades para esta instância de um componente usando o array de atributos como filtro.

(Herdado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)

Devolve um objeto que contém a propriedade descrita pelo descritor de propriedades especificado.

(Herdado de DbConnectionStringBuilder)
IDictionary.Add(Object, Object)

Adiciona um elemento com a chave e o valor fornecidos ao IDictionary 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()

Devolve 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()

Devolve um enumerador que itera numa coleção.

(Herdado de DbConnectionStringBuilder)

Métodos da Extensão

Name Description
AsParallel(IEnumerable)

Permite a paralelização de uma consulta.

AsQueryable(IEnumerable)

Converte um IEnumerable para um IQueryable.

Cast<TResult>(IEnumerable)

Conjura os elementos de an IEnumerable para o tipo especificado.

OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base num tipo especificado.

Aplica-se a

Ver também