Udostępnij przez


Metoda EventInfos.Add

Dodaje EventInfo obiekt do bieżącego EventInfos kolekcja.

Przestrzeń nazw:  Microsoft.SqlServer.Dts.Runtime
Zestaw:  Microsoft.SqlServer.ManagedDTS (w Microsoft.SqlServer.ManagedDTS.dll)

Składnia

'Deklaracja
Public Sub Add ( _
    eventName As String, _
    description As String, _
    allowEventHandlers As Boolean, _
    parameterNames As String(), _
    parameterTypes As TypeCode(), _
    parameterDescriptions As String() _
)
'Użycie
Dim instance As EventInfos
Dim eventName As String
Dim description As String
Dim allowEventHandlers As Boolean
Dim parameterNames As String()
Dim parameterTypes As TypeCode()
Dim parameterDescriptions As String()

instance.Add(eventName, description, allowEventHandlers, _
    parameterNames, parameterTypes, _
    parameterDescriptions)
public void Add(
    string eventName,
    string description,
    bool allowEventHandlers,
    string[] parameterNames,
    TypeCode[] parameterTypes,
    string[] parameterDescriptions
)
public:
void Add(
    String^ eventName, 
    String^ description, 
    bool allowEventHandlers, 
    array<String^>^ parameterNames, 
    array<TypeCode>^ parameterTypes, 
    array<String^>^ parameterDescriptions
)
member Add : 
        eventName:string * 
        description:string * 
        allowEventHandlers:bool * 
        parameterNames:string[] * 
        parameterTypes:TypeCode[] * 
        parameterDescriptions:string[] -> unit 
public function Add(
    eventName : String, 
    description : String, 
    allowEventHandlers : boolean, 
    parameterNames : String[], 
    parameterTypes : TypeCode[], 
    parameterDescriptions : String[]
)

Parametry

  • allowEventHandlers
    Typ: System.Boolean
    A logiczna oznacza to, jeśli narzędzie programowania umożliwi obsługa zdarzeń obiekty utworzone dla zdarzenie.Jeśli true, mogą być tworzone obiekty obsługa zdarzeń dla zdarzenie.
  • parameterNames
    Typ: array<System.String[]
    Tablica parametrów przekazanych do zdarzenie.
  • parameterTypes
    Typ: array<System.TypeCode[]
    Typ każdego parametru w parameterNames tablicy.
  • parameterDescriptions
    Typ: array<System.String[]
    Tablica zawiera opisy dla każdego z parametrów w parameterNames.

Uwagi

Na przykład EventInfos kolekcja i Addmetoda, zobacz Opracowywania niestandardowego zadania.

Przykłady

Poniższy przykład przedstawia zdarzenie niestandardowego dodawanych do EventInfos kolekcja.

public override void InitializeTask(Connections connections, VariableDispenser variables, IDTSInfoEvents events, IDTSLogging log, EventInfos eventInfos, LogEntryInfos logEntryInfos, ObjectReferenceTracker refTracker)
{
    this.eventInfos = eventInfos;
    string[] paramNames = new string[1];
    TypeCode[] paramTypes = new TypeCode[1]{TypeCode.Int32};
    string[] paramDescriptions = new string[1];

    paramNames[0] = "InitialValue";
    paramDescriptions[0] = "The value before increment.";

    this.eventInfos.Add("OnBeforeIncrement","Fires before the task increments the value.",true,paramNames,paramTypes,paramDescriptions);
    this.onBeforeIncrement = this.eventInfos["OnBeforeIncrement"];

    paramDescriptions[0] = "The value after increment.";
    this.eventInfos.Add("OnAfterIncrement","Fires after the initial value is updated.",true,paramNames, paramTypes,paramDescriptions);
    this.onAfterIncrement = this.eventInfos["OnAfterIncrement"];
}
Public Overrides Sub InitializeTask(ByVal connections As Connections, ByVal variables As VariableDispenser, ByVal events As IDTSInfoEvents, ByVal log As IDTSLogging, ByVal eventInfos As EventInfos, ByVal logEntryInfos As LogEntryInfos, ByVal refTracker As ObjectReferenceTracker) 
    Me.eventInfos = eventInfos
    Dim paramNames(0) As String
    Dim paramTypes(0) As TypeCode = {TypeCode.Int32}
    Dim paramDescriptions(0) As String
    
    paramNames(0) = "InitialValue"
    paramDescriptions(0) = "The value before increment."
    
    Me.eventInfos.Add("OnBeforeIncrement", "Fires before the task increments the value.", True, paramNames, paramTypes, paramDescriptions)
    Me.onBeforeIncrement = Me.eventInfos("OnBeforeIncrement")
    
    paramDescriptions(0) = "The value after increment."
    Me.eventInfos.Add("OnAfterIncrement", "Fires after the initial value is updated.", True, paramNames, paramTypes, paramDescriptions)
    Me.onAfterIncrement = Me.eventInfos("OnAfterIncrement")
End Sub