XmlForm.MainDataSource-Eigenschaft

Artikel
04/27/2010

Ruft ein DataSource-Objekt ab, welches die Hauptdatenquelle des Formulars darstellt.

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Syntax

'Declaration
Public MustOverride ReadOnly Property MainDataSource As DataSource
'Usage
Dim instance As XmlForm
Dim value As DataSource

value = instance.MainDataSource

public abstract DataSource MainDataSource { get; }

Eigenschaftswert

Ein DataSource-Objekt, das die Hauptdatenquelle des Formulars darstellt.

Hinweise

Die MainDataSource-Eigenschaft ruft einen Verweis auf ein DataSource-Objekt ab, das das dem Formular zugrunde liegende XML-Dokument darstellt. Mithilfe dieses Objekts können dann die Eigenschaften und Methoden der DataSource-Klasse abgerufen werden, um mit den Daten des dem Formular zugrunde liegenden XML-Dokuments zu arbeiten.

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 Office InfoPath 2007 oder einem Webbrowser geöffnet wurden.

Beispiel

Im folgenden Codebeispiel ruft ein Ereignishandler für das Loading-Ereignis zunächst mithilfe der MainDataSource-Eigenschaft die CreateNavigator-Methode der DataSource-Klasse auf, um eine Instanz der System.Xml.XPath.XPathNavigator-Klasse zu erstellen, die sich am Stammknoten des dem Formular zugrunde liegenden XML-Dokuments positioniert hat. Anschließend navigiert der Ereignishandler mithilfe der SelectSingleNode-Methode des XPathNavigator-Objekts zum Employee-Feld (indem Namespacepräfixe mithilfe der NamespaceManager-Eigenschaft aufgelöst werden) und legt das Feld auf den Benutzernamen des aktuellen Benutzers fest.

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

Siehe auch

Referenz

XmlForm-Klasse
XmlForm-Member
Microsoft.Office.InfoPath-Namespace

Freigeben über