Tipos de layout automático não devem ser visível com.

Artigo
08/25/2010

TypeName	AutoLayoutTypesShouldNotBeComVisible
CheckId	CA1403
Category (Categoria)	Microsoft.interoperabilidade
Quebrando alterar	Quebrando

Causa

Um tipo de valor visível COM é marcado com o System.Runtime.InteropServices.StructLayoutAttribute atributo definido como LayoutKind.Auto.

Descrição da regra

Auto tipos de layout são gerenciado pelo common linguagem tempo de execução. O layout desses tipos pode alterar entre versões do .NET estrutura, que serão quebradas COM clientes que esperam um layout específico.Observe que, se o StructLayoutAttribute atributo não for especificado, os compiladores de C++, Visual Basic e translation from VPE for Csharp especificar o Sequential layout para os tipos de valor.

A menos que marcado caso contrário, todos os tipos não genéricos públicos são visíveis para com.; todos os tipos genéricos e não-públicos são invisível para COM.No entanto, para reduzir os falsos positivos, essa regra requer a visibilidade de COM do tipo a ser declarado explicitamente, o assembly contendo deve ser marcado com o System.Runtime.InteropServices.ComVisibleAttribute definido como false o tipo deve ser com o ComVisibleAttribute definido como true.

Como corrigir violações

Para corrigir uma violação dessa regra alterar o valor do StructLayoutAttribute atributo à Explicit ou Sequential, ou fazer com que o tipo invisível para COM.

Quando suprimir avisos

Não suprimir um aviso da regra.

Exemplo

O exemplo a seguir mostra um tipo que viola a regra e um tipo que satisfaça a regra.

Imports System
Imports System.Runtime.InteropServices

<Assembly: ComVisibleAttribute(False)>
Namespace InteroperabilityLibrary

   ' This violates the rule.
   <StructLayoutAttribute(LayoutKind.Auto)> _ 
   <ComVisibleAttribute(True)> _ 
   Public Structure AutoLayout

      Dim ValueOne As Integer
      Dim ValueTwo As Integer 

   End Structure

   ' This satisfies the rule.
   <StructLayoutAttribute(LayoutKind.Explicit)> _ 
   <ComVisibleAttribute(True)> _ 
   Public Structure ExplicitLayout

      <FieldOffsetAttribute(0)> _ 
      Dim ValueOne As Integer

      <FieldOffsetAttribute(4)> _ 
      Dim ValueTwo As Integer 

   End Structure

End Namespace

using System;
using System.Runtime.InteropServices;

[assembly: ComVisible(false)]
namespace InteroperabilityLibrary
{
   // This violates the rule.
   [StructLayout(LayoutKind.Auto)]
   [ComVisible(true)]
   public struct AutoLayout
   {
      public int ValueOne;
      public int ValueTwo;
   }

   // This satisfies the rule.
   [StructLayout(LayoutKind.Explicit)]
   [ComVisible(true)]
   public struct ExplicitLayout
   {
      [FieldOffset(0)]
      public int ValueOne;

      [FieldOffset(4)]
      public  int ValueTwo;
   }
}