LogProviderBase.Log Method

  • [アーティクル]

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

名前空間: 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() _
)

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
)

public 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 function Log (
    logEntryName : String, 
    computerName : String, 
    operatorName : String, 
    sourceName : String, 
    sourceID : String, 
    executionID : String, 
    messageText : String, 
    startTime : DateTime, 
    endTime : DateTime, 
    dataCode : int, 
    dataBytes : byte[]
)

パラメータ

  • logEntryName
    イベントの名前です。
  • computerName
    パッケージが実行されているコンピュータの名前です。
  • operatorName
    パッケージを実行しているユーザー アカウントです。
  • sourceName
    イベントを発生させているオブジェクトの名前です。
  • sourceID
    イベントを発生させているオブジェクトの ID です。
  • executionID
    実行中のパッケージの実行 ID です。
  • messageText
    イベントのテキスト メッセージです。
  • startTime
    このイベントの原因になっているアクションの開始時刻です。
  • endTime
    このイベントの原因になっているアクションの終了時刻です。
  • dataCode
    数値データ フィールドです。
  • dataBytes
    BLOB データ フィールドです。

解説

このメソッドは、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

スレッド セーフ

この型の public static (Microsoft Visual Basic では共有 ) メンバは、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

開発プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

対象プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

参照

関連項目

LogProviderBase Class
LogProviderBase Members
Microsoft.SqlServer.Dts.Runtime Namespace