DtsContainer.DebugMode Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или устанавливает булевое изображение, которое показывает, находится DtsContainer ли объект в режиме отладки и следует ли запускать 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
Значение свойства
True указывает, что объект находится в режиме отладки, и запускает событие OnBreakpointHit(IDTSBreakpointSite, BreakpointTarget) .
Реализации
Примеры
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
Пример вывода:
Название: MSDTS. Пакет.1
DebugMode: ложно
DelayValidation: Верно
Описание:
Отключить: ложно
Описание после модификации: Это образец пакета Execute Process
Комментарии
IsBreakpointTargetEnabled Функция вызывается каждый раз, когда задача сталкивается с точкой остановки в коде. Поскольку вызов функции IsBreakpointTargetEnabled для проверки, включена ли цель точки остановки, дорого обходится при многократном вызове, этот DebugMode флаг переписывается и используется каждым наследующим классом для указания, нужно ли отладить этот исполняемый файл. Когда этот флаг установлен на false, задачи могут избежать вызова проверки включённой точки остановки. Значение указывает true на то, что задача должна проверять включенные точки остановки, а — когда отмечено .IsBreakpointTargetEnabled