Variables Kelas

Definisi

Ruang nama:

Microsoft.SqlServer.Dts.Runtime

Rakitan:

Microsoft.SqlServer.ManagedDTS.dll

Berisi kumpulan Variables objek, yang diakses melalui beberapa objek. Kelas ini tidak dapat diwariskan.

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

Warisan

Object

DTSReadOnlyCollectionBase

Variables

Keterangan

Integration Services (SSIS) menyediakan variabel sistem dan mendukung variabel pengguna kustom. Saat Anda membuat paket baru, tambahkan kontainer atau tugas ke paket, atau buat penanganan aktivitas, SSIS secara otomatis menyertakan sekumpulan variabel sistem untuk item tersebut. Variabel sistem selalu terletak di System namespace layanan. System variabel berisi informasi yang berguna tentang paket dan kontainer, tugas, dan penanganan aktivitasnya. System variabel berisi informasi seperti nama komputer tempat paket berjalan dan waktu paket dimulai. Anda dapat melihat informasi yang terkandung dalam variabel sistem, tetapi Anda tidak dapat menambahkan atau memperbarui variabel sistem.

Anda juga dapat membuat variabel kustom untuk digunakan dalam paket, kontainer, tugas, transformasi, dan batasan prioritas. Variabel kustom dapat dibuat di User namespace layanan atau namespace pilihan Anda. Variabel kustom dapat digunakan dalam ekspresi yang mungkin dimuat oleh kontainer For Loop, transformasi Kolom Turunan, transformasi Pemisahan Bersyariah, dan batasan prioritas. Untuk informasi selengkapnya, lihat Menggunakan Variabel dalam Paket.

Setiap kontainer dalam model objek SSIS memiliki Variables koleksi. Koleksi ini dapat diakses oleh setiap anak kontainer. Variabel diakses dari koleksi dengan menggunakan namanya atau indeksnya. Koleksi Variables pada kontainer mewakili agregasi variabel dalam koleksi induknya. Koleksi VariablesPackage kelas terlihat oleh semua objek dalam paket, menyediakan koleksi yang terlihat secara global. Sebaliknya, variabel yang terkandung dalam tugas dibatasi dalam cakupan dan visibilitas, dan hanya terlihat oleh tugas.

Penting

Variables digunakan dengan kelas Runtime. Jika Anda menggunakan komponen aliran data (Microsoft.SqlServer.Dts.Pipeline), Anda mungkin diharuskan untuk menggunakan IDTSVariables100. Untuk mengetahui koleksi variabel mana yang akan digunakan, lihat dokumentasi untuk objek tempat Anda memperoleh variabel, dan verifikasi nilai pengembalian.

Bidang

m_unmanagedColl

Koleksi yang tidak dikelola. (Diperoleh dari DTSReadOnlyCollectionBase)

Properti

Count	Mendapatkan jumlah elemen yang terkandung dalam DTSReadOnlyCollectionBase instans. (Diperoleh dari DTSReadOnlyCollectionBase)
IsSynchronized	Mendapatkan nilai yang menunjukkan apakah akses ke disinkronkan DTSReadOnlyCollectionBase (aman utas). (Diperoleh dari DTSReadOnlyCollectionBase)
Item[Object]	Mengembalikan Variable objek dari Variables koleksi.
Locked	Boolean yang menunjukkan apakah variabel dalam Variables koleksi dikunci.
SyncRoot	Mendapatkan objek yang dapat digunakan untuk menyinkronkan akses ke DTSReadOnlyCollectionBase. (Diperoleh dari DTSReadOnlyCollectionBase)

Metode

Add(String, Boolean, String, Object)	Variable Menambahkan objek ke Variables koleksi.
Contains(Object)	Mengembalikan Boolean yang menunjukkan apakah item dalam koleksi dapat diakses dengan menggunakan pengindeksan tanpa melemparkan pengecualian.
CopyTo(Array, Int32)	Menyalin seluruh DTSReadOnlyCollectionBase ke array satu dimensi yang kompatibel, dimulai dari indeks array target yang ditentukan. (Diperoleh dari DTSReadOnlyCollectionBase)
CreateManagedObject(Object)	Membuat objek terkelola dari objek yang tidak terkelola. (Diperoleh dari DTSReadOnlyCollectionBase)
GetCount()	Mengambil jumlah objek dalam koleksi. (Diperoleh dari DTSReadOnlyCollectionBase)
GetEnumerator()	Mengembalikan VariableEnumerator enumerator untuk digunakan dalam iterasi di Variables atas koleksi.
GetManagedEnumerator(Object)	Mendapatkan enumerator terkelola dari enumerator yang tidak dikelola. (Diperoleh dari DTSReadOnlyCollectionBase)
Join(Variable)	Menggabungkan ke VariableVariables koleksi.
Remove(Object)	Variable Menghapus objek dari Variables koleksi.
Unlock()	Melepaskan kunci pada koleksi variabel dan menandai status koleksi variabel sebagai tidak valid atau tidak diketahui.