IDTSComponentEvents.FireInformation Método
Definição
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.
Gera um evento que contém informações.
public:
void FireInformation(int informationCode, System::String ^ subComponent, System::String ^ description, System::String ^ helpFile, int helpContext, bool % fireAgain);
public void FireInformation (int informationCode, string subComponent, string description, string helpFile, int helpContext, ref bool fireAgain);
abstract member FireInformation : int * string * string * string * int * bool -> unit
Public Sub FireInformation (informationCode As Integer, subComponent As String, description As String, helpFile As String, helpContext As Integer, ByRef fireAgain As Boolean)
Parâmetros
- informationCode
- Int32
Um Inteiro que identifica a mensagem informativa.
- subComponent
- String
Uma String que contém mais detalhes sobre a origem do evento.
- description
- String
O texto da mensagem.
- helpFile
- String
O caminho para o arquivo da Ajuda que contém informações detalhadas.
- helpContext
- Int32
O identificador do tópico no arquivo da Ajuda.
- 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
A definição de um evento de informações é que é uma mensagem importante o suficiente para ser sempre exibida para a maioria dos usuários. Ele difere de um aviso em que nenhum dano potencial está implícito e difere do log em que ele não pode ser desativado ou filtrado e, na verdade, ele pode ser manipulado pelo manipulador de eventos.
Como o disparo de um evento pode ser caro, 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
, depois que o método retornar, 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 granularidade ainda maior na identificação da origem do evento.