Propriedade Reference3.Identity

Artigo
10/26/2012

Obtém o identificador exclusivo da referência.

Namespace: VSLangProj80
Assembly: VSLangProj80 (em VSLangProj80.dll)

Sintaxe

'Declaração
ReadOnly Property Identity As String

string Identity { get; }

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

abstract Identity : string

function get Identity () : String

Valor de propriedade

Tipo: System.String
A seqüência de caracteres retornada depende do tipo de referência.

Tipo de referência	Valor retornado
Assembly	Nome de assembly (nome de assembly sem o caminho ou extensão)
COM	O formato é: "GUID\major.minor\localeid\wrappertool" Por exemplo, "{00000205-0000-0010-8000-00AA006D2EA4}\2.5\409\tlbimp" é retornado 2.5 de objetos de dados de ActiveX.
Nativo	Identidade do assembly do assembly referenciado.

Assembly

Nome de assembly (nome de assembly sem o caminho ou extensão)

COM

O formato é:

"GUID\major.minor\localeid\wrappertool"

Por exemplo,

"{00000205-0000-0010-8000-00AA006D2EA4}\2.5\409\tlbimp"

é retornado 2.5 de objetos de dados de ActiveX.

Nativo

Identidade do assembly do assembly referenciado.

Comentários

Todos os componentes têm um identificador exclusivo.O Identity propriedade obtém essas informações.Esta propriedade é exclusiva para cada referência, como uma exceção é gerada se você tentar adicionar uma referência com a mesma identidade como uma referência que já está na coleção.Esta propriedade é adequada para a indexação de Reference3 coleção usando o Item método.

Exemplos

Este exemplo adiciona um Assembly e uma referência COM uma abertura Visual Basic ou Visual C# de projeto e exibe o Identity propriedade para cada um.Para executar este exemplo como um add-in, consulte Como: compilar e executar os exemplos de código de modelo de objeto de automação.

Os caminhos padrão para a referência adicionados são: < raiz da instalação >\Program Files\Microsoft.NET\Primary Interop Assemblies para adodb.dll, e < raiz da instalação >\Program Files\Common Files\SpeechEngines\Microsoft para spcommon.dll.Substituir < caminho do arquivo > no exemplo com esses ou outros caminhos de arquivo apropriado.

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);
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

Reference3 Interface

Sobrecargas Identity

Namespace VSLangProj80

Partilhar via