XmlForm Classe

Definição

public ref class XmlForm abstract

public abstract class XmlForm

type XmlForm = class

Public MustInherit Class XmlForm

Herança

Object

XmlForm

Comentários

A XmlForm classe é um objeto-chave no modelo de objeto de código gerenciado do InfoPath que fornece propriedades, métodos e eventos que podem ser usados para interagir programaticamente e manipular os dados XML no documento XML subjacente de um formulário.

Embora XmlForm os objetos possam ser acessados da XmlFormCollection classe usando a XmlForms propriedade da classe, na maioria dos Application casos, ao trabalhar com a lógica de negócios do modelo de formulário, você acessará a XmlForm classe e seus membros usando as palavras-chave ( em C#) ou Eu (no Visual Basic) sem passar pela coleção.

Por exemplo, os exemplos de código a seguir de manipuladores de eventos para o Loading evento usam as palavras-chave this ou Me para acessar as MainDataSource propriedades e NamespaceManager da XmlForm classe. Essas propriedades são usadas para funcionar com uma instância do System.Xml. Campo de funcionários XPath.XPathNavigator (resolvendo prefixos de namespace usando a NamespaceManager propriedade) e, em seguida, defina o campo como nome de usuário do usuário atual.

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

Observação: não é necessário referenciar explicitamente as palavras-chave this ou Me para acessar os membros da XmlForm classe no código de formulário. Por exemplo, as linhas de código para acessar a MainDataSource propriedade nos exemplos anteriores do C# e do Visual Basic podem ser escritas da seguinte maneira:

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

No entanto, usar as palavras-chave this ou Me ao escrever código facilita a conclusão da instrução IntelliSense, que lista os membros da classe ao escrever código XmlForm lógico de negócios no módulo FormCode de um modelo de formulário.

Ao trabalhar com código gerenciado, os dados XML de origem de um formulário são acessados por meio da MainDataSource propriedade que retorna uma instância da DataSource classe que representa o main fonte de dados do formulário. O CreateNavigator() método da DataSource classe é então usado para criar uma instância do System.Xml. Classe XPath.XPathNavigator que está posicionada na raiz do documento XML subjacente do formulário. Os membros da classe XPathNavigator podem então ser usados para navegar, ler e gravar nos dados do formulário. Para obter mais informações sobre como usar a classe XPathNavigator no código de formulário do InfoPath, consulte Como trabalhar com System.Xml de Modelos de Formulário de Código Gerenciado.

A XmlForm classe também fornece propriedades adicionais que podem ser usadas para obter informações sobre o formulário e seu documento XML subjacente. Ele também fornece métodos que podem ser usados para executar várias ações com o formulário, como impressão, salvamento e envio. Eventos no nível do formulário, como carregar um formulário, alternar exibições ou uma operação de mesclagem, são implementados pela FormEvents classe. Além disso, os eventos gerados por alterações no documento XML subjacente em si são implementados pela XmlEvents classe.

O XmlForm objeto pode ser acessado das XmlFormCollection classes e Window no modelo de objeto InfoPath. A tabela a seguir lista esses locais em que o XmlForm objeto está disponível.

No modelo de objeto de código gerenciado compatível com o InfoPath 2003 (os tipos e membros do Microsoft.Office.Interop.InfoPath.SemiTrust namespace), que foi introduzido pela primeira vez no InfoPath 2003 Service Pack 1 em conjunto com o Kit de Ferramentas do Microsoft Office InfoPath 2003 para Visual Studio .NET, as seguintes classes forneceram uma propriedade XDocument para acessar o documento XML subjacente de um formulário durante os eventos: DataDOMEventObject, DocActionEventObject, DocEventObject, DocReturnEventObjecte VersionUpgradeEventObject classes.

No novo modelo de objeto de código gerenciado do InfoPath (os tipos e membros do Microsoft.Office.InfoPath namespace), você usa as palavras-chave isso (em C#) ou Eu (no Visual Basic) para acessar a XmlForm classe e seus membros de manipuladores de eventos e de outros códigos na lógica de negócios do modelo de formulário.

Construtores

Propriedades

Métodos

Aplica-se a