EntityConnectionStringBuilder Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
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. |