DataConnectionCollection.Item[] Propriedade

Definição

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Sobrecargas

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.

Item[Int32]

Obtém uma referência ao objeto especificado DataConnection da coleção por valor de índice.

public:
 abstract property Microsoft::Office::InfoPath::DataConnection ^ default[int] { Microsoft::Office::InfoPath::DataConnection ^ get(int index); };

public abstract Microsoft.Office.InfoPath.DataConnection this[int index] { get; }

member this.Item(int) : Microsoft.Office.InfoPath.DataConnection

Default Public MustOverride ReadOnly Property Item(index As Integer) As DataConnection

Parâmetros

index

Int32

O índice baseado em zero do objeto a DataConnection ser obtido.

Valor da propriedade

DataConnection

O objeto especificado.

Exemplos

No exemplo a seguir, o primeiro DataConnection objeto é recuperado do DataConnectionCollectione, em seguida, é lançado para o EmailSubmitConnection tipo.

// Get the first connection from the 
// DataConnections collection.
EmailSubmitConnection myEmailSubmitConnection =
   (EmailSubmitConnection)(this.DataConnections[0]);

' Get the first connection from the 
' DataConnections collection.
Dim myEmailSubmitConnection As EmailSubmitConnection = _
   DirectCast(Me.DataConnections(0), EmailSubmitConnection)

Comentários

Depois de definir uma referência ao DataConnection objeto que a propriedade Item retorna, você poderá acessar qualquer uma de suas propriedades ou métodos depois que o objeto tiver sido lançado para o tipo apropriado para a conexão de dados correspondente. Por exemplo, para acessar as propriedades e os métodos de uma conexão de dados para enviar um formulário por email, você deve lançar o objeto retornado DataConnection para o EmailSubmitConnection tipo.

Importante: o valor de índice de uma determinada conexão de dados não é garantido como o mesmo entre versões ou entre sessões de abertura do mesmo modelo de formulário no InfoPath e em um navegador da Web (de uma biblioteca de documentos adequadamente configurada no SharePoint Server 2010 executando InfoPath Forms Services). Para abrir de forma confiável a mesma conexão de dados em todas as condições, você deve abrir a conexão de dados explicitamente pelo nome usando o Item[String] método.

This member can be accessed without restrictions.

This type or member can be accessed from code running in forms opened in Microsoft InfoPath Filler or in a Web browser.

Item[String]

Obtém uma referência ao objeto especificado DataConnection da coleção pelo nome.

public:
 abstract property Microsoft::Office::InfoPath::DataConnection ^ default[System::String ^] { Microsoft::Office::InfoPath::DataConnection ^ get(System::String ^ name); };

public abstract Microsoft.Office.InfoPath.DataConnection this[string name] { get; }

member this.Item(string) : Microsoft.Office.InfoPath.DataConnection

Default Public MustOverride ReadOnly Property Item(name As String) As DataConnection

Parâmetros

name

String

O nome do objeto a DataConnection ser obtido.

Valor da propriedade

DataConnection

O objeto especificado.

Exemplos

No exemplo a seguir, o DataConnection objeto chamado "Funcionários" é recuperado do DataConnectionCollectione, em seguida, é lançado para o AdoQueryConnection tipo (que representa uma conexão de dados para recuperar dados de um banco de dados access ou SQL Server).

// 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)

Comentários

Depois de definir uma referência ao DataConnection objeto que a propriedade Item retorna, você poderá acessar qualquer uma de suas propriedades ou métodos depois que o objeto tiver sido lançado para o tipo apropriado para a conexão de dados correspondente. Por exemplo, para acessar as propriedades e os métodos de uma conexão de dados para enviar um formulário por email, você deve lançar o objeto retornado DataConnection para o EmailSubmitConnection tipo.

This member can be accessed without restrictions.

This type or member can be accessed from code running in forms opened in Microsoft InfoPath Filler or in a Web browser.