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 (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 |
Возвращает значение Boolean, указывающее, поддерживает ли соединение транзакции координатора распределенных транзакций Майкрософт (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. |