DiffGrams

Un DiffGram es un formato XML que identifica las versiones actual y original de los elementos de datos. El DataSet utiliza el formato DiffGram para cargar y hacer persistente su contenido, así como para serializar su contenido con el fin de transportarlo a través de una conexión de red. Cuando un DataSet se escribe como un DiffGram, llena el DiffGram con toda la información necesaria para volver a crear de forma precisa el contenido, aunque no el esquema del DataSet, incluyendo los valores de columna de las versiones de fila Original y Current, la información de error de fila y el orden de las filas.

Cuando se envía y recupera un DataSet desde un servicio Web XML, se utiliza implícitamente el formato DiffGram. Además, al cargar el contenido de un DataSet desde XML mediante el método ReadXml, o al escribir el contenido de un DataSet en XML mediante el método WriteXml, se puede seleccionar que el contenido se lea o se escriba como un DiffGram. Para obtener más información, vea Cargar DataSet desde XML y Escribir un objeto DataSet como datos XML.

Si bien .NET Framework utiliza principalmente el formato DiffGram como formato de serialización para el contenido de un DataSet, también es posible usar DiffGrams para modificar datos en tablas de una base de datos de Microsoft SQL Server.

Formato DiffGram

El formato DiffGram se divide en tres secciones: los datos actuales, los datos originales o "before" y una sección de errores, tal y como se muestra en el siguiente ejemplo.

<?xml version="1.0"?>
<diffgr:diffgram 
         xmlns:msdata="urn:schemas-microsoft-com:xml-msdata"
         xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1"
         xmlns:xsd="http://www.w3.org/2001/XMLSchema">

   <DataInstance>
   </DataInstance>

  <diffgr:before>
  </diffgr:before>

  <diffgr:errors>
  </diffgr:errors>
</diffgr:diffgram>

El formato DiffGram consta de los bloques de datos siguientes:

• <DataInstance>
  El nombre de este elemento, DataInstance, se utiliza con fines explicativos en esta documentación. Un elemento DataInstance representa un DataSet o una fila de una DataTable. En lugar de DataInstance, el elemento contendría el nombre del DataSet o de la DataTable. Este bloque del formato DiffGram contiene los datos actuales, se hayan modificado o no. Un elemento, o fila, que se haya modificado se identifica con la anotación diffgr:hasChanges.

• <diffgr:before>
  Este bloque del formato DiffGram contiene la versión original de una fila. Los elementos de este bloque se hacen coincidir con los del bloque DataInstance mediante la anotación diffgr:id.

• <diffgr:errors>
  Este bloque del formato DiffGram contiene información de error para una fila determinada del bloque DataInstance. Los elementos de este bloque se hacen coincidir con los del bloque DataInstance mediante la anotación diffgr:id.

Anotaciones de DiffGram

Los DiffGrams utilizan varias anotaciones para relacionar elementos de los distintos bloques de DiffGram que representan versiones de fila o información de error diferentes en el DataSet.

En la siguiente tabla se describen las anotaciones de DiffGram definidas en el espacio de nombres urn:schemas-microsoft-com:xml-diffgram-v1 de DiffGram.

Anotación	Descripción
id	Se utiliza para emparejar los elementos de los bloques <diffgr:before> y <diffgr:errors> con elementos del bloque <DataInstance>. Los valores que tienen la anotación diffgr:id tienen el formato [NombreTabla][IdentificadorFila]. Por ejemplo: <Customers diffgr:id="Customers1">.
parentId	Identifica qué elemento del bloque <DataInstance> es el principal del elemento actual. Los valores que tienen la anotación diffgr:parentId tienen el formato [NombreTabla][IdentificadorFila]. Por ejemplo: <Orders diffgr:parentId="Customers1">.
hasChanges	Identifica una fila del bloque <DataInstance> como modificada. La anotación hasChanges puede tener uno de los tres valores siguientes: inserted Identifica una fila agregada (Added). modified Identifica una fila modificada Modified que contiene una versión de fila Original en el bloque <diffgr:before>. Hay que tener en cuenta que las filas Deleted tendrán una versión de fila Original en el bloque <diffgr:before>, pero no habrá ningún elemento anotado en el bloque <DataInstance>. descent Identifica un elemento en el que se han modificado uno o más elementos secundarios de una relación primaria-secundaria.
hasErrors	Identifica una fila del bloque <DataInstance> como que tiene un error RowError. El elemento erróneo se sitúa en el bloque <diffgr:errors>.
Error	Contiene el texto de RowError para un elemento determinado en el bloque <diffgr:errors>.

El DataSet incluye otras anotaciones al leer o escribir su contenido como un DiffGram. En la siguiente tabla se describen estas anotaciones adicionales, que se definen en el espacio de nombres urn:schemas-microsoft-com:xml-msdata.

Anotación	Descripción
RowOrder	Conserva el orden de fila de los datos originales e identifica el índice de una fila de una DataTable determinada.
Hidden	Identifica una columna que tiene el valor MappingType.Hidden en la propiedad ColumnMapping. El atributo se escribe con el formato msdata:hidden[NombreColumna]="valor". Por ejemplo: <Customers diffgr:id="Customers1" msdata:hiddenContactTitle="Owner">. Hay que tener en cuenta que las columnas ocultas sólo se escriben como un atributo de DiffGram si contienen datos. De lo contrario, se pasan por alto.

DiffGram de ejemplo

A continuación se muestra un ejemplo del formato DiffGram. En este ejemplo se muestra el resultado de una actualización de una fila de una tabla antes de que se hayan confirmado los cambios. La fila cuyo CustomerID es "ALFKI" se ha modificado, pero no se ha actualizado. Como resultado, hay una fila Current con un valor diffgr:id de "Customers1" en el bloque <DataInstance> y una fila Original con un valor diffgr:id de "Customers1" en el bloque <diffgr:before>. La fila cuyo valor de CustomerID es "ANATR" incluye un RowError, por lo que se anota con diffgr:hasErrors="true" y hay un elemento relacionado en el bloque <diffgr:errors>.

<diffgr:diffgram xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">
  <CustomerDataSet>
    <Customers diffgr:id="Customers1" msdata:rowOrder="0" diffgr:hasChanges="modified">
      <CustomerID>ALFKI</CustomerID>
      <CompanyName>New Company</CompanyName>
    </Customers>
    <Customers diffgr:id="Customers2" msdata:rowOrder="1" diffgram:hasErrors="true">
      <CustomerID>ANATR</CustomerID>
      <CompanyName>Ana Trujillo Emparedados y Helados</CompanyName>
    </Customers>
    <Customers diffgr:id="Customers3" msdata:rowOrder="2">
      <CustomerID>ANTON</CustomerID>
      <CompanyName>Antonio Moreno Taquera</CompanyName>
    </Customers>
    <Customers diffgr:id="Customers4" msdata:rowOrder="3">
      <CustomerID>AROUT</CustomerID>
      <CompanyName>Around the Horn</CompanyName>
    </Customers>
  </CustomerDataSet>
  <diffgr:before>
    <Customers diffgr:id="Customers1" msdata:rowOrder="0">
      <CustomerID>ALFKI</CustomerID>
      <CompanyName>Alfreds Futterkiste</CompanyName>
    </Customers>
  </diffgr:before>
  <diffgr:errors>
    <Customers diffgr:id="Customers2" diffgr:Error="An optimistic concurrency violation has occurred for this row."/>
  </diffgr:errors>
</diffgr:diffgram>

Vea también

Conceptos

Cargar DataSet desde XML
Escribir un objeto DataSet como datos XML

Otros recursos

Utilizar XML en un DataSet
Utilizar DataSets en ADO.NET