• [アーティクル]

DTSBreakpointHitTest 列挙体

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

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

構文

'宣言
Public Enumeration DTSBreakpointHitTest
'使用
Dim instance As DTSBreakpointHitTest

public enum DTSBreakpointHitTest

public enum class DTSBreakpointHitTest

type DTSBreakpointHitTest

public enum DTSBreakpointHitTest

メンバー

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

説明

ブレークポイントの柔軟性と能力を高めるには、ブレークポイントのヒット カウントとヒット カウントの種類を構成することで、ブレークポイントの動作を変更することができます。ヒット カウントは、何度ブレークポイントが発生したらランタイム エンジンを中断するかを指定するもので、ヒット カウントの種類は、いつブレークポイントにヒットするかを指定する式を含みます。この値は、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