DtsContainer.AcceptBreakpointManager(BreakpointManager) メソッド

定義

名前空間:: Microsoft.SqlServer.Dts.Runtime

アセンブリ:: Microsoft.SqlServer.ManagedDTS.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

このメソッドは、タスクやコンテナが作成される際にランタイムエンジンによって呼び出され、 BreakpointManager マネージャを渡してタスクがブレークポイントの作成、削除、状態の確認を行えます。このメソッドはランタイムによって呼び出され、コードでは使用されません。

public:
 virtual void AcceptBreakpointManager(Microsoft::SqlServer::Dts::Runtime::BreakpointManager ^ breakpointManager);

public void AcceptBreakpointManager(Microsoft.SqlServer.Dts.Runtime.BreakpointManager breakpointManager);

abstract member AcceptBreakpointManager : Microsoft.SqlServer.Dts.Runtime.BreakpointManager -> unit
override this.AcceptBreakpointManager : Microsoft.SqlServer.Dts.Runtime.BreakpointManager -> unit

Public Sub AcceptBreakpointManager (breakpointManager As BreakpointManager)

パラメーター

breakpointManager: BreakpointManager

このタスクやコンテナのブレークポイントを制御するための BreakpointManager 。

実装

AcceptBreakpointManager(BreakpointManager)

例

この方法はカスタムタスクを作成すると上書きされます。

IDTSBreakpointSiteインターフェースがこのメソッドを定義しており、タスクに継承され、実行時エンジンがタスク作成時に呼び出します。このメソッドは BreakpointManager オブジェクトをパラメータとして取り、各タスクがブレークポイントを作成・管理するために利用します。

以下のサンプルコードは、カスタムタスクを書く際にメソッドをオーバーライドする方法を示し、 BreakpointManager を使ってブレークポイントを作成し、 OnBreakpointHit メソッドを呼び出してイベントを発生させる方法を示しています。詳細については、「カスタムタスクにおけるデバッグのサポートの追加」をご覧ください。

public void AcceptBreakpointManager( BreakpointManager breakPointManager )  
{  
   // Store the breakpoint manager locally.  
   this.bpm  = breakPointManager;  
   // Create a breakpoint.  
   this.bpm.CreateBreakPoint( 1 , "A sample breakpoint." );  
}  
public override DTSExecResult Execute( Connections connections, Variables variables, IDTSComponentEvents events, IDTSLogging log, DtsTransaction txn)  
{  
   if( this.bpm.IsBreakpointTargetEnabled( 1 ) == true )  
      events.OnBreakpointHit( this.bpm.GetBreakpointTarget( 1 ) );  
}

Public  Sub AcceptBreakpointManager(ByVal breakPointManager As BreakpointManager)  
   ' Store the breakpoint manager locally.  
   Me.bpm  = breakPointManager  
   ' Create a breakpoint.  
   Me.bpm.CreateBreakPoint(1 , "A sample breakpoint.")  
End Sub  
Public Overrides Function Execute(ByVal connections As Connections, ByVal variables As Variables, ByVal events As IDTSComponentEvents, ByVal log As IDTSLogging, ByVal txn As DtsTransaction) As DTSExecResult  
   If Me.bpm.IsBreakpointTargetEnabled(1) = True Then  
      events.OnBreakpointHit(Me.bpm.GetBreakpointTarget(1))  
   End If  
End Function

注釈

このメソッドには BreakpointManager オブジェクトが含まれており、タスクがブレークポイントを作成・管理するために利用します。詳細については、「カスタムタスクにおけるデバッグのサポートの追加」をご覧ください。

適用対象