IDTSComponentEvents.FireProgress Método

Definição

Namespace:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Gera um evento quando o progresso mensurável é feito pelo executável.

public:
 void FireProgress(System::String ^ progressDescription, int percentComplete, int progressCountLow, int progressCountHigh, System::String ^ subComponent, bool % fireAgain);

public void FireProgress (string progressDescription, int percentComplete, int progressCountLow, int progressCountHigh, string subComponent, ref bool fireAgain);

abstract member FireProgress : string * int * int * int * string * bool -> unit

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

Parâmetros

progressDescription

String

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

percentComplete

Int32

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

progressCountLow

Int32

Um Inteiro que contém os 32 bits baixos das unidades concluídas.

progressCountHigh

Int32

Um Inteiro que contém os 32 bits altos das unidades concluídas.

subComponent

String

Uma String que contém mais detalhes sobre a origem do evento.

fireAgain

Boolean

Um booliano que indica que isso deve continuar disparando ou parar de disparar. Um valor verdadeiro indica que ele deve continuar sendo acionado.

Comentários

Como a disparação de um evento pode ser cara, o mecanismo de tempo de execução fornece um mecanismo para suprimir eventos nos quais você não está interessado. Cada método de disparo de evento tem um FireAgain parâmetro. Se o valor dessa variável for false, após o retorno do método, o chamador não disparará esse evento novamente durante a execução atual.

Vários dos eventos têm um subComponent parâmetro que permite uma granularidade ainda maior na identificação da origem do evento.