Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here.

Do not use AutoDual ClassInterfaceType







Breaking Change


A COM visible type is marked with the System.Runtime.InteropServices.ClassInterfaceAttribute attribute set to ClassInterfaceType.AutoDual.

Types that use a dual interface allow clients to bind to a specific interface layout. Any changes in a future version to the layout of the type or any base types will break COM clients that bind to the interface. By default, if the ClassInterfaceAttribute attribute is not specified, a dispatch-only interface is used.

Unless marked otherwise, all public non-generic types are visible to COM; all non-public and generic types are invisible to COM.

To fix a violation of this rule change the value of the ClassInterfaceAttribute attribute to None and explicitly define the interface.

Do not suppress a warning from this rule unless it is certain that the layout of the type and its base types will not change in a future version.

The following example shows a class that violates the rule and a re-declaration of the class to use an explicit interface.

Imports System
Imports System.Runtime.InteropServices

<Assembly: ComVisibleAttribute(True)>
Namespace InteroperabilityLibrary

   ' This violates the rule.
   <ClassInterfaceAttribute(ClassInterfaceType.AutoDual)> _ 
   Public Class DualInterface
      Public Sub SomeSub
      End Sub 
   End Class 

   Public Interface IExplicitInterface
      Sub SomeSub
   End Interface

   <ClassInterfaceAttribute(ClassInterfaceType.None)> _ 
   Public Class ExplicitInterface
      Implements IExplicitInterface

      Public Sub SomeSub Implements IExplicitInterface.SomeSub
      End Sub 

   End Class 

End Namespace

Community Additions

© 2015 Microsoft