WebServiceConnection.GenerateDataSetDiffGram-Methode
Für eine Datenverbindung, die ein ADO .NET-DataSet-Objekt verwendet und ein DiffGram-Objekt zurückgibt, das alle Unterschiede zwischen der ursprünglichen und der aktuellen Version von Datenelementen identifiziert.
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustOverride Function GenerateDataSetDiffGram As XPathNavigator
'Usage
Dim instance As WebServiceConnection
Dim returnValue As XPathNavigator
returnValue = instance.GenerateDataSetDiffGram()
public abstract XPathNavigator GenerateDataSetDiffGram()
Rückgabewert
Typ: System.Xml.XPath.XPathNavigator
Ein am Stamm eines XML-Knotens positioniertes XPathNavigator-Objekt, das das DiffGram-Objekt für die von der Datenverbindung zurückgegebenen Daten enthält.
Hinweise
DiffGram ist ein XML-Format, das die aktuelle und die ursprüngliche Version von Datenelementen identifiziert. Wenn die durch das WebServiceConnection-Objekt dargestellte Datenquelle ein ADO.NET-DataSet-Objekt zurückgibt, wird durch das Aufrufen der GenerateDataSetDiffgram-Methode für die Verbindung ein DiffGram-Objekt von der Datenquelle der Verbindung generiert, das alle Unterschiede zwischen dem ursprünglichen Satz von Datenelementen im Formular und den zurzeit über die Datenverbindung verfügbaren Datenelementen identifiziert.
Auf den Member kann nur über Formulare zugegriffen werden, die in derselben Domäne wie das zurzeit geöffnete Formular ausgeführt werden, oder über Formulare, denen domänenübergreifende Berechtigungen erteilt wurden.
Auf diesen Typ oder diesen Member kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft InfoPath Filler oder einem Webbrowser geöffnet wurden.
Beispiele
Im folgenden Beispiel wird die GenerateDataSetDiffGram-Methode der WebServiceConnection-Klasse für eine Webdienstverbindung aufgerufen, die ein DataSet-Objekt zum Zurückgeben eines DiffGram-Objekts an das XPathNavigator-Objekt namens DiffGramNavigator verwendet.
// Open connection.
WebServiceConnection wsc =
(WebServiceConnection)this.DataConnections["Main query"];
// Generate DiffGram.
XPathNavigator DiffGramNavigator = wsc.GenerateDataSetDiffgram();
' Open connection.
Dim wsc As WebServiceConnection =
DirectCast(Me.DataConnections("Main query"), WebServiceConnection)
' Generate DiffGram.
Dim DiffGramNavigator As XPathNavigator = _
wsc.GenerateDataSetDiffgram()