Ejemplo: serializar y deserializar una instancia de entidad
Este ejemplo muestra cómo serializar las instancias de entidad de enlace en tiempo de compilación y en tiempo de ejecución a un formato XML, y cómo deserializar de un formato XML a una instancia de entidad de enlace en tiempo de compilación.
Puede descargar el ejemplo desde aquí.
Nota
Este ejemplo se aplica tanto a Dynamics 365 Customer Engagement (on-premises) como a Dataverse.
Cómo ejecutar esta muestra
Para obtener una copia local de todas las muestras y compilarlas, siga estos pasos:
- Descargar o clonar el informe de Muestras para que tenga una copia local.
- (Opcional) Edite el archivo dataverse/App.config para definir una cadena de conexión que especifique la instancia o la organización a la que desea conectarse.
- Abra la solución de ejemplo en Visual Studio y presione F5 para ejecutar la muestra. Una vez que especifique una cadena de conexión en dataverse/App.config, cualquier muestra que ejecute utilizará esa información de conexión.
Si no especifica una cadena de conexión en el archivo dataverse/App.config, se abre un diálogo cada vez que ejecute la muestra y tendrá que introducir información acerca de a qué instancia u org desea conectarse y qué credenciales desea usar. Este diálogo guardará en caché conexiones anteriores para que pueda elegir una conexión usada previamente.
Qué hace este ejemplo
El mensaje DataContractSerializer
está destinado a utilizarse en un escenario en el que serializa y deserializa una instancia de un tipo en una secuencia o documento XML utilizando un contrato de datos suministrado. Esta clase no puede heredarse.
Cómo funciona este ejemplo
Para simular el escenario descrito en Qué hace este ejemplo, el ejemplo hará lo siguiente:
Configuración
- Comprobaciones para la versión actual de la organización.
- El método
CreateRequiredRecords
crea los datos de ejemplo necesarios para el ejemplo.
Demostración
- El método
DataContractSerializer
serializa los registros de contacto en XML y los escribe en el disco duro. - El método
earlyBoundSerializer
deserializa la instancia de la entidad.
Limpiar
Muestra una opción para eliminar los registros creados en la Configuración. La eliminación es opcional en caso de que desee examinar las entidades y los datos creados por el ejemplo. Puede eliminar manualmente los registros para obtener el mismo resultado.