Compartir a través de


DataConnectionCollection.Item[] Propiedad

Definición

Sobrecargas

Item[Int32]

Obtiene una referencia al objeto especificado DataConnection de la colección por valor de índice.

Item[String]

Obtiene una referencia al objeto especificado DataConnection de la colección por nombre.

Item[Int32]

Obtiene una referencia al objeto especificado DataConnection de la colección 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

Índice de base cero del DataConnection objeto que se va a obtener.

Valor de propiedad

El objeto especificado.

Ejemplos

En el ejemplo siguiente, el primer DataConnection objeto se recupera de y DataConnectionCollection, a continuación, se convierte en el 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)

Comentarios

Después de establecer una referencia al DataConnection objeto que devuelve la propiedad Item , puede acceder a cualquiera de sus propiedades o métodos después de que el objeto se haya convertido al tipo adecuado para la conexión de datos correspondiente. Por ejemplo, para tener acceso a las propiedades y métodos de una conexión de datos para enviar un formulario por correo electrónico, debe convertir el objeto devuelto DataConnection al EmailSubmitConnection tipo .

Importante: No se garantiza que el valor de índice de una conexión de datos determinada sea el mismo entre versiones o entre sesiones de apertura de la misma plantilla de formulario en InfoPath y en un explorador web (desde una biblioteca de documentos configurada correctamente en SharePoint Server 2010 que ejecuta InfoPath Forms Services). Para abrir de forma confiable la misma conexión de datos en todas las condiciones, debe abrir la conexión de datos explícitamente por nombre mediante el Item[String] método en su lugar.

Se puede acceder a este miembro sin restricciones.

Se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler o en un explorador web.

Se aplica a

Item[String]

Obtiene una referencia al objeto especificado DataConnection de la colección por nombre.

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

Nombre del DataConnection objeto que se va a obtener.

Valor de propiedad

El objeto especificado.

Ejemplos

En el ejemplo siguiente, el DataConnection objeto denominado "Employees" se recupera de yDataConnectionCollection, a continuación, se convierte en el AdoQueryConnection tipo (que representa una conexión de datos para recuperar datos de una base de datos access o 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)

Comentarios

Después de establecer una referencia al DataConnection objeto que devuelve la propiedad Item , puede acceder a cualquiera de sus propiedades o métodos después de que el objeto se haya convertido al tipo adecuado para la conexión de datos correspondiente. Por ejemplo, para tener acceso a las propiedades y métodos de una conexión de datos para enviar un formulario por correo electrónico, debe convertir el objeto devuelto DataConnection al EmailSubmitConnection tipo .

Se puede acceder a este miembro sin restricciones.

Se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler o en un explorador web.

Se aplica a