XDocument Interface

Definição

Namespace:

Microsoft.Office.Interop.InfoPath.SemiTrust

Assembly:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

Representa o documento XML subjacente de um formulário.

public interface class XDocument : Microsoft::Office::Interop::InfoPath::SemiTrust::_XDocument2

[System.Runtime.InteropServices.Guid("096cd6a8-0786-11d1-95fa-0080c78ee3bb")]
public interface XDocument : Microsoft.Office.Interop.InfoPath.SemiTrust._XDocument2

type XDocument = interface
    interface _XDocument2
    interface _XDocument

Public Interface XDocument
Implements _XDocument2

Atributos

GuidAttribute

Implementações

_XDocument2

Exemplos

Os dados XML de origem de um formulário assumem a forma de um DOM (Modelo de Objeto de Documento XML), que é acessado por meio da DOM propriedade do objeto XDocument . O objeto XDocument também fornece uma série de propriedades que podem ser usadas para obter informações sobre o formulário e seu documento XML subjacente. Por exemplo, o código a seguir verifica se os dados no formulário foram alterados usando a IsDirty propriedade:

if (thisXDocument.IsDirty)
{
   thisXDocument.UI.Alert("Form has been changed.");
}
else
{
   thisXDocument.UI.Alert("Form has not been changed.");
}

Além das informações sobre o formulário e seu documento XML subjacente, o objeto XDocument fornece uma série de métodos que podem ser usados no formulário, como impressão, salvamento e envio. Ele também fornece uma série de eventos que podem ser usados para responder a várias ações que ocorrem no nível do formulário, como carregar um formulário, alternar exibições ou uma operação de mesclagem.

Para outro exemplo que demonstra o trabalho com o objeto XDocument , consulte

Como acessar dados do aplicativo (modelo de objeto InfoPath 2003).

Comentários

This type is a wrapper for a coclass that is required by managed code for COM interoperability. Use this type to access the members of the COM interface implemented by this coclass. Para obter informações sobre a interface COM, incluindo um link para descrições de seus membros, consulte_XDocument2.

O uso dos membros da interface _XDocument2 fornece compatibilidade com o InfoPath 2003. Para usar novos membros que foram adicionados ao modelo de objeto XDocument em Microsoft InfoPath 2010 como a Permission propriedade, você deve lançar o objeto XDocument para o _XDocument3 tipo. Para obter mais informações, consulte Como usar membros do modelo de objeto que não são compatíveis com o InfoPath 2003.

O objeto XDocument é um objeto-chave no modelo de objeto InfoPath que fornece propriedades, métodos e eventos que podem ser usados para interagir programaticamente e manipular os dados XML de origem de um formulário.

Embora o objeto XDocument possa ser acessado usando a XDocumentsCollection coleção, na maioria dos casos você o acessará a partir desta variávelXDocument que é instanciada no método _Startup de um projeto de código gerenciado sem passar pela coleção.

Os dados XML de origem de um formulário assumem a forma de um DOM (Modelo de Objeto de Documento XML), que é acessado por meio da DOM propriedade. O objeto XDocument também fornece uma série de propriedades que podem ser usadas para obter informações sobre o formulário e seu documento XML subjacente. Ele também fornece uma série de métodos que podem ser usados no formulário, como impressão, salvamento e envio. O objeto XDocument também fornece uma série de eventos que podem ser usados para responder a várias ações que ocorrem no nível do formulário, como carregar um formulário, alternar exibições ou uma operação de mesclagem.

Acessando o objeto XDocument

O objeto XDocument pode ser acessado em vários lugares dentro do modelo de objeto InfoPath. A tabela a seguir resume os locais em que o objeto XDocument está disponível.

XDocumentsCollection	Acessado de Application. Fornece Item[Object] para acessar os objetos XDocument que ele contém.
DataDOMEventObject	Fornece XDocument para acessar os dados XML de origem durante uma alteração do DOM XML.
DocActionEventObject	Fornece XDocument para acessar os dados XML de origem durante um clique de botão na área do formulário.
DocEventObject	Fornece XDocument para acessar os dados XML de origem durante uma operação de mesclagem de formulário ou exibição de comutador.
DocReturnEventObject	Fornece XDocument para acessar o XML de origem durante o carregamento ou envio de um formulário.
VersionUpgradeEventObject	Fornece XDocument para acessar o XML de origem durante a operação de atualização de versão.
WindowObject	Fornece XDocument para acessar o objeto XDocument associado à janela.

Propriedades

DataAdapters	Obtém uma referência à DataAdaptersCollection coleção associada a um formulário. (Herdado de _XDocument2)
DataObjects	Obtém uma referência à DataObjectsCollection coleção associada a um formulário. (Herdado de _XDocument2)
DOM	Obtém uma referência ao documento XML subjacente de um formulário na forma de um DOM (Modelo de Objeto de Documento XML). (Herdado de _XDocument2)
Errors	Obtém uma referência ao ErrorsCollection que está associado a um formulário. (Herdado de _XDocument2)
Extension	Obtém uma referência ao objeto de script global, que expõe as funções e variáveis globais contidas no arquivo de código de formulário primário de um formulário. (Herdado de _XDocument2)
IsDirty	Obtém um valor que indica se os dados em um formulário foram modificados desde que foram salvos pela última vez. (Herdado de _XDocument2)
IsDOMReadOnly	Obtém um valor que indica se os dados no documento XML subjacente de um formulário foram colocados em um estado somente leitura. (Herdado de _XDocument2)
IsNew	Obtém um valor que indica se um formulário recém-criado foi salvo. (Herdado de _XDocument2)
IsReadOnly	Obtém um valor que indica se um formulário está no modo somente leitura. (Herdado de _XDocument2)
IsRecovered	Obtém um valor que indica se um formulário foi salvo pela última vez por uma operação de salvamento de AutoRecuperação. (Herdado de _XDocument2)
IsSigned	Obtém um valor que indica se um formulário foi assinado digitalmente usando assinaturas digitais. (Herdado de _XDocument2)
Language	Obtém ou define o código de idioma padrão de um formulário. (Herdado de _XDocument2)
QueryAdapter	Obtém uma referência ao objeto adaptador de dados associado a um formulário. (Herdado de _XDocument2)
Role	Obtém ou define a função atual do usuário. (Herdado de _XDocument2)
SignedDataBlocks	Obtém uma referência à SignedDataBlocksCollection coleção associada a um XDocument objeto. (Herdado de _XDocument2)
Solution	Obtém uma referência ao objeto associado a SolutionObject um formulário. (Herdado de _XDocument2)
UI	Retorna uma referência ao UIObject objeto. (Herdado de _XDocument2)
URI	Obtém o URI (Uniform Resource Identifier) de um formulário. (Herdado de _XDocument2)
Util	Obtém uma referência ao UtilObject objeto. (Herdado de _XDocument2)
View	Obtém uma referência ao associado a ViewObject um formulário. (Herdado de _XDocument2)
ViewInfos	Obtém uma referência à coleção associada a ViewInfosCollection um formulário. (Herdado de _XDocument2)

Métodos

CreateDOM()	Cria uma nova instância do DOM (Modelo de Objeto de Documento XML) na memória. (Herdado de _XDocument2)
GetDataVariable(Int32)	Obtém o valor da variável especificada, que é uma variável predefinida armazenada como um atributo de instrução de processamento no documento XML subjacente do formulário. (Herdado de _XDocument2)
GetDOM(String)	Obtém uma referência ao DOM (Modelo de Objeto de Documento XML) do objeto especificado DataSourceObject associado ao XDocument objeto. (Herdado de _XDocument2)
GetNamedNodeProperty(Object, String, String)	Obtém o valor de uma propriedade nomeada para o nó XML especificado, que deve ser um nó nonattribute na fonte de dados main. (Herdado de _XDocument2)
ImportDOM(IXMLDOMDocument)	Importa os dados XML especificados para o formulário atual. (Herdado de _XDocument2)
ImportFile(String)	Importa o formulário especificado para o formulário atual. (Herdado de _XDocument2)
PrintOut()	Imprime o conteúdo do formulário à medida que é renderizado na janela correspondente à exibição ativa do formulário. (Herdado de _XDocument2)
Query()	Recupera dados do objeto adaptador de dados associado de um formulário e armazena os dados no DOM (Modelo de Objeto de Documento XML) subjacente do formulário. (Herdado de _XDocument2)
Save()	Salva o formulário na URL à qual ele está associado no momento. (Herdado de _XDocument2)
SaveAs(String)	Salva o formulário na URL especificada. (Herdado de _XDocument2)
SetDataVariable(Int32, String)	Define o valor de uma variável predefinida armazenada como um atributo de instrução de processamento no documento XML subjacente do formulário. (Herdado de _XDocument2)
SetDirty(Boolean)	Define a IsDirty propriedade para o objeto, o XDocument que indica se os dados em um formulário foram modificados desde a última salvação. (Herdado de _XDocument2)
SetNamedNodeProperty(IXMLDOMNode, String, String)	Define o valor de uma propriedade nomeada para o nó XML fornecido, que deve ser um nó nonattribute na fonte de dados main. (Herdado de _XDocument2)
Submit()	Executa a operação de envio predefinida em um formulário. (Herdado de _XDocument2)