EntityConnectionStringBuilder Sınıf

Tanım

Ad Alanı:

System.Data.EntityClient

Bütünleştirilmiş Kod:

System.Data.Entity.dll

EntityClient tarafından kullanılan bağlantı dizelerinin içeriğini oluşturmak ve yönetmek için basit bir yol sağlar.

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

Devralma

Object

DbConnectionStringBuilder

EntityConnectionStringBuilder

Örnekler

Aşağıdaki örnekte ile SqlConnectionStringBuilderbirlikte nasıl kullanılacağı EntityConnectionStringBuilder gösterilmektedir.

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

Açıklamalar

Bağlantı dizesi oluşturucusu, geliştiricilerin program aracılığıyla el dizimsel olarak doğru bağlantı dizeleri oluşturmasına ve sınıfın özelliklerini ve yöntemlerini kullanarak mevcut bağlantı dizelerini ayrıştırıp yeniden oluşturmasına olanak tanır. Bağlantı dizesi oluşturucusu, bilinen anahtar sözcük/değer çiftlerine karşılık gelen kesin olarak belirlenmiş özellikler sağlar. Uygulamaların bir parçası olarak bağlantı dizeleri oluşturması gereken geliştiriciler, bağlantı dizelerini oluşturmak ve değiştirmek için sınıfını kullanabilir EntityConnectionStringBuilder .

, EntityConnectionStringBuilder her biri bir EntityConnectionStringBuilder özellik değeri olarak kullanıma sunulan geçerli anahtar sözcük/değer çiftleri için denetimler gerçekleştirir.

Uyarı

Temel alınan veri kaynağının bağlantı dizesi özelliği tarafından ProviderConnectionString sağlanır. Sağlanan sağlayıcı bağlantı dizesi geçerli anahtar sözcük/değer çiftleri için denetlenmiyor.

Oluşturucular

Name	Description
EntityConnectionStringBuilder()	EntityConnectionStringBuilder sınıfının yeni bir örneğini başlatır.
EntityConnectionStringBuilder(String)	Sağlanan bağlantı dizesini EntityConnectionStringBuilder kullanarak sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
BrowsableConnectionString	Özelliğin Visual Studio tasarımcılarında görünür olup olmadığını ConnectionString gösteren bir değer alır veya ayarlar. (Devralındığı yer: DbConnectionStringBuilder)
ConnectionString	ile DbConnectionStringBuilderilişkili bağlantı dizesini alır veya ayarlar. (Devralındığı yer: DbConnectionStringBuilder)
Count	Özelliğinde yer alan ConnectionString geçerli anahtar sayısını alır. (Devralındığı yer: DbConnectionStringBuilder)
IsFixedSize	EntityConnectionStringBuilder sabit bir boyuta sahip olup olmadığını gösteren bir değer alır.
IsReadOnly	DbConnectionStringBuilder salt okunur olup olmadığını gösteren bir değer alır. (Devralındığı yer: DbConnectionStringBuilder)
Item[String]	Belirtilen anahtarla ilişkili değeri alır veya ayarlar. C# dilinde bu özellik dizin oluşturucudur.
Keys	içindeki EntityConnectionStringBuilderanahtarları içeren bir ICollection alır.
Metadata	Bağlantı dizesindeki meta veri konumlarını alır veya ayarlar.
Name	Yapılandırma dosyasında tanımlanan bölümün adını alır veya ayarlar.
Provider	Bağlantı dizesinde temel alınan .NET Framework veri sağlayıcısının adını alır veya ayarlar.
ProviderConnectionString	İç, sağlayıcıya özgü bağlantı dizesini alır veya ayarlar.
Values	içindeki DbConnectionStringBuilderdeğerleri içeren bir ICollection alır. (Devralındığı yer: DbConnectionStringBuilder)

Yöntemler

Name	Description
Add(String, Object)	öğesine belirtilen anahtar ve değere DbConnectionStringBuildersahip bir girdi ekler. (Devralındığı yer: DbConnectionStringBuilder)
Clear()	Örneğin içeriğini EntityConnectionStringBuilder temizler.
ClearPropertyDescriptors()	İlişkili DbConnectionStringBuilderüzerindeki nesne koleksiyonunu PropertyDescriptor temizler. (Devralındığı yer: DbConnectionStringBuilder)
ContainsKey(String)	öğesinin EntityConnectionStringBuilder belirli bir anahtar içerip içermediğini belirler.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
EquivalentTo(DbConnectionStringBuilder)	Bu DbConnectionStringBuilder nesnedeki bağlantı bilgilerini sağlanan nesnedeki bağlantı bilgileriyle karşılaştırır. (Devralındığı yer: DbConnectionStringBuilder)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetProperties(Hashtable)	Sağlanan Hashtable bir öğesini bu DbConnectionStringBuilderöğesinin tüm özellikleriyle ilgili bilgilerle doldurur. (Devralındığı yer: DbConnectionStringBuilder)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
Remove(String)	Belirtilen anahtara sahip girdiyi örnekten EntityConnectionStringBuilder kaldırır.
ShouldSerialize(String)	Belirtilen anahtarın bu DbConnectionStringBuilder örnekte var olup olmadığını gösterir. (Devralındığı yer: DbConnectionStringBuilder)
ToString()	Bu DbConnectionStringBuilderile ilişkili bağlantı dizesini döndürür. (Devralındığı yer: DbConnectionStringBuilder)
TryGetValue(String, Object)	Bu EntityConnectionStringBuilderanahtarından sağlanan anahtara karşılık gelen bir değer alır.

Belirtik Arabirim Kullanımları

Name	Description
ICollection.CopyTo(Array, Int32)	öğesinin öğelerini ICollection belirli Array bir Arraydizinden başlayarak öğesine kopyalar. (Devralındığı yer: DbConnectionStringBuilder)
ICollection.IsSynchronized	'a ICollection erişimin eşitlenip eşitlenmediğini belirten bir değer alır (iş parçacığı güvenli). (Devralındığı yer: DbConnectionStringBuilder)
ICollection.SyncRoot	ICollectionerişimini eşitlemek için kullanılabilecek bir nesnesi alır. (Devralındığı yer: DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()	Bir bileşenin bu örneği için özel öznitelikler koleksiyonunu döndürür. (Devralındığı yer: DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()	Bir bileşenin bu örneğinin sınıf adını döndürür. (Devralındığı yer: DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()	Bir bileşenin bu örneğinin adını döndürür. (Devralındığı yer: DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()	Bir bileşenin bu örneği için bir tür dönüştürücü döndürür. (Devralındığı yer: DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()	Bir bileşenin bu örneği için varsayılan olayı döndürür. (Devralındığı yer: DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()	Bir bileşenin bu örneği için varsayılan özelliği döndürür. (Devralındığı yer: DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)	Bir bileşenin bu örneği için belirtilen türde bir düzenleyici döndürür. (Devralındığı yer: DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()	Bir bileşenin bu örneği için olayları döndürür. (Devralındığı yer: DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])	Belirtilen öznitelik dizisini filtre olarak kullanarak bir bileşenin bu örneği için olayları döndürür. (Devralındığı yer: DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()	Bir bileşenin bu örneğinin özelliklerini döndürür. (Devralındığı yer: DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])	Öznitelik dizisini filtre olarak kullanarak bir bileşenin bu örneğinin özelliklerini döndürür. (Devralındığı yer: DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)	Belirtilen özellik tanımlayıcısı tarafından açıklanan özelliği içeren bir nesne döndürür. (Devralındığı yer: DbConnectionStringBuilder)
IDictionary.Add(Object, Object)	Sağlanan anahtar ve değere sahip bir öğeyi nesnesine IDictionary ekler. (Devralındığı yer: DbConnectionStringBuilder)
IDictionary.Contains(Object)	Nesnenin belirtilen anahtara IDictionary sahip bir öğe içerip içermediğini belirler. (Devralındığı yer: DbConnectionStringBuilder)
IDictionary.GetEnumerator()	Nesne için IDictionary bir IDictionaryEnumerator nesne döndürür. (Devralındığı yer: DbConnectionStringBuilder)
IDictionary.Item[Object]	Belirtilen anahtarla öğesini alır veya ayarlar. (Devralındığı yer: DbConnectionStringBuilder)
IDictionary.Remove(Object)	Belirtilen anahtara sahip öğesini nesneden IDictionary kaldırır. (Devralındığı yer: DbConnectionStringBuilder)
IEnumerable.GetEnumerator()	Bir koleksiyonda yineleyen bir numaralandırıcı döndürür. (Devralındığı yer: DbConnectionStringBuilder)

Uzantı Metotları

Name	Description
AsParallel(IEnumerable)	Sorgunun paralelleştirilmesini etkinleştirir.
AsQueryable(IEnumerable)	bir IEnumerable öğesine IQueryabledönüştürür.
Cast<TResult>(IEnumerable)	öğesinin IEnumerable öğelerini belirtilen türe yazar.
OfType<TResult>(IEnumerable)	Belirtilen türe göre bir IEnumerable öğesinin öğelerini filtreler.

Ayrıca bkz.

• EntityConnection
• Bağlantı Dizeleri
• EntityClient ile çalışma