Reference3.Identity, propriété

Article
11/15/2012

Obtient l'identificateur unique de la référence.

Espace de noms : VSLangProj80
Assembly : VSLangProj80 (dans VSLangProj80.dll)

Syntaxe

'Déclaration
ReadOnly Property Identity As String

string Identity { get; }

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

abstract Identity : string

function get Identity () : String

Valeur de propriété

Type : System.String
La chaîne retournée dépend du type référence.

Type référence	Valeur de retour
Assembly	Nom d'assembly (sans chemin d'accès, ni extension)
COM	Le format est : "GUID\major.minor\localeid\wrappertool" Par exemple : "{00000205-0000-0010-8000-00AA006D2EA4}\2.5\409\tlbimp" est retourné pour ActiveX Data Objects 2.5.
Natif	Identité d'assembly de l'assembly référencé.

Assembly

Nom d'assembly (sans chemin d'accès, ni extension)

COM

Le format est :

"GUID\major.minor\localeid\wrappertool"

Par exemple :

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

est retourné pour ActiveX Data Objects 2.5.

Natif

Identité d'assembly de l'assembly référencé.

Notes

Tous les composants possèdent un identificateur unique.La propriété Identity obtient cette information.Cette propriété est unique pour chaque référence, car une exception est levée si vous tentez d'ajouter une référence ayant la même identité qu'une autre référence déjà présente dans la collection.Cette propriété convient pour l'indexation de la collection Reference3 à l'aide de la méthode Item.

Exemples

Cet exemple ajoute un assembly et une référence COM à un projet Visual Basic ou Visual C# ouvert et affiche la propriété Identity de chacun.Pour exécuter cet exemple comme un complément, consultez Comment : compiler et exécuter les exemples de code du modèle objet Automation.

Les chemins d'accès par défaut pour les références ajoutées sont : <racine d'installation>\Program Files\Microsoft.NET\Primary Interop Assemblies pour adodb.dll et <racine d'installation>\Program Files\Common Files\SpeechEngines\Microsoft pour spcommon.dll.Dans l'exemple, remplacez <chemin d'accès au fichier> par ceux-ci ou par d'autres chemins appropriés.

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

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

Reference3 Interface

Identity, surcharge

VSLangProj80, espace de noms

Partager via