WebServiceConnection.GenerateDataSetDiffGram 方法

定义

命名空间:

Microsoft.Office.InfoPath

程序集:

Microsoft.Office.InfoPath.dll

适用于使用 ADO .NET DataSet 并返回 DiffGram（标识数据元素的原始版本和当前版本之间的任何差异）的数据连接。

public:
 abstract System::Xml::XPath::XPathNavigator ^ GenerateDataSetDiffGram();

public abstract System.Xml.XPath.XPathNavigator GenerateDataSetDiffGram ();

abstract member GenerateDataSetDiffGram : unit -> System.Xml.XPath.XPathNavigator

Public MustOverride Function GenerateDataSetDiffGram () As XPathNavigator

返回

XPathNavigator

一个位于根 XML 节点处的 XPathNavigator，它包含数据连接所返回数据的 DiffGram。

示例

在以下示例中，类的 WebServiceConnectionGenerateDataSetDiffGram 方法在 Web 服务连接上调用，该连接使用 DataSet 将 DiffGram 返回到名为 DiffGramNavigator 的 XPathNavigator 对象。

// 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()

注解

DiffGram 是一种标识数据元素当前版本和原始版本的 XML 格式。 如果 WebServiceConnection 对象代表的数据源返回 ADO.NET DataSet，那么，通过在连接上调用 GenerateDataSetDiffgram 方法，将会依据连接的数据源生成一个 DiffGram，它标识表单中的原始数据元素集和数据连接中当前提供的数据元素集之间的任何差异。

此成员只能由与当前打开的表单在相同域中运行的表单访问，或者由已授予跨域权限的表单访问。

可以通过 Microsoft InfoPath Filler 或 Web 浏览器内打开的表单中运行的代码访问此类型或成员。