ConnectionManager Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет информацию, необходимую для подключения к источнику данных. Все классы, наследующие от , ConnectionManager содержат одни и те же свойства и методы. Класс изолирует детали ConnectionManager реализации различных типов соединений от времени выполнения. Это позволяет среде выполнения взаимодействовать с каждым менеджером соединений последовательно и предсказуемо. Менеджеры соединений содержат набор свойств запасов, которые общими для всех соединений, таких Nameкак , ID, Description, и ConnectionString. Однако каждый тип соединения обладает дополнительными свойствами, специфичными для этого типа соединения. К ним можно получить через коллекцию Properties . Этот класс не может быть унаследован.
public ref class ConnectionManager sealed : Microsoft::SqlServer::Dts::Runtime::DtsObject, IDisposable, Microsoft::SqlServer::Dts::Runtime::IDTSExecutionPath, Microsoft::SqlServer::Dts::Runtime::IDTSName, Microsoft::SqlServer::Dts::Runtime::IDTSObjectHost, Microsoft::SqlServer::Dts::Runtime::IDTSPackagePath, Microsoft::SqlServer::Dts::Runtime::IDTSPersist, Microsoft::SqlServer::Dts::Runtime::IDTSPropertiesProvider, Microsoft::SqlServer::Dts::Runtime::IDTSPropertiesProviderEx, System::ComponentModel::IComponent
public sealed class ConnectionManager : Microsoft.SqlServer.Dts.Runtime.DtsObject, IDisposable, Microsoft.SqlServer.Dts.Runtime.IDTSExecutionPath, Microsoft.SqlServer.Dts.Runtime.IDTSName, Microsoft.SqlServer.Dts.Runtime.IDTSObjectHost, Microsoft.SqlServer.Dts.Runtime.IDTSPackagePath, Microsoft.SqlServer.Dts.Runtime.IDTSPersist, Microsoft.SqlServer.Dts.Runtime.IDTSPropertiesProvider, Microsoft.SqlServer.Dts.Runtime.IDTSPropertiesProviderEx, System.ComponentModel.IComponent
type ConnectionManager = class
inherit DtsObject
interface IDTSObjectHost
interface IDTSPersist
interface IDTSName
interface IComponent
interface IDisposable
interface IDTSPropertiesProvider
interface IDTSPropertiesProviderEx
interface IDTSPackagePath
interface IDTSExecutionPath
Public NotInheritable Class ConnectionManager
Inherits DtsObject
Implements IComponent, IDisposable, IDTSExecutionPath, IDTSName, IDTSObjectHost, IDTSPackagePath, IDTSPersist, IDTSPropertiesProvider, IDTSPropertiesProviderEx
- Наследование
- Реализации
Комментарии
Менеджер соединений — это логическое представление соединения. В момент проектирования в графическом пользовательском интерфейсе вы используете менеджер соединений, чтобы описать физическое соединение, которое создаётся в процессе выполнения при запуске пакета. Integration Services предоставляет различные типы менеджеров соединений, которые позволяют пакетам подключаться к различным источникам данных. Например, есть менеджер соединений ActiveX Data Objects (ADO), менеджер соединений ADO.NET, менеджер соединений ODBC и так далее. Для получения дополнительной информации см. раздел «Расширение пакетов с пользовательскими объектами».
Свойства
| Имя | Описание |
|---|---|
| ConnectionString |
Получает или устанавливает строка подключения, используемую для установления соединения с источником данных. |
| CreationName |
Возвращает строку, используемую в процессе выполнения для создания экземпляра объекта ConnectionManager и добавления объекта в Connections коллекцию. Это свойство доступно только для чтения. |
| DelayValidation |
Получает или устанавливает булевое измерение, указывающее, задерживается ли проверка пакета до запуска пакета. |
| Description |
Получает или задаёт описание ConnectionManager объекта. |
| HasExpressions |
Получает значение, указывающее, есть ли у менеджера соединений свойства, заданные через выражения. |
| HostType |
Получает перечисление, описывающее тип хоста, которым используется соединение. Это свойство доступно только для чтения. |
| ID |
Получает идентификатор ConnectionManager. Это свойство доступно только для чтения. |
| InnerObject |
Возвращает конкретный тип соединения, который был создан. Это свойство доступно только для чтения. |
| Name |
Возвращает или задает имя ConnectionManager объекта. |
| OfflineMode |
Получает или устанавливает значение, указывающее, находится ли менеджер соединений в офлайн-режиме. |
| Properties |
Получает набор объектов свойств для ConnectionManager. Это способ доступа к свойствам конкретного соединения, которое размещается менеджером соединений. Это свойство доступно только для чтения. |
| ProtectionLevel |
Получает или устанавливает уровень шифрования, выполняемый для чувствительных данных, содержащихся в пакете. |
| Qualifier |
Получает или устанавливает квалификатор для менеджера соединений. |
| Scope |
Получает область действия менеджера соединений. |
| Site |
Получает или устанавливает сайт менеджера соединений. |
| SupportsDTCTransactions |
Возвращает булевый сигнал, который показывает, поддерживает ли соединение транзакции координатор распределенных транзакций (Майкрософт) (MS DTC). |
| VariableDispenser |
Получает диспенсер переменных в менеджере соединений. |
| Variables |
Получает коллекцию переменных в менеджере соединений. |
Методы
| Имя | Описание |
|---|---|
| AcquireConnection(Object) |
Создаёт экземпляр типа соединения. |
| Dispose() |
Освобождает ресурсы, используемые параметром ConnectionManager. |
| Equals(Object) |
Определяет, равны ли два экземпляра объекта. (Унаследовано от DtsObject) |
| GetExecutionPath() |
Возвращает путь выполнения менеджера соединений. |
| GetExpression(String) |
Возвращает строку, содержащую выражение для указанного свойства. Null означает, что выражение не было назначено. |
| GetHashCode() |
Возвращает хэш-код для этого экземпляра. (Унаследовано от DtsObject) |
| GetPackagePath() |
Получает или задаёт путь пакета, к которому применяется соединение. |
| LoadFromXML(String, IDTSEvents) |
Этот метод не может быть вызван вашим кодом приложения. Чтобы загрузить пакет, сохранённый как .xml, используйте метод.LoadPackage(String, IDTSEvents) |
| LoadFromXML(XmlNode, IDTSEvents) |
Этот метод не может быть вызван вашим кодом приложения. Чтобы загрузить пакет, сохранённый как .xml, используйте метод.LoadPackage(String, IDTSEvents) |
| ReleaseConnection(Object) |
Освобождает соединение, установленное во время AcquireConnection(Object). Вызывается во время проектирования и во время выполнения. |
| SaveToXML(XmlDocument, XmlNode, IDTSEvents) |
Этот метод не может быть вызван вашим кодом приложения. Чтобы сохранить посылку как .xml, используйте метод.SaveToXml(String, Package, IDTSEvents) |
| SetExpression(String, String) |
Присваивает указанное выражение свойству. Укажите null, чтобы удалить существующее выражение из свойства. |
| SetQualifier(String) |
Изменяет квалификатор в менеджере соединений после создания менеджера соединений, но до его использования в запускающем пакете. |
События
| Имя | Описание |
|---|---|
| Disposed |
Добавляет обработчика событий для прослушивания Disposed события на ConnectionManager. |