Metodo ApplicationFactory.GetVstoObject (ListObject)

Articolo
01/06/2014

Restituisce un elemento host Microsoft.Office.Tools.Excel.ListObject che estende la funzionalità dell'oggetto elenco nativo specificato.

Spazio dei nomi: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)
Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintassi

'Dichiarazione
Function GetVstoObject ( _
    listObject As ListObject _
) As ListObject

ListObject GetVstoObject(
    ListObject listObject
)

Parametri

listObject
Tipo: Microsoft.Office.Interop.Excel.ListObject
Oggetto elenco nativo per il quale recuperare l'oggetto esteso.

Valore restituito

Tipo: Microsoft.Office.Tools.Excel.ListObject
Oggetto che estende la funzionalità dell'oggetto elenco nativo.

Note

Chiamare questo metodo in un componente aggiuntivo a livello di applicazione per personalizzare qualsiasi oggetto elenco in un foglio di lavoro di Excel. Questo metodo genera un nuovo oggetto Microsoft.Office.Tools.Excel.ListObject se un oggetto di questo tipo non è già stato generato. Le chiamate successive a questo metodo restituiscono l'istanza memorizzata nella cache dell'oggetto Microsoft.Office.Tools.Excel.ListObject esistente. Per ulteriori informazioni, vedere Estensione in fase di esecuzione di documenti di Word e di cartelle di lavoro di Excel in componenti aggiuntivi a livello di applicazione.

Esempi

Nell'esempio di codice riportato di seguito viene creato un elemento host Microsoft.Office.Tools.Excel.ListObject. Per utilizzare questo codice, eseguirlo dalla classe ThisAddIn in un progetto di componente aggiuntivo di Excel destinato a .NET Framework 4 o .NET Framework 4.5.

Dim mySheet As Excel.Worksheet = Me.Application.ActiveSheet
If mySheet.ListObjects.Count > 0 Then
    Dim vstoListObject As ListObject = _
        Globals.Factory.GetVstoObject(mySheet.ListObjects(1))

    vstoListObject.SetDataBinding(ds, "Product", "Name")
End If

Excel.Worksheet mySheet = (Excel.Worksheet)
    this.Application.Worksheets["Sheet1"];
if (mySheet.ListObjects.Count > 0)
{
    ListObject vstoListObject =
        Globals.Factory.GetVstoObject(mySheet.ListObjects[1]);

    vstoListObject.SetDataBinding(ds, "Product", "Name");
}

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.