ControlCollection.AddListObject, méthode (Range, String)

Article
01/06/2014

Ajoute un nouveau contrôle ListObject à la feuille de calcul à la plage spécifiée.

Espace de noms : Microsoft.Office.Tools.Excel
Assembly : Microsoft.Office.Tools.Excel (dans Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Déclaration
Function AddListObject ( _
    range As Range, _
    name As String _
) As ListObject

ListObject AddListObject(
    Range range,
    string name
)

Paramètres

range
Type : Microsoft.Office.Interop.Excel.Range
Range qui fournit les limites du contrôle.

name
Type : System.String
Nom du contrôle qui peut être utilisé pour indexer le contrôle dans l'instance ControlCollection.

Valeur de retour

Type : Microsoft.Office.Tools.Excel.ListObject
Contrôle ListObject qui a été ajouté à l'instance de ControlCollection.

Exceptions

Exception	Condition
ArgumentNullException	L'argument de nom ou de plage a la valeur nullune référence null (Nothing en Visual Basic) ou l'argument de nom a une longueur nulle.
ControlNameAlreadyExistsException	Un contrôle du même nom se trouve déjà dans l'instance de ControlCollection.
InvalidRangeException	La plage spécifiée n'est pas valide. Les plages sur plusieurs zones ne peuvent pas être utilisées. La plage doit se trouver dans la même feuille de calcul que l'instance de ControlCollection.

Notes

La méthode AddListObject vous permet d'ajouter des contrôles ListObject à la fin de ControlCollection. Pour supprimer un contrôle ListObject précédemment ajouté par programme, utilisez la méthode Remove.

Exemples

L'exemple de code suivant ajoute un contrôle ListObject en haut de la feuille de calcul, puis affiche un message indiquant le nombre de lignes de 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.");
}

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.