XmlForm.MainDataSource (Propiedad)

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
'Uso
Dim instance As XmlForm
Dim value As DataSource

value = instance.MainDataSource

public abstract DataSource MainDataSource { get; }

Valor de propiedad

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.

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 siguiente ejemplo de código, un controlador de eventos para el controlador Loading utiliza 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

Vea también

Referencia

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