Task Classe

Definição

Namespace:: Microsoft.SqlServer.Dts.Runtime

Assembly:: Microsoft.SqlServer.ManagedDTS.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Define uma classe abstrata que implementa os métodos e propriedades comuns a todas as tarefas em Serviços de Integração.

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

Herança: Object

DtsObject
Task

Derivado: Microsoft.DataTransformationServices.Tasks.DTSProcessingTask.ASTaskBase

Microsoft.SqlServer.Dts.Tasks.BulkInsertTask.BulkInsertTask

Microsoft.SqlServer.Dts.Tasks.DataProfilingTask.DataProfilingTask

Microsoft.SqlServer.Dts.Tasks.DMQueryTask.DMQueryTask

Microsoft.SqlServer.Dts.Tasks.ExecuteProcess.ExecuteProcess

Mais…

Implementações: IDTSManagedTask

Exemplos

O exemplo de código a seguir é uma implementação de tarefa muito simples para uma tarefa personalizada que herda da Tarefa.

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

Comentários

Um pacote consiste em uma ou mais tarefas. Essas tarefas definem unidades de trabalho que são realizadas como parte da cópia e transformação de dados, comunicação com outros processos e execução de funções de gerenciamento de banco de dados.

Herda de DtsObject e IDTSManagedTask.

Construtores

Nome	Description
Task()	Inicializa uma nova instância da classe Task.

Propriedades

Nome	Description
ExecutionValue	Retorna um objeto definido pelo usuário. O campo é somente leitura.
TargetServerVersion	Define uma classe abstrata que implementa os métodos e propriedades comuns a todas as tarefas em Serviços de Integração.
Version	Membro descontinuado; veja Observações. Retorna a versão da tarefa. Esta propriedade é somente para leitura.

Métodos

Nome	Description
CanUpdate(String)	Membro descontinuado; veja Observações. Um Booleano que indica se o novo XML do pacote pode atualizar o XML do pacote antigo.
Equals(Object)	Determina se duas instâncias de objeto são iguais. (Herdado de DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)	Executa a tarefa.
GetConnectionID(Connections, String)	Recebe uma String contendo o ID da conexão.
GetConnectionName(Connections, String)	Recebe uma String contendo o nome da conexão.
GetHashCode()	Retorna o código hash dessa instância. (Herdado de DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)	Inicializa as propriedades associadas à tarefa. Esse método é chamado pelo runtime e não é usado no código.
Update(String)	Membro descontinuado; veja Observações. Esse método atualiza o pacote antigo XML com o novo pacote XML se CanUpdate(String) for definido como verdadeiro.
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)	Verifica se o componente está devidamente configurado.

Aplica-se a