BestFitMappingAttribute Classe

Definição

public ref class BestFitMappingAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Struct, Inherited=false)]
public sealed class BestFitMappingAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Struct, Inherited=false)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class BestFitMappingAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Struct, Inherited=false)>]
type BestFitMappingAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Interface | System.AttributeTargets.Struct, Inherited=false)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type BestFitMappingAttribute = class
    inherit Attribute

Public NotInheritable Class BestFitMappingAttribute
Inherits Attribute

Herança

Object

Attribute

BestFitMappingAttribute

Atributos

AttributeUsageAttribute ComVisibleAttribute

Exemplos

O exemplo a seguir mostra como desabilitar o melhor mapeamento de ajuste e lançar uma exceção na conversão de caracteres Unicode para o '?' Caractere ANSI. Definir BestFitMappingAttribute parâmetros dessa maneira fornece uma medida adicional de segurança.

[BestFitMapping(false, ThrowOnUnmappableChar = true)]
interface class IMyInterface1
{
     //Insert code here.
};

[BestFitMapping(false, ThrowOnUnmappableChar = true)]
interface IMyInterface1
{
     //Insert code here.
}

<BestFitMapping(False, ThrowOnUnmappableChar := True)> _
Interface IMyInterface1
     'Insert code here.
End Interface

Comentários

Você pode aplicar esse atributo a um assembly, interface, classe ou estrutura.

BestFitMappingAttribute fornece dois parâmetros para controlar aspectos do mapeamento de melhor ajuste. Use o primeiro parâmetro para ativar e desativar o mapeamento de melhor ajuste. O valor padrão é true, que habilita o mapeamento de melhor ajuste nos níveis de assembly, interface e classe. Um atributo aplicado a uma interface ou classe substitui um atributo no nível do assembly. Da mesma forma, você pode habilitar ou desabilitar o mapeamento de melhor ajuste para chamadas de invocação de plataforma usando o DllImportAttribute.BestFitMapping campo. Um valor definido pelo campo de invocação de plataforma substitui todos os níveis de BestFitMappingAttribute.

Você pode usar o segundo parâmetro para controlar a geração de uma exceção em caracteres inaplicativos. O valor padrão para o ThrowOnUnmappableChar campo é false, que desabilita a geração de uma exceção sempre que o runtime encontra um caractere Unicode que precisa ser convertido em '?' Caractere ANSI. Mesmo que o mapeamento de melhor ajuste seja true, caracteres inaplicativos geram uma exceção quando o ThrowOnUnmappableChar campo é true. Para reforçar a segurança, você pode alternar o primeiro parâmetro false e o segundo parâmetro para true. Essa combinação de configurações de parâmetro desativa o mapeamento de melhor ajuste, mas habilita o mecanismo de lançamento de exceções como uma precaução de segurança.

Confira também

• BestFitMapping
• Realizando marshaling de interoperabilidade