EntityConnection.ConnectionString Eigenschaft

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

Eigenschaftswert

Die verbindungszeichenfolge, die zum Herstellen der ersten Verbindung mit einer Datenquelle erforderlich ist. Der Standardwert ist eine leere Zeichenfolge. Bei einer geschlossenen Verbindung wird der aktuell festgelegte Wert zurückgegeben. Wenn kein Wert festgelegt wurde, wird eine leere Zeichenfolge zurückgegeben.

Ausnahmen

Beispiele

Das folgende Beispiel veranschaulicht die Verwendung der EntityConnectionStringBuilder in Verbindung mit einem SqlConnectionStringBuilder. Der Code legt die Eigenschaften eines Typs SqlConnectionStringBuilder fest, um eine SqlConnection Zeichenfolge zu erstellen, die einen Teil der zugrunde liegenden Anbieterverbindungszeichenfolge bereitstellt. Beachten Sie, dass der Name nicht mithilfe des ProviderSqlConnectionStringBuilderNamens festgelegt werden kann, da er keine gültige SqlConnection Syntax verwendet. Der Code erstellt die EntityConnection Zeichenfolge durch Festlegen EntityConnectionStringBuilder von Eigenschaften.

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

Hinweise

Eine EntityClient Verbindungszeichenfolge besteht aus einer Sequenz von Schlüsselwort-Wert-Parameterpaaren, die durch Semikolons getrennt sind. Das Gleichheitszeichen (=) verbindet jedes Schlüsselwort und seinen Wert. Die folgende Tabelle enthält die gültigen Namen für Schlüsselwortwerte im ConnectionString.

Die Anwendung kann das Schlüsselwort/die Werte direkt in der ConnectionString Eigenschaft angeben oder einen Wert für das Name Schlüsselwort angeben. Wenn das Name Schlüsselwort angegeben ist, werden das Schlüsselwort/die Werte der Verbindungszeichenfolge aus einer Anwendungskonfigurationsdatei wie folgt abgerufen:

Name=AdventureWorksEntities;

Wenn das Name Schlüsselwort in der ConnectionString Eigenschaft verwendet wird, sind andere Schlüsselwörter nicht zulässig. Das Name Schlüsselwort bezieht sich auf eine benannte Verbindungszeichenfolge, die connectionStrings im Abschnitt in einer Anwendungskonfigurationsdatei gespeichert ist, wie im folgenden Beispiel gezeigt. Die ProviderWerte Metadataund Werte Provider Connection String werden zur Laufzeit aus der Konfigurationsdatei abgerufen.

Die Schlüsselwort-Wert-Paare können auch direkt in der ConnectionString Eigenschaft angegeben werden, wie im folgenden Beispiel gezeigt. In diesem Fall wird das Name Schlüsselwort nicht verwendet.

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

Um zu vermeiden, dass Objekte wie System.Data.Common.CommandTrees z. B. und ObjectContext nicht mehr mit ihren Metadaten synchronisiert werden, EntityConnection müssen sie die Metadaten sperren. Nach dem Sperren der Metadaten sind keine Änderungen an der Verbindungszeichenfolge zulässig. Es folgen zwei Szenarien, in denen Metadaten gesperrt sind:

• Die EntityConnection Instanz wird über den parameterlosen Konstruktor oder den Konstruktor erstellt, der EntityConnection(String) eine Verbindungszeichenfolge akzeptiert. In beiden Fällen kann die Verbindungszeichenfolge mehrmals geändert werden, bevor die Verbindung geöffnet wird. Das Aufrufen Open oder GetMetadataWorkspace Sperren der Metadaten.

• Die EntityConnection Instanz wird über den EntityConnection(MetadataWorkspace, DbConnection) Konstruktor erstellt, der ein MetadataWorkspace und ein DbConnection. In diesem Fall sind die Metadaten zur Bauzeit gesperrt. Es sind keine Änderungen an der Verbindungszeichenfolge zulässig.

Beim Laden von Metadaten wird überprüft, EntityConnection ob das konzeptionelle Modell, das Speichermodell und die Zuordnungsdatei vorhanden sind.

Weitere Informationen

• Verbindungszeichenfolgen
• Verbindungszeichenfolgen (Entity Framework)