WebServiceConnection.GenerateDataSetDiffGram (Método)

Para una conexión de datos que use un objeto DataSet de ADO .NET y devuelva un objeto DiffGram que identifique las diferencias entre las versiones original y actual de los elementos de datos.

Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en microsoft.office.infopath.dll)

Sintaxis

Public MustOverride Function GenerateDataSetDiffGram As XPathNavigator

Dim instance As WebServiceConnection
Dim returnValue As XPathNavigator

returnValue = instance.GenerateDataSetDiffGram

public abstract XPathNavigator GenerateDataSetDiffGram ()

Valor devuelto

Objeto XPathNavigator ubicado en la raíz de un nodo XML que contiene el objeto DiffGram para los datos devueltos por la conexión de datos.

Comentarios

Un objeto DiffGram es un formato XML que identifica las versiones original y actual de los elementos de datos. Si el origen de datos representado por el objeto WebServiceConnection devuelve un objeto DataSet de ADO.NET, una llamada al método GenerateDataSetDiffgram en la conexión generará un objeto DiffGram desde el origen de datos de la conexión que identifique las diferencias entre el conjunto original de elementos de datos del formulario y los elementos que están disponibles actualmente en la conexión de datos.

Sólo pueden tener acceso a este miembro los formularios que se ejecuten en el mismo dominio que el formulario abierto actualmente o los formularios a los que se hayan concedido permisos entre dominios.

Se puede tener acceso a este tipo o miembro desde un código ejecutado en formularios abiertos en Microsoft Office InfoPath 2007 o en un explorador Web.

Ejemplo

En el ejemplo siguiente, se llama al método GenerateDataSetDiffGram de la clase WebServiceConnection en una conexión de un servicio web que utiliza un objeto DataSet para devolver un objeto DiffGram al objeto XPathNavigator denominado DiffGramNavigator.

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

Vea también

Referencia

WebServiceConnection (Clase)
WebServiceConnection (Miembros)
Microsoft.Office.InfoPath (Espacio de nombres)