Información general de la serialización en C++/CLI
En modo mixto, deben serializar los datos entre los tipos nativos y los administrados. La biblioteca de serialización le ayuda a serializar y convertir los datos de una manera sencilla. La biblioteca de serialización consta de un conjunto de funciones y una clase marshal_context que realiza serializaciones para tipos comunes. La biblioteca se define en estos encabezados en el directorio include/msclr de la edición de Visual Studio:
| Encabezado | Descripción |
|---|---|
| serializar.h | Funciones de serialización sin contexto y clase de marshal_context |
| serializar_atl.h | Funciones para serializar tipos ATL |
| serializar_cppstd.h | Funciones para serializar tipos estándar de C++ |
| marshal_windows.h | Funciones para serializar tipos de Windows |
La ruta de acceso predeterminada para la carpeta msclr es similar a esta en función de la edición que tenga y el número de compilación:
C:\\Program Files (x86)\\Microsoft Visual Studio\\Preview\\Enterprise\\VC\\Tools\\MSVC\\14.15.26528\\include\\msclr
Puede utilizar la biblioteca de serialización de referencias con o sin una clase marshal_context. Algunas conversiones requieren un contexto. Otras conversiones se pueden implementar mediante la función marshal_as. En la tabla siguiente se enumeran las conversiones actuales compatibles y se indica si requieren un contexto y el archivo de serializar que se debe incluir:
| De tipo | A tipo | Método serializar | Incluir archivo |
|---|---|---|---|
| System::String^ | const char* | serializar_context | serializar.h |
| const char* | System::String^ | serializar_as | serializar.h |
| char * | System::String^ | serializar_as | serializar.h |
| System::String^ | const wchar_t* | serializar_context | serializar.h |
| const wchar_t* | System::String^ | serializar_as | serializar.h |
| wchar_t * | System::String^ | serializar_as | serializar.h |
| System::IntPtr | HANDLE | serializar_as | marshal_windows.h |
| HANDLE | System::IntPtr | serializar_as | marshal_windows.h |
| System::String^ | BSTR | serializar_context | marshal_windows.h |
| BSTR | System::String^ | serializar_as | serializar.h |
| System::String^ | bstr_t | serializar_as | marshal_windows.h |
| bstr_t | System::String^ | serializar_as | marshal_windows.h |
| System::String^ | std::string | serializar_as | serializar_cppstd.h |
| std::string | System::String^ | serializar_as | serializar_cppstd.h |
| System::String^ | std::wstring | serializar_as | serializar_cppstd.h |
| std::wstring | System::String^ | serializar_as | serializar_cppstd.h |
| System::String^ | <char> | serializar_as | serializar_atl.h |
| <char> | System::String^ | serializar_as | serializar_atl.h |
| System::String^ | <wchar_t> | serializar_as | serializar_atl.h |
| <wchar_t> | System::String^ | serializar_as | serializar_atl.h |
| System::String^ | CComBSTR | serializar_as | serializar_atl.h |
| CComBSTR | System::String^ | serializar_as | serializar_atl.h |
El cálculo de referencias requiere un contexto solo cuando se calcula de tipos de datos administrados a tipos de datos nativos y el tipo nativo que se va a convertir no tiene un destructor para la limpieza automática. El contexto de serialización destruye el tipo de datos nativo asignado en su destructor. Por consiguiente, las conversiones que requieren un contexto serán válidas solo hasta que se elimine el contexto. Para guardar cualquier valor de cálculo de referencias, debe copiar los valores a sus propias variables.
Nota:
Si ha incrustado valores NULLen la cadena, el resultado de serializar la cadena no se puede garantizar. Los valores NULL incrustados pueden hacer que la cadena se trunque o no pueda conservarse.
Este ejemplo muestra cómo incluir el directorio msclr en una declaración de encabezado de inclusión:
#include "msclr\marshal_cppstd.h"
La biblioteca de cálculo de referencias es extensible para que pueda agregar sus propios tipos de serialización. Para obtener más información sobre cómo extender la biblioteca de serialización, vea Cómo: Extender la biblioteca de serialización.
Consulte también
Biblioteca de compatibilidad de C++
Cómo: Extender la biblioteca de serialización