BestFitMappingAttribute Класс

Определение

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

Наследование

Object

Attribute

BestFitMappingAttribute

Атрибуты

AttributeUsageAttribute ComVisibleAttribute

Примеры

В следующем примере показано, как отключить оптимальное сопоставление и создать исключение для преобразования символов Юникода в "?" Символ ANSI. Настройка BestFitMappingAttribute параметров таким образом обеспечивает добавленную меру безопасности.

[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

Комментарии

Этот атрибут можно применить к сборке, интерфейсу, классу или структуре.

BestFitMappingAttribute предоставляет два параметра для управления аспектами сопоставления с оптимальным соответствием. Вы используете первый параметр, чтобы включить и отключить сопоставление, подходящее для оптимального соответствия. Значением по умолчанию является trueсопоставление, которое обеспечивает оптимальное сопоставление на уровнях сборки, интерфейса и класса. Атрибут, применяемый к интерфейсу или классу, переопределяет атрибут уровня сборки. Вы также можете включить или отключить сопоставление, подходящее для вызовов платформы, с помощью DllImportAttribute.BestFitMapping поля. Значение, заданное полем вызова платформы, переопределяет все уровни BestFitMappingAttribute.

Второй параметр можно использовать для управления исключением для неуправляемых символов. Значением по умолчанию для ThrowOnUnmappableChar поля является falseотключение исключения при каждом обнаружении символа Юникода, который должен быть преобразован в "?" Символ ANSI. Даже если сопоставление trueлучше всего подходит, неуправляемые символы создают исключение при ThrowOnUnmappableChar наличии trueполя. Чтобы ужесточить безопасность, можно переключить первый параметр на false и второй параметр true. Эта комбинация параметров включает оптимальное сопоставление, но включает механизм создания исключений в качестве меры предосторожности.

См. также раздел

• BestFitMapping
• Маршалинг межоперационных взаимодействий