EntityConnection.ConnectionString Propriedade

public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };

public override string ConnectionString { get; set; }

member this.ConnectionString : string with get, set

Public Overrides Property ConnectionString As String

Valor de Propriedade

A cadeia de ligação necessária para estabelecer a ligação inicial a uma fonte de dados. O valor padrão é uma cadeia de caracteres vazia. Numa ligação fechada, o valor atualmente definido é devolvido. Se nenhum valor tiver sido definido, uma cadeia vazia é devolvida.

Exceções

Exemplos

O exemplo seguinte demonstra como usar o EntityConnectionStringBuilder em conjunto com um SqlConnectionStringBuilder. O código define propriedades de um SqlConnectionStringBuilder para criar uma cadeia SqlConnection que fornece parte do cadeia de ligação fornecedor subjacente. Note que o Provider nome não pode ser definido usando o SqlConnectionStringBuilder, porque não utiliza sintaxe válida SqlConnection . O código cria a EntityConnection cadeia definindo EntityConnectionStringBuilder propriedades.

// 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

Um EntityClient cadeia de ligação consiste numa sequência de pares palavra-chave/valor de parâmetros separados por ponto e vírgula. O sinal de igual (=) liga cada palavra-chave ao seu valor. A tabela a seguir lista os nomes válidos para valores de palavra-chave no ConnectionString.

A aplicação pode fornecer a palavra-chave diretamente na ConnectionString propriedade, ou pode especificar um valor para a Name palavra-chave. Se a palavra-chave Name for especificada, a palavra-chave cadeia de ligação ou valores são recuperados de um ficheiro de configuração de aplicação, da seguinte forma:

Name=AdventureWorksEntities;

Se a Name palavra-chave for usada na ConnectionString propriedade, outras palavras-chave não são permitidas. A palavra-chave Name refere-se a um cadeia de ligação nomeado que está armazenado na secção connectionStrings num ficheiro de configuração de aplicação, como mostrado no exemplo seguinte. Os Providervalores , Metadata, e Provider Connection String são recuperados do ficheiro de configuração em tempo de execução.

Os pares palavra-chave/valor também podem ser fornecidos diretamente na ConnectionString propriedade, como mostrado no exemplo seguinte. Neste caso, a Name palavra-chave não é utilizada.

"Provider=System.Data.SqlClient;
Metadata=c:\metadata|c:\Metadata\Sql;
Provider Connection String= 'Data Source=localhost;
    Initial Catalog=AdventureWorks;Integrated Security=True;Connection Timeout=60' "

Para evitar colocar inadvertidamente objetos como System.Data.Common.CommandTrees e ObjectContext fora de sincronia com os seus metadados, EntityConnection deve bloquear os seus metadados. Não são permitidas alterações à cadeia de ligação após o bloqueio dos metadados. Seguem-se dois cenários em que os metadados estão bloqueados:

• A instância EntityConnection é construída através do construtor sem parâmetros, ou através do construtor EntityConnection(String), que aceita um cadeia de ligação. Em qualquer dos casos, a cadeia de ligação pode ser alterada várias vezes antes de a ligação ser aberta. A chamada Open ou GetMetadataWorkspace bloqueia os metadados.

• A EntityConnection instância é construída através do EntityConnection(MetadataWorkspace, DbConnection) construtor, que aceita a MetadataWorkspace e um DbConnection. Neste caso, os metadados são bloqueados no momento da construção. Nunca são permitidas alterações à cadeia de ligação.

Quando os metadados são carregados, verifica-se EntityConnection que o modelo conceptual, o modelo de armazenamento e o ficheiro de mapeamento estão todos presentes.

Ver também

• Cadeias de Ligação
• Cadeias de Ligação (Estrutura de Entidades)