ListObjectExtensions.HasVstoObject Method (ListObject, ApplicationFactory)

Returns a value that indicates whether a Microsoft.Office.Tools.Excel.ListObject host control has been created for the current Microsoft.Office.Interop.Excel.ListObject object in an application-level add-in. Pass the Globals.Factory object in your project to the factory parameter.

Namespace:  Microsoft.Office.Tools.Excel.Extensions
Assembly:  Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntax

'Declaration
<ExtensionAttribute> _
Public Shared Function HasVstoObject ( _
    listObject As ListObject, _
    factory As ApplicationFactory _
) As Boolean

public static bool HasVstoObject(
    this ListObject listObject,
    ApplicationFactory factory
)

Parameters

• listObject
  Type: Microsoft.Office.Interop.Excel.ListObject

  The native list object to test. Do not supply this parameter yourself. When you call this method on an Excel list object, the runtime supplies this parameter.

• factory
  Type: Microsoft.Office.Tools.Excel.ApplicationFactory

  An object that provides access to certain features in your application-level add-in. Pass the Globals.Factory object to this parameter.

Return Value

Type: System.Boolean
true if a Microsoft.Office.Tools.Excel.ListObject host control has been created for the current Microsoft.Office.Interop.Excel.ListObject object; otherwise, false.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type ListObject. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

Remarks

In an application-level add-in, you can call this method to determine whether a Microsoft.Office.Tools.Excel.ListObject host control exists for any Microsoft.Office.Interop.Excel.ListObject object. Typically, you use this method to test for the existence of managed controls that you want to persist before closing or saving an Excel list object.

This method is provided for backward compatibility with Office projects that you retarget from the .NET Framework 3.5 to the .NET Framework 4 or the .NET Framework 4.5. In new projects that target the .NET Framework 4 or the .NET Framework 4.5, you should call the GetVstoObject method that is provided by the Globals.Factory object in your project. For more information, see Extending Word Documents and Excel Workbooks in Application-Level Add-ins at Run Time.

.NET Framework Security

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

See Also

Reference

ListObjectExtensions Class

HasVstoObject Overload

Microsoft.Office.Tools.Excel.Extensions Namespace

Other Resources

Extending Word Documents and Excel Workbooks in Application-Level Add-ins at Run Time

Extension Methods (C# Programming Guide)

Extension Methods (Visual Basic)