DiffGrams

Ein DiffGram ist ein XML-Format, das aktuelle und ursprüngliche Versionen von Datenelementen angibt. DataSet verwendet das DiffGram-Format, um seinen Inhalt zu laden und beizubehalten und um seinen Inhalt für die Übertragung über eine Netzwerkverbindung zu serialisieren. Wenn ein DataSet als DiffGram geschrieben wird, füllt es das DiffGram mit allen erforderlichen Informationen auf, um den Inhalt, jedoch nicht das Schema, des DataSet einschließlich der Spaltenwerte aus den Original- und Current-Zeilenversionen, der Zeilenfehlerinformationen und der Zeilenreihenfolge korrekt neu zu erstellen.

Beim Senden und Abrufen eines DataSet über einen XML-Webdienst wird das DiffGram-Format implizit verwendet. Darüber hinaus können Sie beim Laden des Inhalts eines DataSet aus XML mit der Methode ReadXml oder beim Schreiben des Inhalts eines DataSet in XML mit der Methode WriteXml angeben, dass der Inhalt als DiffGram gelesen oder geschrieben werden soll. Weitere Informationen finden Sie unter Laden eines Datasets aus XML und Schreiben von DataSet-Inhalten als XML-Daten.

Während das DiffGram-Format von .NET Framework primär als Serialisierungsformat für den Inhalt eines DataSet verwendet wird, können Sie mithilfe von DiffGrams auch Daten in Tabellen einer Microsoft SQL Server-Datenbank ändern.

Ein Diffgram wird generiert, indem der Inhalt aller Tabellen in ein <diffgram> Element geschrieben wird.

So generieren Sie ein Diffgram

Generieren Sie eine Liste von Stammtabellen (also Tabellen ohne irgendein übergeordnetes Element).
Geben Sie im ersten Diffgram-Abschnitt für jede Tabelle und ihre untergeordneten Tabellen in der Liste die aktuelle Version der einzelnen Zeilen an.
Schreiben Sie für jede Tabelle im DataSet die originale Version aller Zeilen, falls vorhanden, im Abschnitt <before> des Diffgram aus.
Schreiben Sie für Zeilen mit Fehlern den Fehlerinhalt im <errors> Abschnitt des Diffgrams.

Ein Diffgram wird vom Anfang der XML-Datei bis zu deren Ende verarbeitet.

So verarbeiten Sie ein Diffgram

Verarbeiten Sie den ersten Abschnitt des Diffgram, der die aktuelle Version der Zeilen enthält.
Verarbeiten Sie den zweiten Abschnitt oder den Abschnitt, der <before> die ursprüngliche Zeilenversion geänderter und gelöschter Zeilen enthält.

Hinweis

Wenn eine Zeile als gelöscht gekennzeichnet ist, kann je nach der Cascade-Eigenschaft des aktuellen DataSet der Löschvorgang auch die untergeordneten Zeilen der Zeile löschen.
Verarbeiten sie den <errors> Abschnitt. Legen Sie in diesem Abschnitt die Fehlerinformationen für die angegebene Zeile und Spalte für jedes Element fest.

Hinweis

Wenn Sie für XmlWriteMode "Diffgram" festlegen, kann es passieren, dass sich der Inhalt des Ziel-DataSet und des Original-DataSet voneinander unterscheiden.

DiffGram-Format

Das DiffGram-Format ist in drei Abschnitte unterteilt: die aktuellen Daten, die ursprünglichen (oder "vorher") Daten und ein Fehlerabschnitt, wie im folgenden Beispiel dargestellt.

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

Das DiffGram-Format umfasst die folgenden Datenblöcke:

< DataInstance> Der Name dieses Elements, DataInstance, wird zu Erklärungszwecken in dieser Dokumentation verwendet. Ein DataInstance-Element stellt ein DataSet oder eine Zeile in einer DataTable dar. Anstelle von DataInstance enthält das Element den Namen des jeweiligen DataSet oder der DataTable entsprechenden. Dieser Block des DiffGram-Formats enthält die aktuellen Daten, wobei es keine Rolle spielt, ob diese ggf. geändert wurden. Ein Element oder eine Zeile, das bzw. die geändert wurde, wird mit der diffgr:hasChanges-Anmerkung angegeben.

<diffgr:before> Dieser Block des DiffGram-Formats enthält die Originalversion einer Zeile. Elemente in diesem Block werden mit Elementen im DataInstance-Block über die diffgr:id-Anmerkung verglichen.

<diffgr:errors> Dieser Block des DiffGram-Formats enthält Fehlerinformationen für eine bestimmte Zeile im DataInstance-Block . Elemente in diesem Block werden mit Elementen im DataInstance-Block über die diffgr:id-Anmerkung verglichen.

DiffGram-Anmerkungen

In DiffGrams wird eine Reihe von Anmerkungen verwendet, um auf Elemente aus den verschiedenen DiffGram-Blöcken Bezug zu nehmen, die unterschiedliche Zeilenversionen oder Fehlerinformationen im DataSet darstellen.

In der folgenden Tabelle werden die DiffGram-Anmerkungen beschrieben, die im DiffGram-Namespace urn:schemas-microsoft-com:xml-diffgram-v1 definiert sind.

Anmerkung	BESCHREIBUNG
`id`	Wird verwendet, um die Elemente in den `<diffgr:before>` und `<diffgr:errors>` Blöcken mit den Elementen im <DataInstance> Block zu koppeln. Werte mit der diffgr:id-Anmerkung haben das Format `[TableName][RowIdentifier]`. Beispiel: `<Customers diffgr:id="Customers1">`.
`parentId`	Gibt an, welches Element aus dem <DataInstance>-Block das übergeordnete Element des aktuellen Elements ist. Werte mit der diffgr:parentId-Anmerkung haben das Format `[TableName][RowIdentifier]`. Beispiel: `<Orders diffgr:parentId="Customers1">`.
`hasChanges`	Weist eine Zeile im <DataInstance>-Block als geändert aus. Die `hasChanges` Anmerkung kann einen der folgenden beiden Werte aufweisen: eingefügt Identifiziert eine `Added` Zeile. geändert Identifiziert eine `Modified` Zeile, die eine `Original` Zeilenversion im `<diffgr:before>` Block enthält. Beachten Sie, dass `Deleted` Zeilen eine `Original` Zeilenversion im `<diffgr:before>` Block aufweisen, aber es gibt kein kommentiertes Element im <DataInstance-Block> .
`hasErrors`	Gibt eine Zeile im <DataInstance>-Block mit einem RowError an. Das Fehlerelement wird im `<diffgr:errors>` Block platziert.
`Error`	Enthält den Text des `RowError` Elements für ein bestimmtes Element im `<diffgr:errors>` Block.

Das DataSet enthält weitere Anmerkungen, wenn sein Inhalt als DiffGram gelesen oder geschrieben wird. In der folgenden Tabelle werden diese zusätzlichen Anmerkungen beschrieben. Diese sind im Namespace urn:schemas-microsoft-com:xml-msdata definiert.

Anmerkung BESCHREIBUNG

RowOrder Behält die Zeilenreihenfolge der ursprünglichen Daten bei und gibt den Index einer Zeile in einer bestimmten DataTable an.

Versteckt Identifiziert eine Spalte so, dass eine ColumnMapping Eigenschaft auf "MappingType.Hidden" festgelegt ist. Das Attribut ist im Format msdata:hidden[Spaltenname]="Wert" geschrieben. Beispiel: <Customers diffgr:id="Customers1" msdata:hiddenContactTitle="Owner">.

Beachten Sie, dass ausgeblendete Spalten nur als DiffGram-Attribut geschrieben werden, wenn sie Daten enthalten. Andernfalls wird der Parameter ignoriert.

Anmerkung	BESCHREIBUNG
RowOrder	Behält die Zeilenreihenfolge der ursprünglichen Daten bei und gibt den Index einer Zeile in einer bestimmten DataTable an.
Versteckt	Identifiziert eine Spalte so, dass eine `ColumnMapping` Eigenschaft auf "MappingType.Hidden" festgelegt ist. Das Attribut ist im Format msdata:hidden[Spaltenname]="Wert" geschrieben. Beispiel: `<Customers diffgr:id="Customers1" msdata:hiddenContactTitle="Owner">`. Beachten Sie, dass ausgeblendete Spalten nur als DiffGram-Attribut geschrieben werden, wenn sie Daten enthalten. Andernfalls wird der Parameter ignoriert.

Beispiel für ein DiffGram

Unten ist ein Beispiel für das DiffGram-Format aufgeführt. In diesem Beispiel wird das Ergebnis des Updates einer Tabellenzeile veranschaulicht, bevor ein Commit der Änderungen ausgeführt wird. Die Zeile mit der CustomerID "ALFKI" wurde geändert, jedoch nicht aktualisiert. Daher gibt es eine Current Zeile mit einer diffgr:id von "Customers1" im <DataInstance-Block> und eine Original Zeile mit einer diffgr:id von "Customers1" im <diffgr:before> Block. Die Zeile mit der CustomerID "ANATR" enthält einen RowError, sodass sie mit diffgr:hasErrors="true" annotiert wird und ein diesbezügliches Element im <diffgr:errors> Block vorhanden ist.

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

Siehe auch

Last updated on 2025-12-02

Freigeben über