DtsContainer.DebugMode Proprietà

Definizione

Spazio dei nomi:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Ottiene o imposta un Booleano che indica se l'oggetto DtsContainer è in modalità debug e se deve attivare l'evento OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) durante l'esecuzione.

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

Valore della proprietà

Boolean

true indica che l'oggetto è in modalità debug e attiva l'evento OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) .

Implementazioni

DebugMode

Esempio

La Package classe implementa il DtsContainer tramite la sua ereditarietà del EventsProvider. Il seguente esempio di codice crea un pacchetto, poi visualizza e stabilisce valori ereditati da 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  

Output di esempio:

NomeCreazione: MSDTS. Pacchetto.1

DebugMode: Falso

RitardoValidazione: Vero

Descrizione:

Disabilita: Falso

Descrizione dopo la modifica: Questo è l'esempio del pacchetto Execute Process

Commenti

La IsBreakpointTargetEnabled funzione viene chiamata ogni volta che il compito incontra un punto di interruzione nel suo codice. Poiché chiamare la funzione IsBreakpointTargetEnabled per verificare se il target di breakpoint è abilitato è costoso se chiamato ripetutamente, il DebugMode flag viene sovrascritto e usato da ciascuna classe ereditante per indicare se quell'eseguibile deve essere debuggato. Quando questo flag è impostato su false, i task possono evitare la chiamata per verificare un punto di interruzione abilitato. Un valore di true indica che il compito dovrebbe controllare i punti di interruzione abilitati, ed è quando il IsBreakpointTargetEnabled viene selezionato.