語言

Task 類別

定義

命名空間:
Microsoft.SqlServer.Dts.Runtime
組件:
Microsoft.SqlServer.ManagedDTS.dll

定義一個抽象類別，實作整合服務中所有任務共有的方法與屬性。

public ref class Task abstract : Microsoft::SqlServer::Dts::Runtime::DtsObject, Microsoft::SqlServer::Dts::Runtime::IDTSManagedTask
public abstract class Task : Microsoft.SqlServer.Dts.Runtime.DtsObject, Microsoft.SqlServer.Dts.Runtime.IDTSManagedTask
type Task = class
    inherit DtsObject
    interface IDTSManagedTask
Public MustInherit Class Task
Inherits DtsObject
Implements IDTSManagedTask
繼承
Object
DtsObject
Task
衍生
實作
IDTSManagedTask

範例

以下程式碼範例是一個非常簡單的任務實作，適用於繼承自 Task 的自訂任務。

using System;  
using Microsoft.SqlServer.Dts.Runtime;  

class MyTask : Task  
{  
    private int m_value = 123;  

    public override DTExecResult Execute(Connections connections,  
Variables variables, IDTSEvents events,  
IDTSLogging log, int lastExecResult, DtsTransaction txn)  
    {  
        return m_value;  
    }  
}  

Imports System  
Imports Microsoft.SqlServer.Dts.Runtime  

Class MyTask  
    Inherits Task  
    Private m_value As Integer =  123   
    Public Overrides DTExecResult Property connections,() As Execute(Connections  
    End Property  
Variables variables, IDTSEvents events,  
IDTSLogging log,int Function txn)() As lastExecResult,DtsTransaction  
        Return m_value  
End Function  
End Class

備註

一個套件包含一個或多個任務。 這些任務定義了工作單元，這些工作單元用於複製與轉換資料、與其他流程溝通及執行資料庫管理功能。

繼承自 DtsObject 和 IDTSManagedTask。

建構函式

名稱 Description
Task()

初始化 Task 類別的新執行個體。

屬性

名稱 Description
ExecutionValue

回傳一個使用者定義的物件。 此欄位是唯讀的。
TargetServerVersion

定義一個抽象類別，實作整合服務中所有任務共有的方法與屬性。
Version

成員已被淘汰;詳見備註。 回傳任務的版本。 這個屬性是唯讀的。

方法

名稱 Description
CanUpdate(String)

成員已被淘汰;詳見備註。 一個布林值，表示新套件 XML 是否能更新舊套件 XML。
Equals(Object)

判斷兩個物件實例是否相等。

(繼承來源 DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)

執行任務。
GetConnectionID(Connections, String)

會取得包含連線 ID 的字串。
GetConnectionName(Connections, String)

會得到一個包含連接名稱的字串。
GetHashCode()

傳回這個實例的哈希碼。

(繼承來源 DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)

初始化與任務相關的屬性。 此方法由執行時呼叫，程式碼中不使用。
Update(String)

成員已被淘汰;詳見備註。 此方法若將舊套件 XML 更新為新的套件 XML，則若 CanUpdate(String) 將 設定為 true。
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)

驗證元件是否正確設定。

適用於