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 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。