Compartilhar via


Task Classe

Definição

Define uma classe abstrata que implementa os métodos e as propriedades comuns a todas as tarefas no Integration Services.

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
Derivado
Implementações

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 executadas 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

Task()

Inicializa uma nova instância da classe Task.

Propriedades

ExecutionValue

Retorna um objeto definido pelo usuário. Este campo é somente leitura.

TargetServerVersion

Define uma classe abstrata que implementa os métodos e as propriedades comuns a todas as tarefas no Integration Services.

Version

Membro preterido; consulte Comentários. *** Retorna a versão da tarefa. Esta propriedade é somente para leitura.

Métodos

CanUpdate(String)

Membro preterido; consulte Comentários. Um booliano 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)

Obtém uma cadeia de caracteres que contém a ID da conexão.

GetConnectionName(Connections, String)

Obtém uma cadeia de caracteres que contém o nome da conexão.

GetHashCode()

Retorna o código hash para a 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 em código.

Update(String)

Membro preterido; consulte Comentários. Esse método atualiza o XML do pacote antigo com o novo XML do pacote se CanUpdate(String) for definido como true.

Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)

Verifica se o componente foi configurado corretamente.

Aplica-se a