de la propiedad XmlForm.MainDataSource
Obtiene un objeto DataSource que representa el origen de datos principal del formulario.
Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en Microsoft.Office.InfoPath.dll)
Sintaxis
'Declaración
Public MustOverride ReadOnly Property MainDataSource As DataSource
Get
'Uso
Dim instance As XmlForm
Dim value As DataSource
value = instance.MainDataSource
public abstract DataSource MainDataSource { get; }
Valor de propiedad
Tipo: Microsoft.Office.InfoPath.DataSource
Objeto DataSource que representa el origen de datos principal del formulario.
Comentarios
La propiedad MainDataSource obtiene una referencia a un objeto DataSource que representa el documento XML subyacente del formulario. A continuación, este objeto se puede usar para tener acceso a las propiedades y métodos de la clase DataSource para trabajar con los datos del documento XML subyacente del formulario.
Únicamente se puede acceder a este miembro con formularios que se ejecuten en el mismo dominio que el formulario que está actualmente abierto o con formularios a los que se hayan concedido permisos entre dominios.
Se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler o en un explorador web.
Ejemplos
En el siguiente ejemplo de código, un controlador de eventos para el evento Loading usa primero la propiedad MainDataSource para llamar al método CreateNavigator de la clase DataSource para crear una instancia de la clase System.Xml.XPath.XPathNavigator situada en el nodo raíz del documento XML subyacente del formulario. A continuación, utiliza el método SelectSingleNode del objeto XPathNavigator para desplazarse al campo employee (resolución de prefijos de espacio de nombres mediante la propiedad NamespaceManager) y establecer el valor del campo en el nombre del usuario actual.
public void FormEvents_Loading(object sender, LoadingEventArgs e)
{
// Create XPathNavigator positioned at the root of the main data
// source.
XPathNavigator myNav = this.MainDataSource.CreateNavigator()
// Select employee field and set value to username.
myNav.SelectSingleNode("//my:employee",this.NamespaceManager).
SetValue(System.Environment.UserName);
}
Public Sub FormEvents_Loading(ByVal sender As Object, ByVal e As LoadingEventArgs)
' Create XPathNavigator positioned at the root of the main data
' source.
Dim myNav As XPathNavigator = Me.MainDataSource.CreateNavigator()
' Select employee field and set value to username.
myNav.SelectSingleNode("//my:employee", Me.NamespaceManager). _
SetValue(System.Environment.UserName)
End Sub