TaskHost Kelas

Referensi

Definisi

Ruang nama:: Microsoft.SqlServer.Dts.Runtime

Rakitan:: Microsoft.SqlServer.ManagedDTS.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menyediakan kontainer yang merangkum satu tugas. Di Perancang SSIS, tidak dikonfigurasi TaskHost secara terpisah; sebaliknya, itu dikonfigurasi saat Anda mengatur properti tugas yang dienkapsulasinya.

public ref class TaskHost sealed : Microsoft::SqlServer::Dts::Runtime::EventsProvider, Microsoft::SqlServer::Dts::Runtime::IDTSExecutionPath, Microsoft::SqlServer::Dts::Runtime::IDTSObjectHost, Microsoft::SqlServer::Dts::Runtime::IDTSPackagePath, Microsoft::SqlServer::Dts::Runtime::IDTSPropertiesProvider, Microsoft::SqlServer::Dts::Runtime::IDTSPropertiesProviderEx

public sealed class TaskHost : Microsoft.SqlServer.Dts.Runtime.EventsProvider, Microsoft.SqlServer.Dts.Runtime.IDTSExecutionPath, Microsoft.SqlServer.Dts.Runtime.IDTSObjectHost, Microsoft.SqlServer.Dts.Runtime.IDTSPackagePath, Microsoft.SqlServer.Dts.Runtime.IDTSPropertiesProvider, Microsoft.SqlServer.Dts.Runtime.IDTSPropertiesProviderEx

type TaskHost = class
    inherit EventsProvider
    interface IDTSObjectHost
    interface IDTSPropertiesProvider
    interface IDTSPropertiesProviderEx
    interface IDTSPackagePath
    interface IDTSExecutionPath

Public NotInheritable Class TaskHost
Inherits EventsProvider
Implements IDTSExecutionPath, IDTSObjectHost, IDTSPackagePath, IDTSPropertiesProvider, IDTSPropertiesProviderEx

Warisan: Object

DtsObject

Executable

DtsContainer

EventsProvider
TaskHost

Penerapan: IDTSExecutionPath IDTSObjectHost IDTSPackagePath IDTSPropertiesProvider IDTSPropertiesProviderEx

Contoh

Contoh kode berikut menunjukkan pembuatan paket kosong. Dua tugas ditambahkan ke paket dan ditransmisikan ke dalam TaskHost kelas, sehingga TaskHost metode dan properti dapat digunakan pada salah satu tugas , seperti InnerObject metode , tanpa memperhatikan jenis tugas apa itu.

using System;  
using System.Collections.Generic;  
using System.Text;  
using Microsoft.SqlServer.Dts.Runtime;  
using Microsoft.SqlServer.Dts.Tasks.BulkInsertTask;  
using Microsoft.SqlServer.Dts.Tasks.FileSystemTask;  

namespace Microsoft.SqlServer.SSIS.Samples  
{  
    class Program  
    {  
        static void Main(string[] args)  
        {  
            Package p = new Package();  
            // Add a File System task to the package.  
            Executable exec1 = p.Executables.Add("STOCK:FileSystemTask");  
            TaskHost thFileSystemTask = exec1 as TaskHost;  
            // Add a Bulk Insert task to the package.  
            Executable exec2 = p.Executables.Add("STOCK:BulkInsertTask");  
            TaskHost thBulkInsertTask = exec2 as TaskHost;  

            // Iterate through the package Executables collection.  
            Executables pExecs = p.Executables;  
            foreach (Executable pExec in pExecs)  
            {  
                TaskHost taskHost = (TaskHost)pExec;  
                Console.WriteLine("Type {0}", taskHost.InnerObject.ToString());  
            }  
        }  
    }  
}

Imports System  
Imports System.Collections.Generic  
Imports System.Text  
Imports Microsoft.SqlServer.Dts.Runtime  
Imports Microsoft.SqlServer.Dts.Tasks.BulkInsertTask  
Imports Microsoft.SqlServer.Dts.Tasks.FileSystemTask  

Namespace Microsoft.SqlServer.SSIS.Samples  
    Class Program  
        Shared  Sub Main(ByVal args() As String)  
            Dim p As Package =  New Package()   
            ' Add a File System task to the package.  
            Dim exec1 As Executable =  p.Executables.Add("STOCK:FileSystemTask")   
            Dim thFileSystemTask As TaskHost =  exec1 as TaskHost   
            ' Add a Bulk Insert task to the package.  
            Dim exec2 As Executable =  p.Executables.Add("STOCK:BulkInsertTask")   
            Dim thBulkInsertTask As TaskHost =  exec2 as TaskHost   

            ' Iterate through the package Executables collection.  
            Dim pExecs As Executables =  p.Executables   
            Dim pExec As Executable  
            For Each pExec In pExecs  
                Dim taskHost As TaskHost = CType(pExec, TaskHost)  
                Console.WriteLine("Type {0}", taskHost.InnerObject.ToString())  
            Next  
        End Sub  
    End Class  
End Namespace

Contoh Output:

Ketik Microsoft.SqlServer.Dts.Tasks.FileSystemTask.FileSystemTask

Ketik Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTask

Keterangan

Integration Services menyediakan beberapa jenis kontainer yang berbeda untuk membangun paket, dengan menjadi salah satu kontainer tersebut TaskHost . Kontainer TaskHost menyediakan layanan untuk satu tugas. Ini tidak memiliki item yang cocok di kotak alat desainer grafis. Objek TaskHost adalah objek pembungkus untuk tugas, dan dibuat secara transparan selama pembuatan tugas. Ini dikembalikan dari Add metode sebagai Executable objek dan ditransmisikan sebagai TaskHost. Terakhir, instans tugas diakses melalui InnerObject properti . Untuk informasi selengkapnya tentang semua kontainer SSIS, lihat Kontainer Layanan Integrasi.

Bidang

m_executable

Yang dapat dieksekusi.

(Diperoleh dari Executable)

Properti

ApartmentThreaded	Mendapatkan nilai yang menunjukkan apakah tugas tersebut adalah objek berulir apartemen.
CreationName	Mengembalikan string yang digunakan untuk membuat instans DtsContainer objek. Properti ini bersifat hanya baca. (Diperoleh dari DtsContainer)
DebugMode	Mendapatkan atau mengatur Boolean yang menunjukkan apakah DtsContainer objek berada dalam mode debug dan apakah harus mengaktifkan OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) peristiwa saat berjalan. (Diperoleh dari DtsContainer)
DelayValidation	Mendapatkan atau mengatur Boolean yang menunjukkan apakah validasi tugas tertunda hingga durasi. Nilai defaultnya adalah false. (Diperoleh dari DtsContainer)
Description	Mendapatkan atau mengatur deskripsi DtsContainer objek. (Diperoleh dari DtsContainer)
Disable	Boolean yang menunjukkan apakah objek dinonaktifkan DtsContainer . (Diperoleh dari DtsContainer)
DisableEventHandlers	Mendapatkan atau mengatur Boolean yang menunjukkan apakah penanganan aktivitas pada tugas dinonaktifkan. (Diperoleh dari EventsProvider)
EventHandlers	Mengembalikan kumpulan objek penanganan aktivitas. Bidang ini hanya-baca. (Diperoleh dari EventsProvider)
EventInfos	Mengembalikan kumpulan EventInfo objek. Bidang ini hanya-baca. (Diperoleh dari EventsProvider)
ExecutionDuration	Mengembalikan nilai yang menunjukkan jumlah waktu yang dihabiskan kontainer dalam eksekusi, dalam milidetik. Properti ini bersifat hanya baca. (Diperoleh dari DtsContainer)
ExecutionResult	Mengembalikan nilai yang menunjukkan keberhasilan atau kegagalan eksekusi DtsContainer objek. (Diperoleh dari DtsContainer)
ExecutionStatus	Mengembalikan nilai yang menunjukkan status eksekusi DtsContainer objek saat ini pada saat panggilan. (Diperoleh dari DtsContainer)
ExecutionValue	Mendapatkan hasil eksekusi tugas. Properti ini bersifat hanya baca.
ExecValueVariable	Mendapatkan atau mengatur kustom Variable yang berisi hasil eksekusi tugas.
FailPackageOnFailure	Mendapatkan atau mengatur Boolean yang menunjukkan apakah paket gagal ketika kontainer anak gagal. Properti ini digunakan pada kontainer, bukan paket itu sendiri. (Diperoleh dari DtsContainer)
FailParentOnFailure	Mendapatkan atau mengatur `Boolean` yang menentukan apakah kontainer induk gagal saat kontainer turunan gagal. (Diperoleh dari DtsContainer)
ForcedExecutionValue	ForceExecutionValue Jika properti diatur ke True, mendapatkan atau menetapkan nilai yang menentukan nilai eksekusi opsional yang dikembalikan paket. (Diperoleh dari DtsContainer)
ForceExecutionResult	Mendapatkan atau menetapkan DTSForcedExecResult nilai enumerasi yang menentukan hasil eksekusi paksa kontainer. (Diperoleh dari DtsContainer)
ForceExecutionValue	Mendapatkan atau menetapkan Boolean yang menunjukkan apakah nilai eksekusi kontainer harus dipaksa untuk berisi nilai tertentu. (Diperoleh dari DtsContainer)
HasExpressions	Mendapatkan nilai yang menunjukkan apakah TaskHost objek memiliki ekspresi.
HostType	Mendapatkan nilai dari DTSObjectHostType enumerasi yang menjelaskan host kontainer. Properti ini bersifat hanya baca.
ID	Mengembalikan ID, yang merupakan GUID, dari DtsContainer. Nilainya baca-saja. (Diperoleh dari DtsContainer)
InnerObject	Mendapatkan metode yang digunakan untuk mengakses instans tugas yang dihosting oleh TaskHost.
IsDefaultLocaleID	Boolean yang menunjukkan apakah kontainer menggunakan lokal default. Properti ini bersifat hanya baca. (Diperoleh dari DtsContainer)
IsolationLevel	Mendapatkan atau mengatur tingkat isolasi transaksi dalam DtsContainer objek. (Diperoleh dari DtsContainer)
LocaleID	Mendapatkan atau mengatur Bilangan Bulat yang menunjukkan localeID Microsoft Win32® untuk digunakan saat DtsContainer objek dijalankan. (Diperoleh dari DtsContainer)
LogEntryInfos	Kembalikan objek LogEntryInfos. Properti ini bersifat hanya baca. (Diperoleh dari DtsContainer)
LoggingMode	Mendapatkan atau menetapkan nilai yang valid dari DTSLoggingMode enumerasi yang menunjukkan mode pengelogan kontainer. (Diperoleh dari DtsContainer)
LoggingOptions	Mengembalikan objek yang berisi properti yang menunjukkan sumber daya pemfilteran dan pengelogan untuk kontainer. Properti ini bersifat hanya baca. (Diperoleh dari DtsContainer)
MaximumErrorCount	Mendapatkan atau mengatur nilai Bilangan Bulat yang menunjukkan jumlah maksimum kesalahan yang dapat terjadi sebelum DtsContainer objek berhenti berjalan. (Diperoleh dari DtsContainer)
Name	Mendapatkan atau mengatur nama DtsContainer. (Diperoleh dari DtsContainer)
Parent	Mengembalikan kontainer induk. Nilainya baca-saja. (Diperoleh dari DtsContainer)
Properties	DtsProperties Mendapatkan koleksi yang berisi properti yang terkait dengan tugas.
Site	Mendapatkan atau mengatur situs untuk kontainer. (Diperoleh dari DtsContainer)
StartTime	Mengembalikan waktu eksekusi mulai kontainer. Properti ini bersifat hanya baca. (Diperoleh dari DtsContainer)
StopTime	Mengembalikan waktu eksekusi kontainer berakhir. Properti ini bersifat hanya baca. (Diperoleh dari DtsContainer)
SuspendRequired	Mendapatkan atau mengatur Boolean yang menunjukkan apakah tugas harus ditangguhkan saat mengalami titik henti. Nilai ini diatur oleh mesin runtime untuk tugas dan kontainer saat titik henti ditemui. (Diperoleh dari DtsContainer)
TransactionOption	Mendapatkan atau menetapkan DTSTransactionOption nilai enumerasi yang menunjukkan apakah kontainer berpartisipasi dalam transaksi. (Diperoleh dari DtsContainer)
VariableDispenser	Mengembalikan VariableDispenser objek sehingga variabel yang terkait dengan kontainer dapat dikunci. (Diperoleh dari DtsContainer)
Variables	Mengembalikan koleksi yang berisi variabel yang terkait dengan kontainer ini. Properti ini bersifat hanya baca. (Diperoleh dari DtsContainer)

Metode

AcceptBreakpointManager(BreakpointManager)	Metode ini dipanggil oleh mesin run-time ketika tugas atau kontainer dibuat, dan meneruskannya sebagai BreakpointManager manajer untuk memungkinkan tugas membuat, menghapus, dan memeriksa status titik henti. Metode ini dipanggil oleh runtime dan tidak digunakan dalam kode. (Diperoleh dari DtsContainer)
ComputeExpressions(Boolean)	Menghitung ekspresi TaskHost objek.
Dispose()	Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, melepaskan, atau mereset sumber daya yang tidak terkelola. (Diperoleh dari DtsContainer)
Equals(Object)	Menentukan apakah dua instans objek sama. (Diperoleh dari DtsObject)
Execute(Connections, Variables, IDTSEvents, IDTSLogging, Object)	Menjalankan aplikasi, kontainer, atau paket sebagai bagian dari alur kerja paket. (Diperoleh dari DtsContainer)
GetExecutionPath()	Mengembalikan jalur eksekusi dari saat ini TaskHost.
GetExpression(String)	Mengembalikan ekspresi untuk properti yang ditentukan. Null berarti tidak ada ekspresi yang ditetapkan.
GetHashCode()	Mengembalikan kode hash untuk instans ini. (Diperoleh dari DtsObject)
GetPackagePath()	Mengembalikan jalur ke lokasi tugas.
LoadFromXML(XmlNode, IDTSEvents)	Metode ini tidak dapat dipanggil oleh kode aplikasi Anda. Untuk memuat paket yang disimpan sebagai .xml, gunakan metode .LoadPackage(String, IDTSEvents) (Diperoleh dari DtsContainer)
ResumeExecution()	Melanjutkan eksekusi tugas setelah jeda. Tugas atau kontainer dilanjutkan oleh mesin runtime. (Diperoleh dari DtsContainer)
SaveToXML(XmlDocument, XmlNode, IDTSEvents)	Metode ini tidak dapat dipanggil oleh kode aplikasi Anda. Untuk menyimpan paket sebagai .xml, gunakan metode .SaveToXml(String, Package, IDTSEvents) (Diperoleh dari DtsContainer)
SetExpression(String, String)	Menetapkan ekspresi yang ditentukan ke properti . Tentukan null untuk menghapus ekspresi yang ada dari properti .
SetWrappedExecutable(IDTSExecutable100)	Mengembalikan objek yang dapat dieksekusi yang dibungkus. (Diperoleh dari EventsProvider)
SuspendExecution()	Dipanggil ketika executable perlu ditangguhkan. Metode ini dipanggil oleh mesin runtime. (Diperoleh dari DtsContainer)
Validate(Connections, Variables, IDTSEvents, IDTSLogging)	Memungkinkan kontainer untuk menentukan apakah kontainer berisi pengaturan yang tidak valid yang akan mencegahnya berhasil dijalankan. (Diperoleh dari DtsContainer)

Acara

Disposed

Menambahkan penanganan aktivitas untuk mendengarkan Disposed peristiwa pada komponen.

(Diperoleh dari DtsContainer)

Berlaku untuk

Bagikan melalui