DllImportAttribute.BestFitMapping Pole

Definice

Obor názvů:

System.Runtime.InteropServices

Sestavení:

System.Runtime.InteropServices.dll

Zdroj:

DllImportAttribute.cs

Povolí nebo zakáže nejlepší chování mapování při převodu znaků Unicode na znaky ANSI.

public: bool BestFitMapping;

public bool BestFitMapping;

val mutable BestFitMapping : bool

Public BestFitMapping As Boolean 

Hodnota pole

Boolean

Příklady

V některých případech používají vývojáři jazyka DllImportAttributeVisual Basic k definování funkce knihovny DLL ve spravovaném kódu místo Declare příkazu . BestFitMapping Jedním z těchto případů je nastavení pole. Následující příklad ukazuje, jak použít nejpřísnější zabezpečení mapování znaků na definice metody volání platformy zadáním znakové sady ANSI, zakázáním chování mapování co nejlépe přizpůsobit a vyvoláním výjimky pro nemapované znaky Unicode.

[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

Poznámky

Pokud trueje povolené chování mapování nejvhodnějších řešení, v opačném případě je mapování nejvhodnějšího nastavení zakázané. Pole BestFitMapping je true ve výchozím nastavení. Nastavení pro toto pole přepíší nastavení libovolné úrovně atributu System.Runtime.InteropServices.BestFitMappingAttribute .

Upozornění

Některé znaky Unicode se převedou na nebezpečné znaky, například znak zpětného lomítka \, který může neúmyslně změnit cestu. Nastavením ThrowOnUnmappableChar pole na truehodnotu můžete volajícímu signalizovat přítomnost nemapovatelného znaku vyvoláním výjimky.

Upozornění

Výchozí hodnoty zadané BestFitMapping poli a ThrowOnUnmappableChar nelze změnit při předávání spravovaného pole, jehož prvky jsou znaky ANSI nebo LPSTR nespravované bezpečné pole. Mapování nejlepších potřeb je vždy povolené a nedochází k žádné výjimce. Mějte na paměti, že tato kombinace může ohrozit váš model zabezpečení.

Viz také

• CharSet
• BestFitMappingAttribute
• Zařazování spolupráce