XmlForm Klasse

Definition

public ref class XmlForm abstract

public abstract class XmlForm

type XmlForm = class

Public MustInherit Class XmlForm

Vererbung

Object

XmlForm

Hinweise

Die XmlForm -Klasse ist ein Schlüsselobjekt im InfoPath-Objektmodell mit verwaltetem Code, das Eigenschaften, Methoden und Ereignisse bereitstellt, die für die programmgesteuerte Interaktion und Bearbeitung der XML-Daten im zugrunde liegenden XML-Dokument eines Formulars verwendet werden können.

Während XmlForm der Zugriff auf Objekte über die XmlFormCollection -Klasse mithilfe der XmlForms -Eigenschaft der Application -Klasse möglich ist, greifen Sie in den meisten Fällen beim Arbeiten mit der Geschäftslogik von Formularvorlagen auf die XmlForm Klasse und ihre Member zu, indem Sie die Schlüsselwörter this (in C#) oder Me (in Visual Basic) verwenden, ohne die Auflistung zu durchlaufen.

Beispielsweise verwenden die folgenden Codebeispiele von Ereignishandlern für das Loading Ereignis die Schlüsselwörter this oder Me , um auf die MainDataSource Eigenschaften und NamespaceManager der XmlForm -Klasse zuzugreifen. Diese Eigenschaften werden verwendet, um mit einer instance desSystem.Xml zu arbeiten . XPath.XPathNavigator-Mitarbeiterfeld (Auflösen von Namespacepräfixen mithilfe der NamespaceManager -Eigenschaft), und legen Sie dann 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

Hinweis: Es ist nicht erforderlich, explizit auf die Schlüsselwörter this oder Me zu verweisen, um im Formularcode auf die Member der XmlForm -Klasse zuzugreifen. Die Codezeilen für den Zugriff auf die Eigenschaft in den MainDataSource vorherigen C#- und Visual Basic-Beispielen können beispielsweise wie folgt geschrieben werden:

XPathNavigator myNav = MainDataSource.CreateNavigator()
Dim myNav As XPathNavigator = MainDataSource.CreateNavigator()

Die Verwendung der Schlüsselwörter this oder Me beim Schreiben von Code erleichtert jedoch die Vervollständigung von IntelliSense-Anweisungen, die die Member der XmlForm Klasse beim Schreiben von Geschäftslogikcode im FormCode-Modul einer Formularvorlage auflistet.

Beim Arbeiten mit verwaltetem Code wird auf die XML-Quelldaten eines Formulars über die MainDataSource -Eigenschaft zugegriffen, die eine instance der DataSource Klasse zurückgibt, die die Standard Datenquelle des Formulars darstellt. Die CreateNavigator() -Methode der DataSource -Klasse wird dann verwendet, um eine instance desSystem.Xml zu erstellen . XPath.XPathNavigator-Klasse, die im Stammverzeichnis des dem Formular zugrunde liegenden XML-Dokuments positioniert ist. Die Member der XPathNavigator-Klasse können anschließend verwendet werden, um zu den Formulardaten zu navigieren und diese zu lesen und in sie zu schreiben. Weitere Informationen zur Verwendung der XPathNavigator-Klasse in InfoPath-Formularcode finden Sie unter Vorgehensweise: Arbeiten mit System.Xml aus Formularvorlagen mit verwaltetem Code.

Die XmlForm -Klasse stellt auch zusätzliche Eigenschaften bereit, mit denen Informationen zum Formular und dem zugrunde liegenden XML-Dokument abgerufen werden können. Sie stellt außerdem Methoden zum Ausführen verschiedener Formularaktionen bereit, z. B. Drucken, Speichern oder Absenden. Ereignisse auf Formularebene, z. B. das Laden eines Formulars, das Wechseln von Ansichten oder ein Zusammenführungsvorgang, werden von der FormEvents -Klasse implementiert. Darüber hinaus werden Ereignisse, die durch Änderungen am zugrunde liegenden XML-Dokument selbst ausgelöst werden, von der XmlEvents -Klasse implementiert.

Auf XmlForm das Objekt kann über die XmlFormCollection Klassen und Window im InfoPath-Objektmodell zugegriffen werden. In der folgenden Tabelle sind diese Speicherorte aufgeführt, an denen das XmlForm Objekt verfügbar ist.

Im InfoPath 2003-kompatiblen Objektmodell mit verwaltetem Code (die Typen und Member des Microsoft.Office.Interop.InfoPath.SemiTrust Namespace), das erstmals in InfoPath 2003 Service Pack 1 in Verbindung mit dem Microsoft Office InfoPath 2003 Toolkit für Visual Studio .NET eingeführt wurde, stellten die folgenden Klassen eine XDocument-Eigenschaft für den Zugriff auf das zugrunde liegende XML-Dokument eines Formulars während ereignissen bereit: DataDOMEventObject-DocActionEventObject, -, DocEventObjectDocReturnEventObject-, - und VersionUpgradeEventObject -Klassen.

Im neuen InfoPath-Objektmodell mit verwaltetem Code (die Typen und Member des Microsoft.Office.InfoPath Namespace) verwenden Sie die Schlüsselwörter this (in C#) oder Me (in Visual Basic), um über Ereignishandler und anderen Code in Ihrer Formularvorlagen-Geschäftslogik auf die XmlForm Klasse und ihre Member zuzugreifen.

Konstruktoren

Eigenschaften

Methoden

Gilt für: