Ü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