EntityConnectionStringBuilder Класс

Определение

Пространство имен:: System.Data.EntityClient

Сборка:: System.Data.Entity.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Предоставляет простой способ создания и управления содержимым строк подключения, используемых EntityClient.

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

Наследование: Object

DbConnectionStringBuilder
EntityConnectionStringBuilder

Примеры

В следующем примере показано, как использовать EntityConnectionStringBuilder его в сочетании с SqlConnectionStringBuilder.


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

Построитель строк подключения позволяет разработчикам программно создавать синтаксически правильные строки подключения, а также анализировать и перестроить существующие строки подключения с помощью свойств и методов класса. Построитель строк подключения предоставляет строго типизированные свойства, соответствующие известным парам ключевых слов и значений. Разработчики, которые должны создавать строки подключения в составе приложений, могут использовать EntityConnectionStringBuilder класс для создания и изменения строк подключения.

Выполняет EntityConnectionStringBuilder проверку допустимых пар ключевых слов и значений, каждая из которых предоставляется в качестве EntityConnectionStringBuilder значения свойства.

Замечание

Строка подключения для базового источника данных предоставляется свойством ProviderConnectionString . Указанная строка подключения поставщика не проверяется на наличие допустимых пар ключевых слов и значений.

Конструкторы

Имя	Описание
EntityConnectionStringBuilder()	Инициализирует новый экземпляр класса EntityConnectionStringBuilder.
EntityConnectionStringBuilder(String)	Инициализирует новый экземпляр класса с помощью предоставленной EntityConnectionStringBuilder строки подключения.

Свойства

Имя	Описание
BrowsableConnectionString	Возвращает или задает значение, указывающее, отображается ли ConnectionString свойство в конструкторах Visual Studio. (Унаследовано от DbConnectionStringBuilder)
ConnectionString	Возвращает или задает строку подключения, связанную с .DbConnectionStringBuilder (Унаследовано от DbConnectionStringBuilder)
Count	Возвращает текущее количество ключей, содержащихся в свойстве ConnectionString . (Унаследовано от DbConnectionStringBuilder)
IsFixedSize	Возвращает значение, указывающее, имеет ли EntityConnectionStringBuilder размер фиксированного размера.
IsReadOnly	Возвращает значение, указывающее, доступен ли доступ DbConnectionStringBuilder только для чтения. (Унаследовано от DbConnectionStringBuilder)
Item[String]	Возвращает или задает значение, связанное с указанным ключом. В C#это свойство является индексатором.
Keys	Возвращает объект ICollection , содержащий ключи в объекте EntityConnectionStringBuilder.
Metadata	Возвращает или задает расположения метаданных в строке подключения.
Name	Возвращает или задает имя раздела, как определено в файле конфигурации.
Provider	Возвращает или задает имя базового поставщика данных .NET Framework в строке подключения.
ProviderConnectionString	Возвращает или задает внутреннюю строку подключения для конкретного поставщика.
Values	Возвращает значение ICollection , содержащее значения в объекте DbConnectionStringBuilder. (Унаследовано от DbConnectionStringBuilder)

Методы

Имя	Описание
Add(String, Object)	Добавляет запись с указанным ключом и значением в объект DbConnectionStringBuilder. (Унаследовано от DbConnectionStringBuilder)
Clear()	Очищает содержимое экземпляра EntityConnectionStringBuilder .
ClearPropertyDescriptors()	Очищает коллекцию PropertyDescriptor объектов в связанном DbConnectionStringBuilderобъекте. (Унаследовано от DbConnectionStringBuilder)
ContainsKey(String)	Определяет, содержит ли EntityConnectionStringBuilder определенный ключ.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
EquivalentTo(DbConnectionStringBuilder)	Сравнивает сведения о подключении в этом DbConnectionStringBuilder объекте с сведениями о подключении в предоставленном объекте. (Унаследовано от DbConnectionStringBuilder)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetProperties(Hashtable)	Заполняет предоставленные Hashtable сведения обо всех свойствах этого DbConnectionStringBuilder. (Унаследовано от DbConnectionStringBuilder)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
Remove(String)	Удаляет запись с указанным ключом из экземпляра EntityConnectionStringBuilder .
ShouldSerialize(String)	Указывает, существует ли указанный ключ в этом DbConnectionStringBuilder экземпляре. (Унаследовано от DbConnectionStringBuilder)
ToString()	Возвращает строку подключения, связанную с этим DbConnectionStringBuilder. (Унаследовано от DbConnectionStringBuilder)
TryGetValue(String, Object)	Извлекает значение, соответствующее предоставленному ключу, из этого EntityConnectionStringBuilder.

Явные реализации интерфейса

Имя	Описание
ICollection.CopyTo(Array, Int32)	Копирует элементы объекта ICollection Arrayв определенный индекс, начиная с определенного Array индекса. (Унаследовано от DbConnectionStringBuilder)
ICollection.IsSynchronized	Возвращает значение, указывающее, синхронизирован ли доступ к ICollection синхронизированному (потокобезопасно). (Унаследовано от DbConnectionStringBuilder)
ICollection.SyncRoot	Получает объект, который можно использовать для синхронизации доступа к объекту ICollection. (Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()	Возвращает коллекцию настраиваемых атрибутов для этого экземпляра компонента. (Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()	Возвращает имя класса этого экземпляра компонента. (Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()	Возвращает имя этого экземпляра компонента. (Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()	Возвращает преобразователь типов для этого экземпляра компонента. (Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()	Возвращает событие по умолчанию для этого экземпляра компонента. (Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()	Возвращает свойство по умолчанию для этого экземпляра компонента. (Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)	Возвращает редактор указанного типа для этого экземпляра компонента. (Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()	Возвращает события для этого экземпляра компонента. (Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])	Возвращает события для этого экземпляра компонента, используя указанный массив атрибутов в качестве фильтра. (Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()	Возвращает свойства для этого экземпляра компонента. (Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])	Возвращает свойства для этого экземпляра компонента с помощью массива атрибутов в качестве фильтра. (Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)	Возвращает объект, содержащий свойство, описанное указанным дескриптором свойства. (Унаследовано от DbConnectionStringBuilder)
IDictionary.Add(Object, Object)	Добавляет элемент с предоставленным ключом и значением в IDictionary объект. (Унаследовано от DbConnectionStringBuilder)
IDictionary.Contains(Object)	Определяет, содержит ли IDictionary объект элемент с указанным ключом. (Унаследовано от DbConnectionStringBuilder)
IDictionary.GetEnumerator()	IDictionaryEnumerator Возвращает объект для IDictionary объекта. (Унаследовано от DbConnectionStringBuilder)
IDictionary.Item[Object]	Возвращает или задает элемент с указанным ключом. (Унаследовано от DbConnectionStringBuilder)
IDictionary.Remove(Object)	Удаляет элемент с указанным ключом из IDictionary объекта. (Унаследовано от DbConnectionStringBuilder)
IEnumerable.GetEnumerator()	Возвращает перечислитель, который выполняет итерацию по коллекции. (Унаследовано от DbConnectionStringBuilder)

Методы расширения

Имя	Описание
AsParallel(IEnumerable)	Включает параллелизацию запроса.
AsQueryable(IEnumerable)	Преобразует IEnumerable в IQueryable.
Cast<TResult>(IEnumerable)	Приведение элементов IEnumerable к указанному типу.
OfType<TResult>(IEnumerable)	Фильтрует элементы IEnumerable на основе указанного типа.

Применяется к

См. также раздел

Обратная связь

Были ли сведения на этой странице полезными?

Поделиться через