ControlCollection.AddListObject-Methode (ListObject) (2007 System)

Článek
08/23/2008

Aktualisiert: Juli 2008

Fügt der Steuerelementauflistung ein Visual Studio Tools for Office Microsoft.Office.Tools.Excel.ListObject auf Grundlage des angegebenen systemeigenen Microsoft.Office.Interop.Excel.ListObject hinzu.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel.v9.0 (in Microsoft.Office.Tools.Excel.v9.0.dll)

Syntax

'Declaration
Public Function AddListObject ( _
    listObject As ListObject _
) As ListObject
'Usage
Dim instance As ControlCollection
Dim listObject As ListObject
Dim returnValue As ListObject

returnValue = instance.AddListObject(listObject)

public ListObject AddListObject(
    ListObject listObject
)

Parameter

listObject
Typ: Microsoft.Office.Interop.Excel.ListObject

Das systemeigene ListObject.

Rückgabewert

Typ: Microsoft.Office.Tools.Excel.ListObject

Das Visual Studio Tools for Office-Microsoft.Office.Tools.Excel.ListObject, das der Steuerelementauflistung hinzugefügt wurde.

Ausnahmen

Ausnahme	Bedingung
ArgumentNullException	Das listObject-Argument ist nullNULL-Verweis (Nothing in Visual Basic) oder hat die Länge 0 (null).
ControlNameAlreadyExistsException	Der ControlCollection-Instanz wurde bereits ein ListObject-Steuerelement mit dem gleichen Namen hinzugefügt.

Hinweise

Rufen Sie diese Methode nach Möglichkeit nicht direkt aus Ihrem eigenen Code auf. Rufen Sie stattdessen die ListObjectExtensions.GetVstoObject-Erweiterungsmethode auf, um ein Visual Studio Tools for Office Microsoft.Office.Tools.Excel.ListObject abzurufen.

Die ListObjectExtensions.GetVstoObject-Erweiterungsmethode verwendet diese Methode zum Generieren eines Visual Studio Tools for Office-Microsoft.Office.Tools.Excel.ListObject, das einer Instanz eines systemeigenen Microsoft.Office.Interop.Excel.ListObject entspricht.

Die ListObjectExtensions.GetVstoObject-Erweiterungsmethode erstellt nur einmal ein erweitertes Microsoft.Office.Tools.Excel.ListObject. Bei nachfolgenden Aufrufen wird dieselbe Instanz des vorhandenen erweiterten Objekts zurückgegeben. Im Gegensatz dazu erstellt AddListObject jedes Mal ein neues erweitertes Microsoft.Office.Tools.Excel.ListObject.

Berechtigungen

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.