EventInfos.Add 메서드

Adds an EventInfo object to the current EventInfos collection.

네임스페이스:  Microsoft.SqlServer.Dts.Runtime
어셈블리:  Microsoft.SqlServer.ManagedDTS(Microsoft.SqlServer.ManagedDTS.dll)

구문

‘선언
Public Sub Add ( _
    eventName As String, _
    description As String, _
    allowEventHandlers As Boolean, _
    parameterNames As String(), _
    parameterTypes As TypeCode(), _
    parameterDescriptions As String() _
)
‘사용 방법
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[]
)

매개 변수

• eventName
  유형: System.String
  The name of the custom event.

• description
  유형: System.String
  A String that contains a description of the event.

• allowEventHandlers
  유형: System.Boolean
  A Boolean that indicates if the development tool will allow event handler objects to be created for the event. If true, event handler objects can be created for the event.

• parameterNames
  유형: array<System.String[]
  An array of parameters passed to the event.

• parameterTypes
  유형: array<System.TypeCode[]
  The type of each parameter in the parameterNames array.

• parameterDescriptions
  유형: array<System.String[]
  An array that contains descriptions for each of the parameters in parameterNames.

주의

For an example of the EventInfos collection and the Addmethod, see 사용자 지정 태스크 개발.

예

The following example shows a custom event being added to the EventInfos collection.

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

참고 항목

참조

EventInfos 클래스

Microsoft.SqlServer.Dts.Runtime 네임스페이스