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

Im folgenden Beispiel wird die Verwendung von EntityConnectionStringBuilder in Verbindung mit einem SqlConnectionStringBuilder veranschaulicht. Der Code legt eigenschaften eines SqlConnectionStringBuilder fest, um eine Zeichenfolge zu erstellen, die einen SqlConnection Teil des zugrunde liegenden Anbieters Verbindungszeichenfolge bereitstellt. Beachten Sie, dass der Provider Name nicht mithilfe SqlConnectionStringBuildervon 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

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

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

Name=AdventureWorksEntities;

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

Die Schlüsselwort-Wert-Paare können auch direkt in der ConnectionString-Eigenschaft bereitgestellt werden, wie im folgenden Beispiel dargestellt. In diesem Fall wird die Name Schlüsselwort (keyword) 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 und ObjectContext nicht versehentlich mit ihren Metadaten synchronisiert werden, EntityConnection müssen die Metadaten gesperrt werden. Nach dem Sperren der Metadaten sind keine Änderungen am Verbindungszeichenfolge zulässig. Im Folgenden sind zwei Szenarien aufgeführt, in denen Metadaten gesperrt sind:

• Die EntityConnection instance wird über den parameterlosen Konstruktor oder über 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. Durch aufrufen Open oder sperren Sie GetMetadataWorkspace die Metadaten.

• Die EntityConnection instance wird über den -Konstruktor erstellt, der EntityConnection(MetadataWorkspace, DbConnection) ein MetadataWorkspace und ein DbConnectionakzeptiert. In diesem Fall werden die Metadaten zur Erstellungszeit gesperrt. Es sind keine Änderungen am Verbindungszeichenfolge zulässig.

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

Gilt für:

Weitere Informationen

• Verbindungszeichenfolgen
• Verbindungszeichenfolgen (Entity Framework)