Vue d’ensemble du marshaling en C++/CLI

En mode mixte, vous devez parfois marshaler vos données entre les types natifs et managés. La bibliothèque de marshaling vous permet de marshaler et de convertir des données de manière simple. La bibliothèque de marshaling se compose d’un ensemble de fonctions et d’une marshal_context classe qui effectuent le marshaling pour les types courants. La bibliothèque est définie dans ces en-têtes dans le répertoire include/msclr de votre édition Visual Studio :

En-tête	Description
marshal.h	marshal_context fonctions de marshaling sans classe et sans contexte
marshal_atl.h	Fonctions pour marshaler les types ATL
marshal_cppstd.h	Fonctions pour marshaler les types C++ standard
marshal_windows.h	Fonctions pour marshaler les types Windows

Le chemin d’accès par défaut pour le dossier msclr est similaire à celui-ci en fonction de l’édition que vous avez et du numéro de build :

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

Vous pouvez utiliser la bibliothèque de marshaling avec ou sans classe marshal_context. Certaines conversions nécessitent un contexte. D’autres conversions peuvent être implémentées à l’aide de la fonction marshal_as . Le tableau suivant répertorie les conversions actuelles prises en charge, qu’elles nécessitent un contexte et le fichier de marshaling que vous devez inclure :

À partir du type	Pour taper	Marshaler la méthode	Inclut le fichier
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^	Char CStringT<>	marshal_as	marshal_atl.h
Char CStringT<>	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

Le marshaling nécessite un contexte uniquement lorsque vous marshalez des types de données managés vers des types de données natifs et que le type natif que vous convertissez en n’a pas de destructeur pour les propre automatiques. Le contexte de marshaling détruit le type de données natif alloué dans son destructeur. Par conséquent, les conversions qui nécessitent un contexte ne seront valides que jusqu’à ce que le contexte soit supprimé. Pour enregistrer les valeurs marshalées, vous devez copier les valeurs dans vos propres variables.

Remarque

Si vous avez incorporé NULLdes éléments dans votre chaîne, le résultat du marshaling de la chaîne n’est pas garanti. Les s incorporés NULLpeuvent entraîner la troncation de la chaîne ou elles peuvent être conservées.

Cet exemple montre comment inclure le répertoire msclr dans une déclaration d’en-tête Include :

#include "msclr\marshal_cppstd.h"

La bibliothèque de marshaling est extensible pour pouvoir ajouter vos propres types de marshaling. Pour plus d’informations sur l’extension de la bibliothèque de marshaling, consultez Guide pratique pour étendre la bibliothèque de marshaling.

Voir aussi

Bibliothèque de prise en charge C++
Guide pratique pour étendre la bibliothèque de marshaling