XmlForm.MainDataSource-Eigenschaft
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
Get
'Usage
Dim instance As XmlForm
Dim value As DataSource
value = instance.MainDataSource
public abstract DataSource MainDataSource { get; }
Eigenschaftswert
Typ: Microsoft.Office.InfoPath.DataSource
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 dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.
Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in einem Webbrowser geöffnet wurden.
Beispiele
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 am Stammknoten des dem Formular zugrunde liegenden XML-Dokuments positioniert ist. Anschließend navigiert der Ereignishandler mithilfe der SelectSingleNode-Methode des XPathNavigator-Objekts zum Employee-Feld (wobei 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