Package.GetBreakpointTargets Method

BreakpointTargets コレクションを返します。onlyEnabled パラメータの設定により、コレクションには、パッケージ内のすべてのブレークポイント ターゲットが含まれたり、有効なブレークポイント ターゲットのみが含まれたりします。

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

構文

'宣言
Public Function GetBreakpointTargets ( _
    bpSite As IDTSBreakpointSite, _
    onlyEnabled As Boolean _
) As BreakpointTargets

public BreakpointTargets GetBreakpointTargets (
    IDTSBreakpointSite bpSite,
    bool onlyEnabled
)

public:
BreakpointTargets^ GetBreakpointTargets (
    IDTSBreakpointSite^ bpSite, 
    bool onlyEnabled
)

public BreakpointTargets GetBreakpointTargets (
    IDTSBreakpointSite bpSite, 
    boolean onlyEnabled
)

public function GetBreakpointTargets (
    bpSite : IDTSBreakpointSite, 
    onlyEnabled : boolean
) : BreakpointTargets

パラメータ

• bpSite
  IDTSBreakpointSite インターフェイスを実装するオブジェクトです。

• onlyEnabled
  コレクションに含めるブレークポイント ターゲットの種類を示す Boolean です。true は有効なブレークポイントのみがコレクションに含まれることを示し、false はすべてのブレークポイント ターゲットがコレクションに含まれることを示します。

戻り値

BreakpointTargets コレクションです。

解説

onlyenabled パラメータは、true に設定すると、Enabled プロパティの値を確認し、Enabled が true に設定されたそれらのブレークポイントを含めます。

Integration Services (SSIS) では、コンテナおよびタスクのブレークポイントをサポートします。Business Intelligence Development Studio ではデバッグ ウィンドウを提供し、SSIS デザイナではパッケージ制御フローのデバッグの進行状況レポートを提供します。SSIS デザイナには、[ブレークポイントの設定] ダイアログ ボックスが用意されており、ここで、ブレークポイントを有効にし、ランタイム エンジンが停止するまでに発生するブレークポイントの回数を設定できます。タスク ブレークポイントが有効な場合、ブレークポイント アイコンが [制御フロー] ウィンドウのデザイン画面のタスクの横に表示されます。イベントに発生するブレークポイントを設定できます。イベントでのブレークポイントの設定の詳細については、「Integration Services のイベント ハンドラ」を参照してください。

使用例

次のコード サンプルでは、パッケージでブレークポイントのコレクションを取得するための GetBreakpointTargets の使用方法を示します。

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SqlServer.Dts.Runtime;
using Microsoft.SqlServer.Dts.Tasks.BulkInsertTask;

namespace Breakpoint_API
{
    class Program
    {
        static void Main(string[] args)
        {
            Package pkg = new Package();
            TaskHost taskHost = (TaskHost)pkg.Executables.Add("STOCK:FileSystemTask");
            BreakpointTargets bptargets = pkg.GetBreakpointTargets(taskHost, false);
            foreach (BreakpointTarget bpt in bptargets)
            {
                Console.WriteLine("BreakOnExpressionChange? {0}", bpt.BreakOnExpressionChange.ToString());
                Console.WriteLine("Description              {0}", bpt.Description);
                Console.WriteLine("Enabled?                 {0}", bpt.Enabled);
                Console.WriteLine("HitCount                 {0}", bpt.HitCount);
                Console.WriteLine("HitTarget                {0}", bpt.HitTarget);
                Console.WriteLine("HitTest                  {0}", bpt.HitTest);
                Console.WriteLine("ID                       {0}", bpt.ID);
                Console.WriteLine("Owner                    {0}", bpt.Owner);
            }
        }
    }
}

Imports System
Imports System.Collections.Generic
Imports System.Text
Imports Microsoft.SqlServer.Dts.Runtime
Imports Microsoft.SqlServer.Dts.Tasks.BulkInsertTask
 
Namespace Breakpoint_API
    Class Program
        Shared  Sub Main(ByVal args() As String)
            Dim pkg As Package =  New Package() 
            Dim taskHost As TaskHost = CType(pkg.Executables.Add("STOCK:FileSystemTask"), TaskHost)
            Dim bptargets As BreakpointTargets =  pkg.GetBreakpointTargets(taskHost,False) 
            Dim bpt As BreakpointTarget
            For Each bpt In bptargets
                Console.WriteLine("BreakOnExpressionChange? {0}", bpt.BreakOnExpressionChange.ToString())
                Console.WriteLine("Description              {0}", bpt.Description)
                Console.WriteLine("Enabled?                 {0}", bpt.Enabled)
                Console.WriteLine("HitCount                 {0}", bpt.HitCount)
                Console.WriteLine("HitTarget                {0}", bpt.HitTarget)
                Console.WriteLine("HitTest                  {0}", bpt.HitTest)
                Console.WriteLine("ID                       {0}", bpt.ID)
                Console.WriteLine("Owner                    {0}", bpt.Owner)
            Next
        End Sub
    End Class
End Namespace

サンプルの出力 :

BreakOnExpressionChange?False

Description Break when the container receives the OnPreExecute event

Enabled?False

HitCount 0

HitTarget 0

HitTest Always

ID -2147483647

Owner Microsoft.SqlServer.Dts.Runtime.TaskHost

スレッド セーフ

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

プラットフォーム

開発プラットフォーム

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

対象プラットフォーム

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

参照

関連項目

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