DiffGrams

Um DiffGram é um formato XML que identifica versões atuais e originais de elementos de dados. O DataSet usa o formato DiffGram para carregar e persistir seu conteúdo e serializar seu conteúdo para transporte através de uma conexão de rede. Quando a DataSet é escrita como um DiffGram, preenche o DiffGram com toda a informação necessária para recriar com precisão o conteúdo, exceto pelo esquema, do DataSet, incluindo valores de coluna das versões de linha de Original e Current, informações de erro de linha e ordem das mesmas.

Ao enviar e recuperar um DataSet de um XML Web Service, o formato DiffGram é usado implicitamente. Adicionalmente, ao carregar o conteúdo de um DataSet a partir de XML usando o método ReadXml, ou ao escrever o conteúdo de um DataSet em XML utilizando o método WriteXml, pode especificar que o conteúdo seja lido ou escrito como um DiffGram. Para obter mais informações, consulte Carregando um DataSet de XML e Gravando Conteúdo de DataSet como Dados XML.

Embora o formato DiffGram seja usado principalmente pelo .NET Framework como um formato de serialização para o conteúdo de um DataSet, você também pode usar DiffGrams para modificar dados em tabelas em um banco de dados do Microsoft SQL Server.

Um Diffgram é gerado escrevendo o conteúdo de todas as tabelas num <diffgram> elemento.

Para gerar um Diffgram

1. Gere uma lista de tabelas raiz (ou seja, tabelas sem nenhum pai).

2. Para cada tabela e seus descendentes na lista, escreva a versão atual de todas as linhas na primeira seção Diffgram.

3. Para cada tabela no DataSet, escreva na secção <before> do Diffgram a versão original de todas as linhas, se existirem.

4. Para linhas com erros, escreva o conteúdo do erro na <errors> secção do Diffgram.

Um Diffgram é processado em ordem desde o início do arquivo XML até o final.

Para processar um Diffgram

1. Processe a primeira seção do Diffgram que contém a versão atual das linhas.

2. Processe a segunda ou a <before> secção que contém a versão original das linhas modificadas e eliminadas.

   Nota

   Se uma linha for marcada como excluída, a operação de exclusão também poderá excluir os descendentes da linha, dependendo da Cascade propriedade do atual DataSet.

3. Processa a <errors> secção. Defina as informações de erro para a linha e coluna especificadas para cada item nesta seção.

Formato DiffGram

O formato DiffGram é dividido em três seções: os dados atuais, os dados originais (ou "antes") e uma seção de erros, conforme mostrado no exemplo a seguir.

<?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>

O formato DiffGram consiste nos seguintes blocos de dados:

< DataInstance> O nome deste elemento, DataInstance, é usado para fins explicativos nesta documentação. Um elemento DataInstance representa uma DataSet ou uma linha de um DataTablearquivo . Em vez de DataInstance, o elemento conteria o nome do DataSet ou DataTable. Este bloco do formato DiffGram contém os dados atuais, quer tenham sido modificados ou não. Um elemento, ou linha, que foi modificado é identificado com a anotação diffgr:hasChanges .

<diffgr:before> Este bloco do formato DiffGram contém a versão original de uma linha. Os elementos neste bloco são correspondidos aos elementos no bloco DataInstance usando a anotação diffgr:id .

<diffgr:errors> Este bloco do formato DiffGram contém informação de erro para uma determinada linha no bloco DataInstance . Os elementos neste bloco são correspondidos aos elementos no bloco DataInstance usando a anotação diffgr:id .

Anotações DiffGram

Os DiffGrams usam várias anotações para relacionar elementos dos diferentes blocos DiffGram que representam diferentes versões de linha ou informações de erro no DataSet.

A tabela a seguir descreve as anotações DiffGram definidas no namespace DiffGram urn:schemas-microsoft-com:xml-diffgram-v1.

O DataSet inclui anotações adicionais ao ler ou escrever seu conteúdo como um DiffGram. A tabela a seguir descreve essas anotações adicionais, que são definidas no namespace urn:schemas-microsoft-com:xml-msdata.

Exemplo de DiffGram

Um exemplo do formato DiffGram é mostrado abaixo. Este exemplo mostra o resultado de uma atualização de uma linha em uma tabela antes que as alterações tenham sido confirmadas. A linha com um CustomerID de "ALFKI" foi modificada, mas não atualizada. Como resultado, há uma Current linha com um diffgr:id de "Customers1" no bloco <DataInstance>, e uma Original linha com um diffgr:id de "Customers1" no bloco <diffgr:before>. A linha com um CustomerID com "ANATR" inclui um RowError, por isso é anotada com diffgr:hasErrors="true" e existe um elemento relacionado no bloco <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>

Consulte também

• Usando XML em um DataSet
• Carregando um DataSet a partir de XML
• Gravando conteúdo do conjunto de dados como dados XML
• DataSets, DataTables e DataViews
• Visão geral ADO.NET