次の方法で共有


DTSBreakpointHitTest Enumeration

ヒット カウントの種類に対して値を列挙します。このクラスは、BreakpointTarget クラスと連携して動作します。

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

構文

'宣言
Public Enumeration DTSBreakpointHitTest
public enum DTSBreakpointHitTest
public enum class DTSBreakpointHitTest
public enum DTSBreakpointHitTest
public enum DTSBreakpointHitTest

メンバ

メンバ名 説明
Always ブレークポイントにヒットすると、常に実行が中断されます。
Equal ブレークポイントの発生回数がヒット カウントと等しくなると実行が中断されます。
Expression 式が変化すると実行が中断されます。
GreaterOrEqual ブレークポイントの発生回数がヒット カウント以上になると実行が中断されます。
Multiple ヒット カウントの倍数だけブレークポイントが発生すると実行が中断されます。

解説

ブレークポイントの柔軟性と能力を高めるには、ブレークポイントのヒット カウントとヒット カウントの種類を構成することで、ブレークポイントの動作を変更することができます。ヒット カウントは、何度ブレークポイントが発生したらランタイム エンジンを中断するかを指定するもので、ヒット カウントの種類は、いつブレークポイントにヒットするかを指定する式を含みます。この値は、HitTest プロパティで使用されます。

使用例

次のコード例では、この列挙を使用して BreakpointTarget の既定値を変更します。

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

namespace Microsoft.SqlServer.SSIS.Samples
{
    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);

            // Get the first breakpoint in the collection.
            BreakpointTargetEnumerator myEnumerator = bptargets.GetEnumerator();
            myEnumerator.MoveNext();
            BreakpointTarget bptFirstOne = myEnumerator.Current;

            // Display the initial values.
            Console.WriteLine("Description              {0}", bptFirstOne.Description);
            Console.WriteLine("Enabled?                 {0}", bptFirstOne.Enabled);
            Console.WriteLine("HitTest                  {0}", bptFirstOne.HitTest);
            Console.WriteLine("ID                       {0}", bptFirstOne.ID);
            Console.WriteLine("--------------------------------------------");

            // Modify the default value of HitTest.
            myEnumerator.Reset();
            myEnumerator.MoveNext();
            bptFirstOne = myEnumerator.Current;
            bptFirstOne.HitTest = DTSBreakpointHitTest.Equal;

            // Display the values again, including the new HitTest.
            Console.WriteLine("Description              {0}", bptFirstOne.Description);
            Console.WriteLine("Enabled?                 {0}", bptFirstOne.Enabled);
            Console.WriteLine("HitTest                  {0}", bptFirstOne.HitTest);
            Console.WriteLine("ID                       {0}", bptFirstOne.ID);
        }
    }
}
Imports System
Imports System.Collections.Generic
Imports System.Text
Imports Microsoft.SqlServer.Dts.Runtime

Namespace Microsoft.SqlServer.SSIS.Samples
    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) 
 
            ' Get the first breakpoint in the collection.
            Dim myEnumerator As BreakpointTargetEnumerator =  bptargets.GetEnumerator() 
            myEnumerator.MoveNext()
            Dim bptFirstOne As BreakpointTarget =  myEnumerator.Current 
 
            ' Display the initial values.
            Console.WriteLine("Description              {0}", bptFirstOne.Description)
            Console.WriteLine("Enabled?                 {0}", bptFirstOne.Enabled)
            Console.WriteLine("HitTest                  {0}", bptFirstOne.HitTest)
            Console.WriteLine("ID                       {0}", bptFirstOne.ID)
            Console.WriteLine("--------------------------------------------")
 
            ' Modify the default value of HitTest.
            myEnumerator.Reset()
            myEnumerator.MoveNext()
            bptFirstOne = myEnumerator.Current
            bptFirstOne.HitTest = DTSBreakpointHitTest.Equal
 
            ' Display the values again, including the new HitTest.
            Console.WriteLine("Description              {0}", bptFirstOne.Description)
            Console.WriteLine("Enabled?                 {0}", bptFirstOne.Enabled)
            Console.WriteLine("HitTest                  {0}", bptFirstOne.HitTest)
            Console.WriteLine("ID                       {0}", bptFirstOne.ID)
        End Sub
    End Class
End Namespace

サンプルの出力 :

Description Break when the container receives the OnPreExecute event

Enabled?False

HitTest Always

ID -2147483647

--------------------------------------------

Description Break when the container receives the OnPreExecute event

Enabled?False

HitTest Equal

ID -2147483647

プラットフォーム

開発プラットフォーム

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

対象プラットフォーム

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

参照

関連項目

Microsoft.SqlServer.Dts.Runtime Namespace