DtsContainer.DebugMode プロパティ

定義

名前空間:

Microsoft.SqlServer.Dts.Runtime

アセンブリ:

Microsoft.SqlServer.ManagedDTS.dll

オブジェクトがデバッグ モードかどうか、および実行中にイベントを DtsContainer 発生させる必要があるかどうかを示すブール型 (Boolean) の値を OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) 取得または設定します。

public:
 property bool DebugMode { bool get(); void set(bool value); };

public bool DebugMode { get; set; }

member this.DebugMode : bool with get, set

Public Property DebugMode As Boolean

プロパティ値

Boolean

true は、オブジェクトがデバッグ モードであることを示し、イベントを OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) 発生させます。

実装

DebugMode

例

Package クラスは、DtsContainer の継承によって EventsProvider を実装します。 次のコード例では、パッケージを作成した後、DtsContainer から継承した値を表示および設定します。

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)  
        {  
            // The package is the ExecuteProcess package sample   
            // that is installed with the SSIS samples.  
            string pkg = @"C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\Package Samples\ExecuteProcess Sample\ExecuteProcess\UsingExecuteProcess.dtsx";  

            Application app = new Application();  
            Package p1 = app.LoadPackage(pkg, null);  

            // Show the properties inherited from DtsContainer.  
            Console.WriteLine("CreationName:    {0}", p1.CreationName);  
            Console.WriteLine("DebugMode:       {0}", p1.DebugMode);  
            Console.WriteLine("DelayValidation: {0}", p1.DelayValidation);  
            Console.WriteLine("Description:     {0}", p1.Description);  
            Console.WriteLine("Disable:         {0}", p1.Disable);  

            // Description is not set for this sample, so set it.  
            p1.Description = "This is the Execute Process Package Sample";  
            Console.WriteLine("Description after modification: {0}", p1.Description);  

            Console.WriteLine();  
        }  
    }  
}  

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)  
            ' The package is the ExecuteProcess package sample   
            ' that is installed with the SSIS samples.  
            Dim pkg As String =  "C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\Package Samples\ExecuteProcess Sample\ExecuteProcess\UsingExecuteProcess.dtsx"   

            Dim app As Application =  New Application()   
            Dim p1 As Package =  app.LoadPackage(pkg,Nothing)   

            ' Show the properties inherited from DtsContainer.  
            Console.WriteLine("CreationName:    {0}", p1.CreationName)  
            Console.WriteLine("DebugMode:       {0}", p1.DebugMode)  
            Console.WriteLine("DelayValidation: {0}", p1.DelayValidation)  
            Console.WriteLine("Description:     {0}", p1.Description)  
            Console.WriteLine("Disable:         {0}", p1.Disable)  

            ' Description is not set for this sample, so set it.  
            p1.Description = "This is the Execute Process Package Sample"  
            Console.WriteLine("Description after modification: {0}", p1.Description)  

            Console.WriteLine()  
        End Sub  
    End Class  
End Namespace  

サンプル出力:

CreationName: MSDTS.Package.1

DebugMode: False

DelayValidation: True

説明:

無効: False

Description after modification: This is the Execute Process Package Sample

注釈

IsBreakpointTargetEnabled 関数は、タスクがコード内のブレークポイントに到達するたびに呼び出されます。 IsBreakpointTargetEnabled 関数を呼び出してブレークポイント ターゲットが有効であるかどうかを確認すると、繰り返し呼び出した場合に負担が大きいため、DebugMode フラグがオーバーライドされ、その実行ファイルをデバックするかどうかを示すために各継承クラスによって使用されます。 このフラグが false に設定されている場合は、タスクは、有効なブレークポイントを確認する呼び出しを回避できます。 値が true の場合、タスクが有効なブレークポイントを確認する必要があることを示し、その場合は IsBreakpointTargetEnabled が確認されます。