Engines.Item (Método)
Obtiene un miembro indizado de una colección Engines.
Espacio de nombres: EnvDTE80
Ensamblado: EnvDTE80 (en EnvDTE80.dll)
Sintaxis
'Declaración
Function Item ( _
index As Object _
) As Engine
Engine Item(
Object index
)
Engine^ Item(
[InAttribute] Object^ index
)
abstract Item :
index:Object -> Engine
function Item(
index : Object
) : Engine
Parámetros
- index
Tipo: System.Object
Valor devuelto
Tipo: EnvDTE80.Engine
Objeto Engine.
Comentarios
El valor para Index puede ser:
BSTR que representa las primeras letras del nombre completo del motor.
BSTR que representa el GUID del motor.
Valor entero basado en uno.
El método Item produce una excepción ArgumentException si la colección no puede encontrar el objeto que corresponde al valor de índice.
Nota
Cuando se graba una macro y se asocia a un proceso de depuración mediante el motor de depuración de T-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 sucede porque en realidad hay dos motores de depuración de T-SQL subyacentes en Visual Studio: uno para el motor de depuración de SQL Server 2005 y otro para el motor de depuración de T-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 T-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
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.