Metodo ControlCollection.AddListObject (Range, String)

Articolo
08/11/2011

Aggiunge un nuovo controllo ListObject al foglio di lavoro in corrispondenza dell'intervallo specificato.

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

Sintassi

'Dichiarazione
Function AddListObject ( _
    range As Range, _
    name As String _
) As ListObject

ListObject AddListObject(
    Range range,
    string name
)

Parametri

range
Tipo: Microsoft.Office.Interop.Excel.Range
Oggetto Range che fornisce i limiti per il controllo.

name
Tipo: System.String
Nome del controllo che può essere utilizzato per indicizzare il controllo nell'istanza di ControlCollection.

Valore restituito

Tipo: Microsoft.Office.Tools.Excel.ListObject
Controllo ListObject aggiunto all'istanza di ControlCollection.

Eccezioni

Eccezione	Condizione
ArgumentNullException	L'argomento relativo al nome o all'intervallo è nullriferimento null (Nothing in Visual Basic) oppure la lunghezza dell'argomento relativo al nome è zero.
ControlNameAlreadyExistsException	Nell'istanza di ControlCollection è già presente un controllo con lo stesso nome.
InvalidRangeException	L'intervallo specificato non è valido. Impossibile utilizzare gli intervalli di più aree. L'intervallo deve trovarsi nello stesso foglio di lavoro dell'istanza di ControlCollection.

Note

Il metodo AddListObject consente di aggiungere controlli ListObject alla fine dell'oggetto ControlCollection. Per rimuovere un controllo ListObject aggiunto in precedenza a livello di codice, utilizzare il metodo Remove.

Esempi

Nell'esempio di codice riportato di seguito viene aggiunto un controllo ListObject alla parte superiore del foglio di lavoro, quindi viene visualizzata una finestra di messaggio che indica il numero di righe presenti nell'oggetto ListObject.

Private Sub ExcelAddListObject()
    Dim List1 As Microsoft.Office.Tools.Excel. _
        ListObject = Me.Controls.AddListObject( _
        Me.Range("A1", "C5"), "List1")

    MessageBox.Show("The list object has " _
        & List1.Range.Rows.Count.ToString() + " rows.")

End Sub

private void ExcelAddListObject()
{
    Microsoft.Office.Tools.Excel.ListObject list1 =
        this.Controls.AddListObject(this.Range["A1", "C5"], 
        "list1");
    MessageBox.Show("The list object has " + 
        list1.Range.Rows.Count.ToString() + " rows.");
}

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.