Panoramica del marshalling in C++/CLI

In modalità mista, a volte è necessario effettuare il marshalling dei dati tra tipi nativi e gestiti. La libreria di marshalling consente di effettuare il marshalling e convertire i dati in modo semplice. La libreria di marshalling è costituita da un set di funzioni e da una marshal_context classe che eseguono il marshalling per i tipi comuni. La libreria è definita in queste intestazioni nella directory include/msclr per l'edizione di Visual Studio:

Intestazione	Descrizione
marshal.h	marshal_context funzioni di marshalling senza contesto e di classe
marshal_atl.h	Funzioni per il marshalling dei tipi ATL
marshal_cppstd.h	Funzioni per il marshalling dei tipi C++ standard
marshal_windows.h	Funzioni per il marshalling dei tipi di Windows

Il percorso predefinito per la cartella msclr è simile al seguente a seconda dell'edizione in uso e del numero di build:

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

È possibile usare la libreria di marshalling con o senza una classe marshal_context. Alcune conversioni richiedono un contesto. È possibile implementare altre conversioni usando la funzione marshal_as . La tabella seguente elenca le conversioni correnti supportate, se richiedono un contesto e quale file di marshalling è necessario includere:

Da tipo	Per digitare	Metodo di marshalling	Includi file
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<char>	marshal_as	marshal_atl.h
CStringT<char>	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

Il marshalling richiede un contesto solo quando si esegue il marshalling da tipi di dati gestiti a nativi e il tipo nativo in in non dispone di un distruttore per la pulizia automatica. Il contesto di marshalling elimina definitivamente il tipo di dati nativo allocato nel distruttore. Pertanto, le conversioni che richiedono un contesto saranno valide solo fino all'eliminazione del contesto. Per salvare i valori di cui è stato sottoposto a marshalling, è necessario copiare i valori nelle proprie variabili.

Nota

Se la stringa è stata incorporata NULL, il risultato del marshalling della stringa non è garantito. L'oggetto incorporato NULLpuò causare il troncamento della stringa o la conservazione.

Questo esempio mostra come includere la directory msclr in una dichiarazione di intestazione di inclusione:

#include "msclr\marshal_cppstd.h"

La libreria di marshalling è estendibile in modo da poter aggiungere tipi di marshalling personalizzati. Per altre informazioni sull'estensione della libreria di marshalling, vedere Procedura: Estendere la libreria di marshalling.

Vedi anche

Libreria di supporto per C++
Procedura: Estendere la libreria del marshalling