ControlCollection.AddListObject メソッド (ListObject) (2007 System)

[アーティクル]
08/22/2008

更新 : 2008 年 7 月

指定されたネイティブな Microsoft.Office.Interop.Excel.ListObject に基づくコントロールコレクションに Visual Studio Tools for Office Microsoft.Office.Tools.Excel.ListObject を追加します。

名前空間 : Microsoft.Office.Tools.Excel
アセンブリ : Microsoft.Office.Tools.Excel.v9.0 (Microsoft.Office.Tools.Excel.v9.0.dll 内)

構文

'宣言
Public Function AddListObject ( _
    listObject As ListObject _
) As ListObject
'使用
Dim instance As ControlCollection
Dim listObject As ListObject
Dim returnValue As ListObject

returnValue = instance.AddListObject(listObject)

public ListObject AddListObject(
    ListObject listObject
)

パラメータ

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

ネイティブな ListObject。

戻り値

型 : Microsoft.Office.Tools.Excel.ListObject

コントロールコレクションに追加された Visual Studio Tools for Office Microsoft.Office.Tools.Excel.ListObject。

例外

例外	条件
ArgumentNullException	listObject 引数が nullnull 参照 (Visual Basic では Nothing) であるか、または長さが 0 である場合。
ControlNameAlreadyExistsException	同じ名前の ListObject コントロールが既に ControlCollection インスタンスに追加されている場合。

解説

独自のコードからこのメソッドを直接呼び出さないでください。代わりに、ListObjectExtensions.GetVstoObject 拡張メソッドを呼び出して Visual Studio Tools for Office Microsoft.Office.Tools.Excel.ListObject を取得します。

ListObjectExtensions.GetVstoObject 拡張メソッドはこのメソッドを使用して、ネイティブな Microsoft.Office.Interop.Excel.ListObject のインスタンスに対応する Visual Studio Tools for Office Microsoft.Office.Tools.Excel.ListObject を生成します。

ListObjectExtensions.GetVstoObject 拡張メソッドが拡張された Microsoft.Office.Tools.Excel.ListObject を作成するのは 1 回だけです。それ以降の呼び出しでは、既存の拡張オブジェクトの同じインスタンスが返されます。これに対して、AddListObject は、拡張された Microsoft.Office.Tools.Excel.ListObject を、毎回、新しく作成します。