Freigeben über


Deaktiviertes Runtime-Marshalling

Wenn das System.Runtime.CompilerServices.DisableRuntimeMarshallingAttribute-Attribut auf eine Assembly angewendet wird, deaktiviert die Runtime den Großteil der integrierten Unterstützung für das Daten-Marshalling zwischen verwalteten und nativen Darstellungen. In diesem Artikel werden die Features beschrieben, die deaktiviert sind, und wie .NET-Typen nativen Typen zugeordnet werden, wenn das Marshalling deaktiviert ist.

Szenarien mit deaktiviertem Marshalling

Wenn das DisableRuntimeMarshallingAttribute auf eine Assembly angewendet wird, wirkt sich dies auf P/Invokes- und Delegate-Typen in der Assembly sowie auf alle Aufrufe von nicht verwalteten Funktionszeigern in der Assembly aus. Dies wirkt sich nicht auf P/Invoke- oder Interop-Delegattypen aus, die in anderen Assemblys definiert sind. Außerdem wird das Marshalling für die integrierte COM-Interop-Unterstützung der Runtime nicht deaktiviert. Die integrierte COM-Interop-Unterstützung kann über einen Featureschalter aktiviert oder deaktiviert werden.

Deaktivierte Features

Wenn das DisableRuntimeMarshallingAttribute auf eine Assembly angewendet wird, haben die folgenden Attribute keine Auswirkung oder lösen eine Ausnahme aus:

  • LCIDConversionAttribute für einen P/Invoke oder einen Delegaten
  • SetLastError=true für einen P/Invoke
  • ThrowOnUnmappableChar=true für einen P/Invoke
  • BestFitMapping=true für einen P/Invoke
  • Methodensignaturen variadischer .NET-Argumente (varargs)
  • Parameter in, ref, out

Standardregeln für das Marshallen von häufig verwendeten Typen

Wenn Marshallen deaktiviert ist, ändern sich die Regeln für das Standard-Marshalling in wesentlich einfachere Regeln. Diese Regeln werden unten beschrieben. Wie in der Dokumentation zu bewährten Methoden für Interop erwähnt, sind für Blitting geeignete Typen Typen mit demselben Layout in verwaltetem und nativem Code, die daher kein Marshalling erfordern. Darüber hinaus können diese Regeln nicht mit den Tools angepasst werden, die in der Dokumentation zum Anpassen des Parameter-Marshallings erwähnt werden.

C#-Schlüsselwort .NET-Typ Nativer Typ
byte System.Byte uint8_t
sbyte System.SByte int8_t
short System.Int16 int16_t
ushort System.UInt16 uint16_t
int System.Int32 int32_t
uint System.UInt32 uint32_t
long System.Int64 int64_t
ulong System.UInt64 uint64_t
char System.Char char16_t (CharSet für P/Invoke hat keine Auswirkung)
nint System.IntPtr intptr_t
nuint System.UIntPtr uintptr_t
System.Boolean bool
Benutzerdefinierter C#-Typ unmanaged ohne Felder mit LayoutKind.Auto Wird als für Blitting geeigneter Typ behandelt. Das gesamte benutzerdefinierte Struktur-Marshalling wird ignoriert.
Alle anderen Typen nicht unterstützt

Beispiele

Das folgende Beispiel zeigt einige Features, die bei deaktiviertem Runtime-Marshalling aktiviert oder deaktiviert sind. Um die manuelle Anwendung dieser Anleitung zu veranschaulichen, verwenden diese Beispiele [DllImport] im Gegensatz zu dem empfohlenen [LibraryImport]-Attribut. Das Analysetool mit ID SYSLIB1054 bietet zusätzliche Anleitungen, wenn Sie [LibraryImport] verwenden.

using System.Runtime.InteropServices;

struct Unmanaged
{
    int i;
}

[StructLayout(LayoutKind.Auto)]
struct AutoLayout
{
    int i;
}

struct StructWithAutoLayoutField
{
    AutoLayout f;
}

[UnmanagedFunctionPointer] // OK: UnmanagedFunctionPointer attribute is supported
public delegate void Callback();

[UnmanagedFunctionPointer(CallingConvention.Cdecl)] // OK: Specifying a calling convention is supported
public delegate void Callback2(int i); // OK: primitive value types are allowed

[DllImport("NativeLibrary", EntryPoint = "CustomEntryPointName")] // OK: Specifying a custom entry-point name is supported
public static extern void Import(int i);

[DllImport("NativeLibrary", CallingConvention = CallingConvention.Cdecl)] // OK: Specifying a custom calling convention is supported
public static extern void Import(int i);

[UnmanagedCallConv(new[] { typeof(CallConvCdecl) })] // OK: Specifying a custom calling convention is supported
[DllImport("NativeLibrary")]
public static extern void Import(int i);

[DllImport("NativeLibrary", EntryPoint = "CustomEntryPointName", CharSet = CharSet.Unicode, ExactSpelling = false)] // OK: Specifying a custom entry-point name and using CharSet-based lookup is supported
public static extern void Import(int i);

[DllImport("NativeLibrary")] // OK: Not explicitly specifying an entry-point name is supported
public static extern void Import(Unmanaged u); // OK: unmanaged type

[DllImport("NativeLibrary")] // OK: Not explicitly specifying an entry-point name is supported
public static extern void Import(StructWithAutoLayoutField u); // Error: unmanaged type with auto-layout field

[DllImport("NativeLibrary")]
public static extern void Import(Callback callback); // Error: managed types are not supported when runtime marshalling is disabled