Condividi tramite


Metodo ControlCollection.AddListObject (Range, String)

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

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

Vedere anche

Riferimenti

ControlCollection Interfaccia

Overload AddListObject

Spazio dei nomi Microsoft.Office.Tools.Excel