IDTSEvents.OnProgress Método

Definição

Namespace:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Chamado para atualizar o progresso da execução de tarefa.

public:
 void OnProgress(Microsoft::SqlServer::Dts::Runtime::TaskHost ^ taskHost, System::String ^ progressDescription, int percentComplete, int progressCountLow, int progressCountHigh, System::String ^ subComponent, bool % fireAgain);

public void OnProgress (Microsoft.SqlServer.Dts.Runtime.TaskHost taskHost, string progressDescription, int percentComplete, int progressCountLow, int progressCountHigh, string subComponent, ref bool fireAgain);

abstract member OnProgress : Microsoft.SqlServer.Dts.Runtime.TaskHost * string * int * int * int * string * bool -> unit

Public Sub OnProgress (taskHost As TaskHost, progressDescription As String, percentComplete As Integer, progressCountLow As Integer, progressCountHigh As Integer, subComponent As String, ByRef fireAgain As Boolean)

Parâmetros

taskHost

TaskHost

Um valor nulo.

progressDescription

String

Uma cadeia de caracteres que descreve o evento do progresso que é gerado.

percentComplete

Int32

Um inteiro usado para indicar quanto da tarefa foi concluída.

progressCountLow

Int32

Um inteiro que contém os 32 bits menores das unidades concluídas.

progressCountHigh

Int32

Um inteiro que contém os 32 bits maiores das unidades concluídas.

subComponent

String

Uma cadeia de caracteres que contém mais detalhes sobre a origem do evento.

fireAgain

Boolean

Um booliano que indica que isso deve continuar disparando ou parando de disparar. Um valor verdadeiro indica que ele deve continuar disparando.

Comentários

Chamado sempre que uma tarefa experimenta um progresso mensurável. Cada tarefa tem seus próprios requisitos, mas, como regra geral, uma tarefa relata o progresso em incrementos de 1%. OnProgress é chamado pela tarefa em intervalos predeterminados para atualizar clientes ouvintes sobre o progresso de uma tarefa específica.