Reference3.Identity (Propiedad)

Obtiene el identificador único de la referencia.

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

Sintaxis

'Declaración
ReadOnly Property Identity As String
    Get

string Identity { get; }

property String^ Identity {
    String^ get ();
}

abstract Identity : string

function get Identity () : String

Valor de propiedad

Tipo: System.String
La cadena devuelta depende del tipo de referencia.

Tipo de referencia	Valor devuelto
Ensamblado	Nombre del ensamblado (nombre del ensamblado sin ruta de acceso ni extensión).
COM	El formato es: "GUID\major.minor\localeid\wrappertool" Por ejemplo, "{00000205-0000-0010-8000-00AA006D2EA4}\2.5\409\tlbimp" es el resultado que se devuelve para Objetos de datos ActiveX 2.5.
Nativo	Identidad del ensamblado al que se hace referencia.

Implementaciones

Reference2.Identity

Comentarios

Todos los componentes tienen un identificador único. La propiedad Identity obtiene esta información. Esta propiedad es única para cada referencia, puesto que se produce una excepción si se intenta agregar una referencia con la misma identidad que otra referencia que ya esté en la colección. Esta propiedad es adecuada para indizar la colección Reference3 utilizando el método Item.

Ejemplos

En este ejemplo se agregan un ensamblado y una referencia COM a un proyecto de Visual Basic o Visual C# abierto y se muestra la propiedad Identity para cada uno. Para ejecutar este ejemplo como complemento, vea Cómo: Compilar y ejecutar los ejemplos de código del modelo de objetos de automatización.

Las rutas de acceso predeterminadas para la referencia agregada son: <raíz de instalación>\Archivos de programa\Microsoft.NET\Primary Interop Assemblies for adodb.dll y <raíz de instalación>\Archivos de programa\Common Files\SpeechEngines\Microsoft for spcommon.dll. En el ejemplo, reemplace <file path> por éstas u otras rutas de acceso a archivos apropiadas.

Imports VSLangProj
Imports VSLangProj2
Imports VSLangProj80
Public Sub OnConnection(ByVal application As Object,_
 ByVal connectMode As ext_ConnectMode, ByVal addInInst As Object, _
 ByRef custom As Array) Implements IDTExtensibility2.OnConnection
    applicationObject = CType(application, DTE2)
    addInInstance = CType(addInInst, AddIn)
    ShowIdentity (applicationObject)
End Sub
Sub ShowIdentity(ByVal dte As DTE2)
    Dim aProject As Project
    Dim aVSProject As VSProject2
    aProject = applicationObject.Solution.Projects.Item(1)
    aVSProject = _
CType(applicationObject.Solution.Projects.Item(1).Object, VSProject2)
    ' Add an Assembly reference and display its identity.
    Dim newRef As Reference3
    ' Replace the <file path> with an actual file path.
    newRef = aVSProject.References.Add("<file path>\adodb.dll")
    MsgBox("Added an Assembly reference, named: " & newRef.Name)
    MsgBox("The Identity of " & newRef.Name & " is " & newRef.Identity)
    ' Add a COM reference and display its identity.
    ' Replace the <file path> with an actual file path.
    newRef = aVSProject.References.Add("<file path>\spcommon.dll")
    MsgBox("Added a COM reference, named: " & newRef.Name)
    MsgBox("The Identity of " & newRef.Name & " is " & newRef.Identity)
End Sub

using System.Windows.Forms;
using VSLangProj;
using VSLangProj2;
using VSLangProj80;
public void OnConnection(object application,
 ext_ConnectMode connectMode, object addInInst, ref Array custom)
{
    applicationObject = (DTE2)application;
    addInInstance = (AddIn)addInInst;
    ShowIdentity(((DTE2)applicationObject));
}
public void ShowIdentity(DTE2 dte)
{
    // The first project is a Visual Basic or C# project.
    VSProject2 vsProject = 
((VSProject2)(applicationObject.Solution.Projects.Item(1).Object));
    Reference3 aRef = null;
    // Add an Assembly reference and display its identity.
    // Replace <file path> with an actual file path.
    aRef = (Reference3)vsProject.References.Add
(@"<file path>\adodb.dll");
    MessageBox.Show("Added an Assembly reference, named: " 
+ aRef.Name);
    MessageBox.Show("The Identity of " + aRef.Name + " is " 
+ aRef.Identity);
    // Add a COM reference and display its identity.
    // Replace <file path> with an actual file path.
    aRef = (Reference3)vsProject.References.Add
(@"<file path>\spcommon.dll");
    MessageBox.Show("Added a COM reference, named: " 
+ aRef.Name);
    MessageBox.Show("The Identity of " + aRef.Name + " is " 
+ aRef.Identity);
}

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.

Vea también

Referencia

Reference3 Interfaz

Identity (Sobrecarga)

VSLangProj80 (Espacio de nombres)