Variables Класс

Определение

Пространство имен:

Microsoft.SqlServer.Dts.Runtime

Сборка:

Microsoft.SqlServer.ManagedDTS.dll

Содержит коллекцию Variables объектов, доступ к которым осуществляется через несколько объектов. Этот класс не наследуется.

public ref class Variables sealed : Microsoft::SqlServer::Dts::Runtime::DTSReadOnlyCollectionBase

public sealed class Variables : Microsoft.SqlServer.Dts.Runtime.DTSReadOnlyCollectionBase

type Variables = class
    inherit DTSReadOnlyCollectionBase

Public NotInheritable Class Variables
Inherits DTSReadOnlyCollectionBase

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

Object

DTSReadOnlyCollectionBase

Variables

Комментарии

Integration Services (SSIS) предоставляет системные переменные и поддерживает пользовательские переменные. Когда вы создаёте новый пакет, добавляете контейнер или задачу в пакет, либо создаёте обработчик событий, SSIS автоматически включает набор системных переменных для этого элемента. Системные переменные всегда расположены в System пространстве имён. System Переменные содержат полезную информацию о пакете и его контейнерах, задачах и обработчиках событий. System переменные содержат информацию, такую как имя компьютера, на котором работает пакет, и время его запуска. Вы можете просматривать информацию, содержащуюся в системной переменной, но нельзя добавлять или обновлять системные переменные.

Вы также можете создавать пользовательские переменные для использования в пакетах, контейнерах, задачах, трансформациях и ограничениях приоритета. Пользовательские переменные можно создать в User пространстве имён или в выбранном вами пространстве. Пользовательские переменные могут использоваться в выражениях, которые могут содержать контейнер For Loop, преобразование Derived Column, преобразование условного разделения и ограничения по приоритету. Для получения дополнительной информации см. раздел «Использовать переменные в пакетах».

Каждый контейнер в объектной модели SSIS имеет свою Variables коллекцию. Эта коллекция доступна каждому дочернему контейнеру. Переменная доступна из коллекции с помощью её имени или индекса. Variables Коллекция в контейнере представляет собой агрегацию переменных в коллекции родительского контейнера. Variables Коллекция Package класса видна всем объектам пакета, обеспечивая глобально видимую коллекцию. В то же время переменные, содержащиеся в задаче, ограничены по охватам и видимости и видимы только в самой задаче.

Important

Используется Variables с классами Runtime. Если вы используете компоненты потока данных (Microsoft.SqlServer.Dts.Pipeline), возможно, вам потребуется использовать IDTSVariables100. Чтобы узнать, какую коллекцию переменных использовать, ознакомьтесь с документацией объекта, на котором вы получаете переменные, и проверьте возвратное значение.

Поля

Имя	Описание
m_unmanagedColl	Неуправляемая коллекция. (Унаследовано от DTSReadOnlyCollectionBase)

Свойства

Имя	Описание
Count	Возвращает количество элементов, содержащихся в экземпляре DTSReadOnlyCollectionBase . (Унаследовано от DTSReadOnlyCollectionBase)
IsSynchronized	Возвращает значение, указывающее, синхронизирован ли доступ к DTSReadOnlyCollectionBase синхронизированному (потокобезопасно). (Унаследовано от DTSReadOnlyCollectionBase)
Item[Object]	Variable Возвращает объект из Variables коллекции.
Locked	Булевый индикатор, указывающий, заблокированы ли переменные в Variables коллекции.
SyncRoot	Получает объект, который можно использовать для синхронизации доступа к объекту DTSReadOnlyCollectionBase. (Унаследовано от DTSReadOnlyCollectionBase)

Методы

Имя	Описание
Add(String, Boolean, String, Object)	Добавляет Variable объект в Variables коллекцию.
Contains(Object)	Возвращает булевый модуль, который показывает, можно ли получить доступ к элементам из коллекции с помощью индексации без исключения.
CopyTo(Array, Int32)	Копирует весь DTSReadOnlyCollectionBase совместимый одномерный массив, начиная с указанного индекса целевого массива. (Унаследовано от DTSReadOnlyCollectionBase)
CreateManagedObject(Object)	Создаёт управляемый объект из неуправляемого объекта. (Унаследовано от DTSReadOnlyCollectionBase)
GetCount()	Извлекает количество объектов в коллекции. (Унаследовано от DTSReadOnlyCollectionBase)
GetEnumerator()	Возвращает VariableEnumerator переписчик для итерации Variables коллекции.
GetManagedEnumerator(Object)	Получает управляемый переписчик от неуправляемого переписчика. (Унаследовано от DTSReadOnlyCollectionBase)
Join(Variable)	Присоединяется Variable к Variables коллекции.
Remove(Object)	Удаляет Variable объект из Variables коллекции.
Unlock()	Освобождает блокировки на коллекции переменных и отмечает состояние коллекции переменных как недействительное или неизвестное.