Engine (Interfaz)

Motor de depuración utilizado para asignar a tipo de código.

Espacio de nombres:  EnvDTE80
Ensamblado:  EnvDTE80 (en EnvDTE80.dll)

Sintaxis

'Declaración
<GuidAttribute("8CEA6D39-EBEE-4DE9-B282-B5CECE9C9861")> _
Public Interface Engine

[GuidAttribute("8CEA6D39-EBEE-4DE9-B282-B5CECE9C9861")]
public interface Engine

[GuidAttribute(L"8CEA6D39-EBEE-4DE9-B282-B5CECE9C9861")]
public interface class Engine

[<GuidAttribute("8CEA6D39-EBEE-4DE9-B282-B5CECE9C9861")>]
type Engine =  interface end

public interface Engine

El tipo Engine expone los siguientes miembros.

Propiedades

	Nombre	Descripción
	AttachResult	Obtiene un resultado que indica si en un motor asociado se produjo un error o no.
	Collection	Obtiene la colección Engines.
	DTE	Obtiene el objeto de extensibilidad de nivel superior.
	ID	Obtiene el identificador como GUID del motor de depuración.
	Name	Obtiene el nombre del objeto Engine.
	Parent	Obtiene el objeto primario inmediato de un objeto Engine.

Arriba

Comentarios

Sirve para determinar cómo funcionará el depurador basándose en el código. Esto corresponde a la ventana Asociar al proceso.

Un objeto Engine se utiliza para especificar qué tipo de programas se pretende depurar en un proceso determinado. Por ejemplo, si sólo desea depurar código administrado dentro de un proceso, asocie al proceso utilizando el motor de depuración "Common Language Runtime". Si desea depurar tanto las partes administradas como las no administradas de un proceso, asocie con el motor "Interop COM+".

Nota

Cuando se graba una macro y se adjunta a un proceso de depuración mediante el motor de depuración de Transact-SQL, la macro devuelve dos referencias independientes al mismo nombre de motor. Por ejemplo, dbgeng(0) = transprt.Engines.Item("T-SQL") y dbgeng(1) = transprt.Engines.Item("T-SQL"). Esto ocurre porque en realidad hay dos motores de depuración Transact-SQL subyacentes en Visual Studio: uno para el motor de depuración SQL Server 2005, otro para el motor de depuración Transact-SQL para SQL Server 2000 y SQL Server 7. Al conectarse a un proceso del motor de depuración a través de la interfaz de usuario, se hace referencia a ambos automáticamente; pero en el código de automatización, debe hacerse referencia a cada uno de ellos usando sus identificadores únicos globales (GUID). El GUID de SQL Server 2005 es {1202F5B4-3522-4149-BAD8-58B2079D704F} y el GUID del motor de depuración de Transact-SQL para SQL Server 2000 y SQL Server 7 es {5AF6F83C-B555-11D1-8418-00C04FA302A1}. Así que las llamadas anteriores se deberían cambiar a dbgeng(0) = trans.Engines.Item("{1202F5B4-3522-4149-BAD8-58B2079D704F}") y dbgeng(1) = trans.Engines.Item("{1202F5B4-3522-4149-BAD8-58B2079D704F}"), respectivamente.

Ejemplos

' Macro code.
Imports EnvDTE
Imports EnvDTE80
Imports System.Diagnostics
Imports Microsoft.VisualBasic.ControlChars

Public Module Module1

    Sub ShowDefaultEngines()
        Dim dbg As EnvDTE80.Debugger2
        dbg = DTE.Debugger

        dbg.HexDisplayMode = True

        Dim transport As EnvDTE80.Transport
        transport = dbg.Transports.Item("default")

        Dim engine As EnvDTE80.Engine
        Dim strEngineList As String
        For Each engine In transport.Engines
            strEngineList = strEngineList + engine.Name + ", " + _
            engine.ID + ", " + engine.AttachResult.ToString + NewLine
        Next
        MsgBox(strEngineList)
    End Sub
End Module

Vea también

Referencia

EnvDTE80 (Espacio de nombres)

Engines