DtsContainer.AcceptBreakpointManager(BreakpointManager) メソッド

定義

このメソッドは、タスクまたはコンテナーの作成時にランタイム エンジンによって呼び出され、そのタスクまたはコンテナーを 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 です。

実装

このメソッドは、カスタム タスクを作成するとオーバーライドされます。

インターフェイスは 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 オブジェクトが含まれます。このオブジェクトはタスクでブレークポイントの作成や管理を行うために使用されます。 詳細については、「 カスタム タスクでのデバッグのサポートの追加」を参照してください。

適用対象