DataConnectionCollection Classe

Definição

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Contém um objeto de conexão de dados correspondente a cada conexão de dados usada em um modelo de formulário.

public ref class DataConnectionCollection abstract : System::Collections::IEnumerable

public abstract class DataConnectionCollection : System.Collections.IEnumerable

type DataConnectionCollection = class
    interface IEnumerable

Public MustInherit Class DataConnectionCollection
Implements IEnumerable

Herança

Object

DataConnectionCollection

Implementações

IEnumerable

Comentários

Cada conexão de dados é usada para recuperar dados (inseridos na fonte de dados main ou em uma fonte de dados secundária) ou para enviar dados.

Uma conexão de dados usada para recuperar ou enviar dados para a fonte de dados main corresponderá a um dos seguintes tipos de objeto de conexão de dados:

• AdoQueryConnection
• AdoSubmitConnection
• WebServiceConnection

Uma conexão de dados usada para recuperar dados de uma fonte de dados secundária corresponderá a um dos seguintes tipos de objeto de conexão de dados:

• AdoQueryConnection
• BdcQueryConnection
• FileQueryConnection
• SharePointListRWQueryConnection
• WebServiceConnection

Uma conexão de dados usada apenas para enviar dados corresponderá a um dos seguintes tipos de objeto de conexão de dados:

• BdcSubmitConnection
• EmailSubmitConnection
• FileSubmitConnection
• SharePointListRWSubmitConnection
• WebServiceConnection

Para acessar um DataConnection objeto para um determinado tipo de conexão de dados, use o DataConnectionCollection objeto associado ao modelo de formulário. Para acessar o DataConnectionCollection objeto, use a DataConnections propriedade da XmlForm classe.

Para usar as propriedades ou métodos do objeto retornado do DataConnectionCollection, você deve lançar esse objeto para o tipo que representa o tipo de conexão de dados com a qual você está trabalhando antes de poder acessar esses membros. Por exemplo, para trabalhar com um AdoQueryConnection objeto (que representa uma conexão de dados para recuperar dados de um banco de dados Access ou SQL Server), você deve lançar o objeto retornado do DataConnectionCollection conforme mostrado nos exemplos a seguir.

// Get the Employees connection from the 
// DataConnections collection.
AdoQueryConnection myAdoQueryConnection =
   (AdoQueryConnection)(this.DataConnections["Employees"]);

' Get the Employees connection from the 
' DataConnections collection.
Dim myAdoQueryConnection As AdoQueryConnection = _
   DirectCast(Me.DataConnections("Employees"), AdoQueryConnection)

Para obter mais informações sobre como trabalhar com conexões de dados, consulte Como: Acessar fontes de dados externas.

Construtores

DataConnectionCollection()

Contém um objeto de conexão de dados correspondente a cada conexão de dados usada em um modelo de formulário.

Propriedades

Count	Obtém a contagem do número de DataConnection objetos na coleção.
Item[Int32]	Obtém uma referência ao objeto especificado DataConnection da coleção por valor de índice.
Item[String]	Obtém uma referência ao objeto especificado DataConnection da coleção pelo nome.

Métodos

GetEnumerator()

Obtém um IEnumerator objeto que itera em todas as entradas da coleção.