EntityConnectionStringBuilder Класс

Определение

Предоставляет простой способ создания строк соединений, используемых EntityClient, и управления их содержимым.Provides a simple way to create and manage the contents of connection strings used by the 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
Наследование
EntityConnectionStringBuilder

Примеры

В следующем примере показано использование класса EntityConnectionStringBuilder в сочетании с классом SqlConnectionStringBuilder.The following example demonstrates how to use the EntityConnectionStringBuilder in conjunction with a 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

Комментарии

Построитель строк соединения позволяет разработчикам создавать синтаксически правильные строки соединения программным образом, а также проводить синтаксический анализ существующих строк соединения и перестраивать их с помощью свойств и методов этого класса.The connection string builder lets developers programmatically create syntactically correct connection strings, and parse and rebuild existing connection strings, by using properties and methods of the class. Построитель строк соединения предоставляет свойства со строгой типизацией, соответствующие известным парам «ключ-значение».The connection string builder provides strongly typed properties corresponding to the known keyword/value pairs. Разработчики, создающие строки соединения в рамках приложений, с помощью класса EntityConnectionStringBuilder могут создавать и изменять строки соединения.Developers who must create connection strings as part of applications can use the EntityConnectionStringBuilder class to build and modify connection strings.

Класс EntityConnectionStringBuilder проводит проверку допустимости пар «ключ-значение», к каждой из которых предоставляется доступ через значение свойства класса EntityConnectionStringBuilder.The EntityConnectionStringBuilder performs checks for valid keyword/value pairs, each of which is exposed as a EntityConnectionStringBuilder property value.

Примечание

Строка подключения для базового источника данных предоставляется ProviderConnectionString свойством.The connection string for the underlying data source is supplied by the ProviderConnectionString property. Предоставляемая строка соединения с поставщиком не проверяется на допустимость пар «ключ-значение».The supplied provider connection string is not checked for valid keyword/value pairs.

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

EntityConnectionStringBuilder()

Инициализирует новый экземпляр класса EntityConnectionStringBuilder.Initializes a new instance of the EntityConnectionStringBuilder class.

EntityConnectionStringBuilder(String)

Инициализирует новый экземпляр класса EntityConnectionStringBuilder с помощью указанной строки соединения.Initializes a new instance of the EntityConnectionStringBuilder class using the supplied connection string.

Свойства

BrowsableConnectionString

Возвращает или задает значение, указывающее, отображается ли свойство ConnectionString в конструкторах Visual Studio.Gets or sets a value that indicates whether the ConnectionString property is visible in Visual Studio designers.

(Унаследовано от DbConnectionStringBuilder)
ConnectionString

Возвращает или задает строку подключения, связанную с этим DbConnectionStringBuilder.Gets or sets the connection string associated with the DbConnectionStringBuilder.

(Унаследовано от DbConnectionStringBuilder)
Count

Возвращает текущее количество ключей, содержащихся в свойстве ConnectionString.Gets the current number of keys that are contained within the ConnectionString property.

(Унаследовано от DbConnectionStringBuilder)
IsFixedSize

Возвращает значение, показывающее, имеет ли объект EntityConnectionStringBuilder фиксированный размер.Gets a value that indicates whether the EntityConnectionStringBuilder has a fixed size.

IsReadOnly

Получает значение, указывающее, доступен ли объект DbConnectionStringBuilder только для чтения.Gets a value that indicates whether the DbConnectionStringBuilder is read-only.

(Унаследовано от DbConnectionStringBuilder)
Item[String]

Возвращает или задает значение, связанное с указанным ключом.Gets or sets the value associated with the specified key. В языке C# это свойство является индексатором.In C#, this property is the indexer.

Keys

Возвращает коллекцию ICollection, которая содержит ключи из EntityConnectionStringBuilder.Gets an ICollection that contains the keys in the EntityConnectionStringBuilder.

Metadata

Возвращает или задает расположение метаданных в строке соединения.Gets or sets the metadata locations in the connection string.

Name

Возвращает или задает имя раздела, заданное в файле конфигурации.Gets or sets the name of a section as defined in a configuration file.

Provider

Возвращает или задает имя базового поставщика данных .NET Framework.NET Framework в строке соединения.Gets or sets the name of the underlying .NET Framework.NET Framework data provider in the connection string.

ProviderConnectionString

Возвращает или задает внутреннюю, специфичную для данного поставщика строку соединения.Gets or sets the inner, provider-specific connection string.

Values

Возвращает коллекцию ICollection, которая содержит значения в DbConnectionStringBuilder.Gets an ICollection that contains the values in the DbConnectionStringBuilder.

(Унаследовано от DbConnectionStringBuilder)

Методы

Add(String, Object)

Добавляет запись с указанными ключом и значением в DbConnectionStringBuilder.Adds an entry with the specified key and value into the DbConnectionStringBuilder.

(Унаследовано от DbConnectionStringBuilder)
Clear()

Удаляет содержимое экземпляра EntityConnectionStringBuilder.Clears the contents of the EntityConnectionStringBuilder instance.

ClearPropertyDescriptors()

Очищает коллекцию объектов PropertyDescriptor в связанном DbConnectionStringBuilder.Clears the collection of PropertyDescriptor objects on the associated DbConnectionStringBuilder.

(Унаследовано от DbConnectionStringBuilder)
ContainsKey(String)

Определяет, содержит ли объект EntityConnectionStringBuilder указанный ключ.Determines whether the EntityConnectionStringBuilder contains a specific key.

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
EquivalentTo(DbConnectionStringBuilder)

Сравнивает сведения о подключении в этом объекте DbConnectionStringBuilder со сведениями о подключении в предоставленном объекте.Compares the connection information in this DbConnectionStringBuilder object with the connection information in the supplied object.

(Унаследовано от DbConnectionStringBuilder)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetProperties(Hashtable)

Заполняет указанный Hashtable сведениями обо всех свойствах данного DbConnectionStringBuilder.Fills a supplied Hashtable with information about all the properties of this DbConnectionStringBuilder.

(Унаследовано от DbConnectionStringBuilder)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
Remove(String)

Удаляет из экземпляра EntityConnectionStringBuilder запись с указанным ключом.Removes the entry with the specified key from the EntityConnectionStringBuilder instance.

ShouldSerialize(String)

Указывает, существует ли заданный ключ в этом экземпляре DbConnectionStringBuilder.Indicates whether the specified key exists in this DbConnectionStringBuilder instance.

(Унаследовано от DbConnectionStringBuilder)
ToString()

Возвращает строку подключения, связанную с этим DbConnectionStringBuilder.Returns the connection string associated with this DbConnectionStringBuilder.

(Унаследовано от DbConnectionStringBuilder)
TryGetValue(String, Object)

Получает значение, соответствующее заданному ключу, из данного объекта EntityConnectionStringBuilder.Retrieves a value corresponding to the supplied key from this EntityConnectionStringBuilder.

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

ICollection.CopyTo(Array, Int32)

Копирует элементы коллекции ICollection в массив Array, начиная с указанного индекса массива Array.Copies the elements of the ICollection to an Array, starting at a particular Array index.

(Унаследовано от DbConnectionStringBuilder)
ICollection.IsSynchronized

Получает значение, показывающее, является ли доступ к коллекции ICollection синхронизированным (потокобезопасным).Gets a value indicating whether access to the ICollection is synchronized (thread safe).

(Унаследовано от DbConnectionStringBuilder)
ICollection.SyncRoot

Получает объект, с помощью которого можно синхронизировать доступ к коллекции ICollection.Gets an object that can be used to synchronize access to the ICollection.

(Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()

Возвращает коллекцию настраиваемых атрибутов для этого экземпляра компонента.Returns a collection of custom attributes for this instance of a component.

(Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()

Возвращает имя класса для этого экземпляра компонента.Returns the class name of this instance of a component.

(Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()

Возвращает имя этого экземпляра компонента.Returns the name of this instance of a component.

(Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()

Возвращает преобразователь типов для этого экземпляра компонента.Returns a type converter for this instance of a component.

(Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()

Возвращает событие по умолчанию для данного экземпляра компонента.Returns the default event for this instance of a component.

(Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()

Возвращает свойство по умолчанию для данного экземпляра компонента.Returns the default property for this instance of a component.

(Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)

Возвращает редактор указанного типа для данного экземпляра компонента.Returns an editor of the specified type for this instance of a component.

(Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()

Возвращает события данного экземпляра компонента.Returns the events for this instance of a component.

(Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])

Возвращает события для этого экземпляра компонента с помощью заданного массива атрибутов в качестве фильтра.Returns the events for this instance of a component using the specified attribute array as a filter.

(Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()

Возвращает свойства данного экземпляра компонента.Returns the properties for this instance of a component.

(Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])

Возвращает свойства для этого экземпляра компонента с помощью массива атрибутов в качестве фильтра.Returns the properties for this instance of a component using the attribute array as a filter.

(Унаследовано от DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)

Возвращает объект, содержащий свойство, которое описывается указанным дескриптором свойства.Returns an object that contains the property described by the specified property descriptor.

(Унаследовано от DbConnectionStringBuilder)
IDictionary.Add(Object, Object)

Добавляет элемент с указанными ключом и значением в объект IDictionary.Adds an element with the provided key and value to the IDictionary object.

(Унаследовано от DbConnectionStringBuilder)
IDictionary.Contains(Object)

Определяет, содержится ли элемент с указанным ключом в объекте IDictionary.Determines whether the IDictionary object contains an element with the specified key.

(Унаследовано от DbConnectionStringBuilder)
IDictionary.GetEnumerator()

Возвращает объект IDictionaryEnumerator для объекта IDictionary.Returns an IDictionaryEnumerator object for the IDictionary object.

(Унаследовано от DbConnectionStringBuilder)
IDictionary.IsFixedSize (Унаследовано от DbConnectionStringBuilder)
IDictionary.IsReadOnly (Унаследовано от DbConnectionStringBuilder)
IDictionary.Item[Object]

Возвращает или задает элемент с указанным ключом.Gets or sets the element with the specified key.

(Унаследовано от DbConnectionStringBuilder)
IDictionary.Remove(Object)

Удаляет элемент с указанным ключом из объекта IDictionary.Removes the element with the specified key from the IDictionary object.

(Унаследовано от DbConnectionStringBuilder)
IEnumerable.GetEnumerator()

Возвращает перечислитель для прохода по коллекции.Returns an enumerator that iterates through a collection.

(Унаследовано от DbConnectionStringBuilder)

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

Cast<TResult>(IEnumerable)

Приводит элементы объекта IEnumerable к заданному типу.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Позволяет осуществлять параллельный запрос.Enables parallelization of a query.

AsQueryable(IEnumerable)

Преобразовывает коллекцию IEnumerable в объект IQueryable.Converts an IEnumerable to an IQueryable.

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

Дополнительно