Panoramica del marshalling in C++/CLI

  • Articolo

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