DTSBreakpointHitTest 列挙型

定義

名前空間:

Microsoft.SqlServer.Dts.Runtime

アセンブリ:

Microsoft.SqlServer.ManagedDTS.dll

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

public enum class DTSBreakpointHitTest

public enum DTSBreakpointHitTest

type DTSBreakpointHitTest = 

Public Enum DTSBreakpointHitTest

継承

Enum

DTSBreakpointHitTest

フィールド

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

例

次のコード例では、この列挙を使用して 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  

サンプル出力:

説明 コンテナーが OnPreExecute イベントを受信すると中断する

有効? False

HitTest Always

ID -2147483647

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

説明 コンテナーが OnPreExecute イベントを受信すると中断する

有効? False

HitTest Equal

ID -2147483647

注釈

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