TransferErrorMessagesTask.AcceptBreakpointManager(BreakpointManager) メソッド

定義

タスクがブレークポイントの作成、削除、状態の確認を可能にします。 このメソッドは、タスクやコンテナが作成される際にランタイムエンジンによって呼び出され、コードで使用されていない場合に行われます。

public:
 virtual void AcceptBreakpointManager(Microsoft::SqlServer::Dts::Runtime::BreakpointManager ^ manager);
public void AcceptBreakpointManager(Microsoft.SqlServer.Dts.Runtime.BreakpointManager manager);
abstract member AcceptBreakpointManager : Microsoft.SqlServer.Dts.Runtime.BreakpointManager -> unit
override this.AcceptBreakpointManager : Microsoft.SqlServer.Dts.Runtime.BreakpointManager -> unit
Public Sub AcceptBreakpointManager (manager As BreakpointManager)

パラメーター

manager
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  

適用対象