Proprietà Reference3.Description

Articolo
08/11/2011

Ottiene una descrizione del riferimento.

Spazio dei nomi: VSLangProj80
Assembly: VSLangProj80 (in VSLangProj80.dll)

Sintassi

'Dichiarazione
ReadOnly Property Description As String
    Get

string Description { get; }

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

abstract Description : string

function get Description () : String

Valore proprietà

Tipo: System.String
Nel caso di un oggetto Reference, il valore restituito dipende dal tipo di riferimento.

Tipo di riferimento	Valore restituito
Assembly	Descrizione dell'assembly.
COM	Descrizione della libreria di tipi.

Implementa

Reference2.Description

Note

La proprietà Description e la proprietà Name di un riferimento hanno funzioni e lunghezze diverse. La proprietà Name, ad esempio System.Windows.Forms, è concepita per essere descrittiva e allo stesso tempo breve. La proprietà Description può essere più lunga e contenere informazioni più dettagliate. Inoltre, ha la stessa funzione della descrizione di una libreria dei tipi COM.

La proprietà Description è archiviata nell'assembly come attributo personalizzato, a differenza della maggior parte delle altre proprietà esposte dall'oggetto Reference, che vengono archiviate nei metadati.

Questa proprietà di sola lettura può essere modificata nell'ambiente di sviluppo modificando gli attributi personalizzati nel file AssemblyInfo.vb (per i progetti di Visual Basic) o nel file AssemblyInfo.cs (per i progetti di Visual C#).

Esempi

Nell'esempio riportato di seguito vengono visualizzate le stringhe Description per tutti i riferimenti in un progetto aperto di Visual Basic o Visual C#. Per eseguire questo esempio come componente aggiuntivo, vedere Procedura: compilare ed eseguire gli esempi di codice del modello a oggetti di automazione.

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)
    DisplayDescriptions(applicationObject)
End Sub
Public Sub DisplayDescriptions(ByVal dte As DTE2)
    ' The first project is a Visual Basic or C# project.
    Dim vsProject As VSProject2 = _
    CType(applicationObject.Solution.Projects.Item(1).Object, _
    VSProject2)
    Dim aRef As Reference3
    Dim refStr As String
    refStr = ""
    For Each aRef In vsProject.References
        refStr += (aRef.Name & "'s description is:  " _
        & aRef.Description.ToString() & vbCr & vbCr)
    Next
    MsgBox(refStr)
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;
    DisplayDescriptions(((DTE2)applicationObject));
}
public void DisplayDescriptions(DTE2 dte)
{
    // The first project is a Visual Basic or C# project.
    VSProject2 vsProject = ((VSProject2)
 (applicationObject.Solution.Projects.Item(1).Object));
    Reference aRef = null;
    string refStr = null;
    foreach (VSLangProj80.Reference3 temp in vsProject.References)
    {
        aRef = temp;
        refStr += (aRef.Name + "'s Description is:   " 
+ aRef.Description.ToString() + "\n" + "\n");
    }
    MessageBox.Show(refStr);
}

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

Reference3 Interfaccia

Overload Description

Spazio dei nomi VSLangProj80

Condividi tramite