Log メソッド

パッケージの実行中にランタイム イベントが発生する場合に呼び出されます。

名前空間:  Microsoft.SqlServer.Dts.Runtime
アセンブリ:  Microsoft.SqlServer.ManagedDTS (Microsoft.SqlServer.ManagedDTS.dll)

構文

'宣言
Public Overridable Sub Log ( _
    logEntryName As String, _
    computerName As String, _
    operatorName As String, _
    sourceName As String, _
    sourceID As String, _
    executionID As String, _
    messageText As String, _
    startTime As DateTime, _
    endTime As DateTime, _
    dataCode As Integer, _
    dataBytes As Byte() _
)
'使用
Dim instance As LogProviderBase
Dim logEntryName As String
Dim computerName As String
Dim operatorName As String
Dim sourceName As String
Dim sourceID As String
Dim executionID As String
Dim messageText As String
Dim startTime As DateTime
Dim endTime As DateTime
Dim dataCode As Integer
Dim dataBytes As Byte()

instance.Log(logEntryName, computerName, _
    operatorName, sourceName, sourceID, _
    executionID, messageText, startTime, _
    endTime, dataCode, dataBytes)
public virtual void Log(
    string logEntryName,
    string computerName,
    string operatorName,
    string sourceName,
    string sourceID,
    string executionID,
    string messageText,
    DateTime startTime,
    DateTime endTime,
    int dataCode,
    byte[] dataBytes
)
public:
virtual void Log(
    String^ logEntryName, 
    String^ computerName, 
    String^ operatorName, 
    String^ sourceName, 
    String^ sourceID, 
    String^ executionID, 
    String^ messageText, 
    DateTime startTime, 
    DateTime endTime, 
    int dataCode, 
    array<unsigned char>^ dataBytes
)
abstract Log : 
        logEntryName:string * 
        computerName:string * 
        operatorName:string * 
        sourceName:string * 
        sourceID:string * 
        executionID:string * 
        messageText:string * 
        startTime:DateTime * 
        endTime:DateTime * 
        dataCode:int * 
        dataBytes:byte[] -> unit 
override Log : 
        logEntryName:string * 
        computerName:string * 
        operatorName:string * 
        sourceName:string * 
        sourceID:string * 
        executionID:string * 
        messageText:string * 
        startTime:DateTime * 
        endTime:DateTime * 
        dataCode:int * 
        dataBytes:byte[] -> unit 
public function Log(
    logEntryName : String, 
    computerName : String, 
    operatorName : String, 
    sourceName : String, 
    sourceID : String, 
    executionID : String, 
    messageText : String, 
    startTime : DateTime, 
    endTime : DateTime, 
    dataCode : int, 
    dataBytes : byte[]
)

パラメーター

  • computerName
    型: System. . :: . .String
    パッケージが実行されているコンピュータの名前です。
  • operatorName
    型: System. . :: . .String
    パッケージを実行しているユーザー アカウントです。
  • sourceName
    型: System. . :: . .String
    イベントを発生させているオブジェクトの名前です。
  • startTime
    型: System. . :: . .DateTime
    このイベントの原因となっているアクションの開始時刻です。
  • endTime
    型: System. . :: . .DateTime
    このイベントの原因となっているアクションの終了時刻です。

説明

このメソッドは、IDTSEvents インターフェイスまたは IDTSInfoEvents インターフェイスからイベントが発生するときに呼び出されます。

パッケージが実行されるときにログ エントリを書き込むには、このメソッドを使用します。

このメソッドに対するパラメータは、イベントの開始時刻、イベントを発生させるオブジェクトなどに関する情報を提供します。

使用例

Log メソッドは、イベント インターフェイスのいずれかで FireEvent メソッドを呼び出すことによってパッケージ内のオブジェクトがイベントを発生させるたびに呼び出されます。複数のイベント インターフェイスがあり、それぞれに IDTSEvents インターフェイスで定義されたイベントのサブセットを含めることができます。このインターフェイスに含まれるのは、FireCustomEvent メソッドです。これは、カスタム イベントを持つオブジェクトがイベントを発生させるために使用するイベントです。

次のコード例では、Log メソッドを実装し、前のセクションで開かれたストリームにイベントを書き込みます。

public override void Log(string logEntryName, string computerName, string operatorName, string sourceName, string sourceID, string executionID, string messageText, DateTime startTime, DateTime endTime, int dataCode, byte[] dataBytes)
{
    sw.Write(logEntryName + ",");
    sw.Write(computerName + ",");
    sw.Write(operatorName + ",");
    sw.Write(sourceName + ",");
    sw.Write(sourceID + ",");
    sw.Write(messageText + ",");
    sw.Write(dataBytes + ",");
    sw.WriteLine("");
}
Public Overrides  Sub Log(ByVal logEnTryName As String, ByVal computerName As String, ByVal operatorName As String, ByVal sourceName As String, ByVal sourceID As String, ByVal executionID As String, ByVal messageText As String, ByVal startTime As DateTime, ByVal endTime As DateTime, ByVal dataCode As Integer, ByVal dataBytes() As Byte)
    sw.Write(logEnTryName + ",")
    sw.Write(computerName + ",")
    sw.Write(operatorName + ",")
    sw.Write(sourceName + ",")
    sw.Write(sourceID + ",")
    sw.Write(messageText + ",")
    sw.Write(dataBytes + ",")
    sw.WriteLine("")
End Sub