Übersicht über Marshaling in C++/CLI

Im gemischten Modus müssen Sie die Daten zwischen nativen und verwalteten Typen manchmal marshallen. Die Marshaling-Bibliothek hilft Ihnen, Daten auf einfache Weise zu marshallen und zu konvertieren. Die Marshaling-Bibliothek besteht aus einer Reihe von Funktionen und einer marshal_context Klasse, die Marshalling für allgemeine Typen durchführt. Die Bibliothek wird in diesen Headern im Include-/msclr-Verzeichnis für Ihre Visual Studio-Edition definiert:

Header	Beschreibung
marshal.h	marshal_context Klassen- und kontextfreie Marshalingfunktionen
marshal_atl.h	Funktionen zum Marshallen von ATL-Typen
marshal_cppstd.h	Funktionen für marshallende Standard-C++-Typen
marshal_windows.h	Funktionen zum Marshallen von Windows-Typen

Der Standardpfad für den Ordner "msclr " ist in etwa so, je nachdem, welche Edition Sie haben und welche Buildnummer Sie haben:

C:\\Program Files (x86)\\Microsoft Visual Studio\\Preview\\Enterprise\\VC\\Tools\\MSVC\\14.15.26528\\include\\msclr

Sie können die Marshaling-Bibliothek mit oder ohne eine marshal_context Klasse verwenden. Einige Konvertierungen erfordern einen Kontext. Andere Konvertierungen können mithilfe der marshal_as-Funktion implementiert werden. Die folgende Tabelle enthält eine Liste der aktuell unterstützten Konvertierungen und Informationen dazu, ob sie einen Kontext benötigen und welche Marschalldatei Sie hinzufügen müssen:

Von Typ	in Typ	Marschallmethode	Includedatei
System::String^	const char*	marshal_context	marshal.h
const char*	System::String^	marshal_as	marshal.h
char *	System::String^	marshal_as	marshal.h
System::String^	const wchar_t*	marshal_context	marshal.h
const wchar_t*	System::String^	marshal_as	marshal.h
wchar_t *	System::String^	marshal_as	marshal.h
System::IntPtr	HANDLE	marshal_as	marshal_windows.h
HANDLE	System::IntPtr	marshal_as	marshal_windows.h
System::String^	BSTR	marshal_context	marshal_windows.h
BSTR	System::String^	marshal_as	marshal.h
System::String^	bstr_t	marshal_as	marshal_windows.h
bstr_t	System::String^	marshal_as	marshal_windows.h
System::String^	std::string	marshal_as	marshal_cppstd.h
std::string	System::String^	marshal_as	marshal_cppstd.h
System::String^	std::wstring	marshal_as	marshal_cppstd.h
std::wstring	System::String^	marshal_as	marshal_cppstd.h
System::String^	CStringT-Zeichen<>	marshal_as	marshal_atl.h
CStringT-Zeichen<>	System::String^	marshal_as	marshal_atl.h
System::String^	CStringT-wchar_t<>	marshal_as	marshal_atl.h
CStringT-wchar_t<>	System::String^	marshal_as	marshal_atl.h
System::String^	CComBSTR	marshal_as	marshal_atl.h
CComBSTR	System::String^	marshal_as	marshal_atl.h

Marshalling erfordert nur einen Kontext, wenn Sie von verwalteten in systemeigene Datentypen marshallen und der systemeigene Typ, den Sie konvertieren, keinen Destruktor zur automatischen Bereinigung besitzt. Der Marshallingkontext zerstört den zugeordneten nativen Datentyp in seinem Destruktor. Daher sind Konvertierungen, die einen Kontext erfordern, nur gültig, bis der Kontext gelöscht wird. Um alle gemarshallten Werte zu speichern, müssen Sie die Werte in Ihre eigenen Variablen kopieren.

Hinweis

Wenn Sie NULL in die Zeichenfolge eingebettet haben, ist das Ergebnis des Marshallens der Zeichenfolge nicht garantiert. Durch eine eingebettete NULL kann die Zeichenfolge abgeschnitten oder beibehalten werden.

Dieses Beispiel zeigt, wie das Verzeichnis "msclr" einer Includeheaderdeklaration hinzugefügt wird:

#include "msclr\marshal_cppstd.h"

Die Marshallingbibliothek ist erweiterbar, sodass Sie eigene Marshallingtypen hinzufügen können. Weitere Informationen zum Erweitern der Marshaling-Bibliothek finden Sie unter How to: Extend the Marshaling Library.

Siehe auch

C++-Standardbibliothek
Vorgehensweise: Erweitern der Marshallingbibliothek