BestFitMappingAttribute Classe

Definição

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Origem:

BestFitMappingAttribute.cs

Controla se os caracteres Unicode são convertidos em caracteres ANSI correspondentes mais próximos.

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)>]
type BestFitMappingAttribute = class
    inherit Attribute

Public NotInheritable Class BestFitMappingAttribute
Inherits Attribute

Herança

Object

Attribute

BestFitMappingAttribute

Atributos

AttributeUsageAttribute

Exemplos

O exemplo a seguir mostra como desabilitar o mapeamento de melhor ajuste e gerar uma exceção na conversão de caracteres Unicode para '?' 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.

Cuidado

Alguns caracteres não têm uma representação de melhor ajuste; esses caracteres são chamados de inaplicativos. Caracteres não aplicativos geralmente são convertidos no padrão '?' Caractere ANSI. Determinados caracteres Unicode são convertidos em caracteres perigosos, como o caractere de barra invertida '\', que pode alterar inadvertidamente um caminho.

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 permite 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, os caracteres não aplicaíveis geram uma exceção quando o ThrowOnUnmappableChar campo é true. Para reforçar a segurança, você pode alternar o primeiro parâmetro para 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ção como uma precaução de segurança.

Cuidado

Você não pode alterar os valores padrão fornecidos por BestFitMappingAttribute ao passar uma matriz gerenciada cujos elementos são ANSI Chars ou LPSTRs para uma matriz segura não gerenciada. O mapeamento de melhor ajuste está sempre habilitado e nenhuma exceção pode ser gerada. Lembre-se de que essa combinação pode comprometer seu modelo de segurança.

Construtores

BestFitMappingAttribute(Boolean)

Inicializa uma nova instância da classe BestFitMappingAttribute definida com o valor da propriedade BestFitMapping.

Campos

ThrowOnUnmappableChar

Habilita ou desabilita a geração de uma exceção em um caractere Unicode não mapeável que é convertido em um caractere "?" ANSI.

Propriedades

BestFitMapping	Obtém o comportamento de mapeamento de melhor ajuste ao converter caracteres Unicode em caracteres ANSI.
TypeId	Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute. (Herdado de Attribute)

Métodos

Equals(Object)	Retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
GetHashCode()	Retorna o código hash para a instância. (Herdado de Attribute)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsDefaultAttribute()	Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada. (Herdado de Attribute)
Match(Object)	Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• BestFitMapping
• Realizando marshaling de interoperabilidade