EntityConnectionStringBuilder Osztály

Definíció

Névtér:

System.Data.EntityClient

Szerelvény:

System.Data.Entity.dll

Egyszerű módot kínál az EntityClient által használt kapcsolati sztringek tartalmának létrehozására és kezelésére.

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

Öröklődés

Object

DbConnectionStringBuilder

EntityConnectionStringBuilder

Példák

Az alábbi példa bemutatja, hogyan használható a EntityConnectionStringBuilderSqlConnectionStringBuilder.

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

Megjegyzések

A kapcsolati karakterlánc szerkesztő lehetővé teszi a fejlesztők számára a szintaktikailag helyes kapcsolati sztringek programozott létrehozását, valamint a meglévő kapcsolati sztringek elemzését és újraépítését az osztály tulajdonságainak és módszereinek használatával. A kapcsolati karakterlánc szerkesztő az ismert kulcsszó-érték pároknak megfelelő, erősen gépelt tulajdonságokat biztosít. Azok a fejlesztők, akiknek az alkalmazások részeként létre kell hozniuk a kapcsolati sztringeket, használhatják az osztályt a EntityConnectionStringBuilder kapcsolati sztringek létrehozására és módosítására.

A EntityConnectionStringBuilder függvény ellenőrzi az érvényes kulcsszó-/érték párokat, amelyek mindegyike tulajdonságértékként EntityConnectionStringBuilder jelenik meg.

Note

A mögöttes adatforrás kapcsolati karakterlánc a ProviderConnectionString tulajdonság adja meg. A megadott szolgáltatói kapcsolati karakterlánc nincs bejelölve érvényes kulcsszó/érték pár.

Konstruktorok

Name	Description
EntityConnectionStringBuilder()	Inicializálja a EntityConnectionStringBuilder osztály új példányát.
EntityConnectionStringBuilder(String)	Inicializálja a EntityConnectionStringBuilder osztály új példányát a megadott kapcsolati karakterlánc használatával.

Tulajdonságok

Name	Description
BrowsableConnectionString	Olyan értéket kap vagy állít be, amely jelzi, hogy a ConnectionString tulajdonság látható-e Visual Studio tervezőkben. (Öröklődés forrása DbConnectionStringBuilder)
ConnectionString	Lekéri vagy beállítja a DbConnectionStringBuilder társított kapcsolati karakterlánc. (Öröklődés forrása DbConnectionStringBuilder)
Count	Lekéri a tulajdonságban ConnectionString található kulcsok aktuális számát. (Öröklődés forrása DbConnectionStringBuilder)
IsFixedSize	Olyan értéket kap, amely jelzi, hogy a EntityConnectionStringBuilder méret rögzített-e.
IsReadOnly	Olyan értéket kap, amely jelzi, hogy az DbConnectionStringBuilder írásvédett-e. (Öröklődés forrása DbConnectionStringBuilder)
Item[String]	Lekéri vagy beállítja a megadott kulccsal társított értéket. A C#-ban ez a tulajdonság az indexelő.
Keys	ICollection Lekéri azokat a kulcsokat, amelyek a EntityConnectionStringBuilder.
Metadata	Lekéri vagy beállítja a metaadat-helyeket a kapcsolati karakterlánc.
Name	Lekéri vagy beállítja egy szakasz nevét egy konfigurációs fájlban meghatározott módon.
Provider	Lekéri vagy beállítja a mögöttes .NET-keretrendszer adatszolgáltatójának nevét a kapcsolati karakterlánc.
ProviderConnectionString	Lekéri vagy beállítja a belső, szolgáltatóspecifikus kapcsolati karakterlánc.
Values	ICollection Lekéri a értékét tartalmazó értéket.DbConnectionStringBuilder (Öröklődés forrása DbConnectionStringBuilder)

Metódusok

Name	Description
Add(String, Object)	A megadott kulccsal és értékkel rendelkező bejegyzést ad hozzá a DbConnectionStringBuilder. (Öröklődés forrása DbConnectionStringBuilder)
Clear()	Törli a példány tartalmát EntityConnectionStringBuilder .
ClearPropertyDescriptors()	Törli a társított PropertyDescriptorobjektumgyűjteménytDbConnectionStringBuilder. (Öröklődés forrása DbConnectionStringBuilder)
ContainsKey(String)	Meghatározza, hogy a EntityConnectionStringBuilder kulcs tartalmaz-e egy adott kulcsot.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
EquivalentTo(DbConnectionStringBuilder)	Összehasonlítja az objektum kapcsolati adatait DbConnectionStringBuilder a megadott objektum kapcsolati adataival. (Öröklődés forrása DbConnectionStringBuilder)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetProperties(Hashtable)	Kitölti a megadott Hashtable adatokat ennek minden tulajdonságáról DbConnectionStringBuilder. (Öröklődés forrása DbConnectionStringBuilder)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
Remove(String)	Eltávolítja a megadott kulccsal rendelkező bejegyzést a EntityConnectionStringBuilder példányból.
ShouldSerialize(String)	Azt jelzi, hogy a megadott kulcs létezik-e ebben a DbConnectionStringBuilder példányban. (Öröklődés forrása DbConnectionStringBuilder)
ToString()	A DbConnectionStringBuilder társított kapcsolati karakterlánc adja vissza. (Öröklődés forrása DbConnectionStringBuilder)
TryGetValue(String, Object)	A megadott kulcsnak megfelelő értéket kér le ebből.EntityConnectionStringBuilder

Explicit interfész-implementációk

Name	Description
ICollection.CopyTo(Array, Int32)	Az elemeket ICollection egy adott indextől kezdve másolja Arrayegy adott Array indexbe. (Öröklődés forrása DbConnectionStringBuilder)
ICollection.IsSynchronized	Beolvas egy értéket, amely jelzi, hogy a ICollection hozzáférés szinkronizálva van-e (a szál biztonságos). (Öröklődés forrása DbConnectionStringBuilder)
ICollection.SyncRoot	Lekéri az objektumot, amely a hozzáférés szinkronizálására használható.ICollection (Öröklődés forrása DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()	Egy összetevő jelen példányához tartozó egyéni attribútumok gyűjteményét adja vissza. (Öröklődés forrása DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()	Egy összetevő példányának osztálynevét adja vissza. (Öröklődés forrása DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()	Egy összetevő példányának nevét adja vissza. (Öröklődés forrása DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()	Egy összetevő jelen példányához tartozó típuskonvertert ad vissza. (Öröklődés forrása DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()	Egy összetevő jelen példányának alapértelmezett eseményét adja vissza. (Öröklődés forrása DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()	Az összetevő jelen példányának alapértelmezett tulajdonságát adja vissza. (Öröklődés forrása DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)	Egy adott típusú szerkesztőt ad vissza egy összetevő jelen példányához. (Öröklődés forrása DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()	Egy összetevő jelen példányának eseményeit adja vissza. (Öröklődés forrása DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])	Egy összetevő jelen példányának eseményeit adja vissza, szűrőként a megadott attribútumtömböt használva. (Öröklődés forrása DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()	Egy összetevő jelen példányának tulajdonságait adja vissza. (Öröklődés forrása DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])	Egy összetevő jelen példányának tulajdonságait adja vissza, amely szűrőként használja az attribútumtömböt. (Öröklődés forrása DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)	A megadott tulajdonságleíró által leírt tulajdonságot tartalmazó objektumot ad vissza. (Öröklődés forrása DbConnectionStringBuilder)
IDictionary.Add(Object, Object)	Hozzáad egy elemet a megadott kulccsal és értékkel az IDictionary objektumhoz. (Öröklődés forrása DbConnectionStringBuilder)
IDictionary.Contains(Object)	Meghatározza, hogy az IDictionary objektum tartalmaz-e a megadott kulccsal rendelkező elemet. (Öröklődés forrása DbConnectionStringBuilder)
IDictionary.GetEnumerator()	IDictionaryEnumerator Az objektum objektumát IDictionary adja vissza. (Öröklődés forrása DbConnectionStringBuilder)
IDictionary.Item[Object]	Lekéri vagy beállítja az elemet a megadott kulccsal. (Öröklődés forrása DbConnectionStringBuilder)
IDictionary.Remove(Object)	Eltávolítja a megadott kulccsal rendelkező elemet az IDictionary objektumból. (Öröklődés forrása DbConnectionStringBuilder)
IEnumerable.GetEnumerator()	Egy gyűjteményen keresztül iteráló enumerátort ad vissza. (Öröklődés forrása DbConnectionStringBuilder)

Bővítő metódusok

Name	Description
AsParallel(IEnumerable)	Lehetővé teszi a lekérdezés párhuzamosítását.
AsQueryable(IEnumerable)	Átalakítja az egyiket IEnumerableIQueryable.
Cast<TResult>(IEnumerable)	Egy elem elemeit IEnumerable a megadott típusra veti.
OfType<TResult>(IEnumerable)	Egy adott típus alapján szűri IEnumerable egy adott elem elemeit.

Lásd még

• EntityConnection
• Kapcsolati karakterláncok
• Az EntityClient használata