EntityConnection.ConnectionString Vlastnost

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

Hodnota vlastnosti

Připojovací řetězec nutné k navázání počátečního připojení ke zdroji dat. Výchozí hodnota je prázdný řetězec. U uzavřeného připojení se vrátí aktuálně nastavená hodnota. Pokud nebyla nastavena žádná hodnota, vrátí se prázdný řetězec.

Výjimky

Příklady

Následující příklad ukazuje, jak použít EntityConnectionStringBuilder ve spojení s SqlConnectionStringBuilder. Kód nastaví vlastnosti objektu SqlConnectionStringBuilder a vytvoří SqlConnection řetězec, který poskytuje část základního zprostředkovatele připojovací řetězec. Všimněte siProvider, že název nelze nastavit pomocí , protože nepoužívá platnou SqlConnectionStringBuilderSqlConnection syntaxi. Kód vytvoří EntityConnection řetězec nastavením EntityConnectionStringBuilder vlastností.

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

Poznámky

Připojovací řetězec EntityClient se skládá z posloupnosti párů parametrů klíčového slova a hodnoty oddělených středníky. Znaménko rovná se (=) spojuje jednotlivá klíčová slova a jeho hodnotu. Následující tabulka uvádí platné názvy hodnot klíčových slov v ConnectionStringsouboru .

Aplikace může zadat klíčové slovo nebo hodnoty přímo ve ConnectionString vlastnosti, nebo může zadat hodnotu klíčového Name slova. Name Pokud je klíčové slovo zadané, načtou se z konfiguračního souboru aplikace připojovací řetězec klíčové slovo nebo hodnoty, a to následujícím způsobem:

Name=AdventureWorksEntities;

Pokud je Name klíčové slovo použito ve ConnectionString vlastnosti, nejsou povolena jiná klíčová slova. Klíčové Name slovo odkazuje na pojmenovanou připojovací řetězec, která je uložena v oddílu connectionStrings v konfiguračním souboru aplikace, jak je znázorněno v následujícím příkladu. Hodnoty Provider, Metadataa Provider Connection String se načítají z konfiguračního souboru za běhu.

Páry klíčového slova a hodnoty lze také zadat přímo ve ConnectionString vlastnosti, jak je znázorněno v následujícím příkladu. V tomto případě Name se klíčové slovo nepoužívá.

"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' "

Chcete-li zabránit neúmyslnému uvedení objektů, jako System.Data.Common.CommandTrees jsou a ObjectContext mimo synchronizaci s jejich metadaty, EntityConnection musí uzamknout jejich metadata. Po uzamčení metadat nejsou povoleny žádné změny připojovací řetězec. Tady jsou dva scénáře, ve kterých jsou metadata uzamčena:

• Instance EntityConnection je vytvořena prostřednictvím konstruktoru bez parametrů nebo konstruktoruEntityConnection(String), který přijímá připojovací řetězec. V obou případech může být připojovací řetězec před otevřením připojení několikrát změněno. Volání Open nebo GetMetadataWorkspace uzamčení metadat.

• Instance EntityConnection je vytvořena prostřednictvím konstruktoruEntityConnection(MetadataWorkspace, DbConnection), který přijímá MetadataWorkspace a .DbConnection V tomto případě jsou metadata uzamčena v době výstavby. V připojovací řetězec nejsou povoleny žádné změny.

Když se metadata načtou, EntityConnection ověří, že jsou k dispozici koncepční model, model úložiště a soubor mapování.

Platí pro

Viz také

• Připojovací řetězce
• Připojovací řetězce (Entity Framework)