DllImportAttribute.ThrowOnUnmappableChar Поле

Определение

Пространство имен:

System.Runtime.InteropServices

Сборка:

System.Runtime.InteropServices.dll

Исходный код:

DllImportAttribute.cs

Включает и отключает возникновение исключений для неотображаемых символов Юникода, преобразующихся в знаки вопроса ("?") ANSI.

public: bool ThrowOnUnmappableChar;

public bool ThrowOnUnmappableChar;

val mutable ThrowOnUnmappableChar : bool

Public ThrowOnUnmappableChar As Boolean 

Значение поля

Boolean

Примеры

В некоторых случаях разработчики Visual Basic используют DllImportAttribute для определения функции DLL в управляемом коде Declare вместо оператора . ThrowOnUnmappableChar Задание поля является одним из таких случаев. В следующем примере показано, как применить строгую безопасность сопоставления символов к определениям методов вызова платформы, указав набор символов ANSI, отключив оптимальное поведение сопоставления и создав исключение для несопоставленных символов Юникода.

[DllImport("My.dll", CharSet = CharSet::Ansi,
    BestFitMapping = false,
    ThrowOnUnmappableChar = true)]
int SomeFuncion2(int parm);

[DllImport("My.dll", CharSet = CharSet.Ansi,
    BestFitMapping = false,
    ThrowOnUnmappableChar = true)]
internal static extern int SomeFuncion2(int parm);

<DllImport("My.dll", CharSet:=CharSet.Ansi,
    BestFitMapping:=False,
    ThrowOnUnmappableChar:=True)>
Friend Shared Function SomeFuncion2(parm As Integer) As Integer
End Function

Комментарии

true значение , чтобы указать, что исключение возникает каждый раз, когда маршалер взаимодействия преобразует неприменимый символ; false значение , чтобы указать, что ThrowOnUnmappableChar поле отключено. По умолчанию это поле имеет значение false.

Внимание!

Некоторые символы Юникода преобразуются в опасные символы, например символ обратной косой черты "\", который может случайно изменить путь. Задав ThrowOnUnmappableChar для поля значение true, можно сообщить вызывающей объекту о наличии неприменимого символа, создав исключение.

Внимание!

Нельзя изменить значения по умолчанию, предоставляемые полями BestFitMapping и ThrowOnUnmappableChar , при передаче управляемого массива, элементами которого являются символы ANSI или LPSTR, в неуправляемый безопасный массив. Лучшее сопоставление всегда включено, и исключение не создается. Имейте в виду, что такое сочетание может поставить под угрозу вашу модель безопасности.

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

• CharSet
• BestFitMapping
• Маршалинг взаимодействия