Classe DataConnection

Articolo
04/27/2010

Rappresenta la classe di base da cui viene derivato ogni tipo specifico di connessione dati.

Spazio dei nomi: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Sintassi

Public MustInherit Class DataConnection

Dim instance As DataConnection

public abstract class DataConnection

Osservazioni

Ogni connessione dati viene utilizzata per il recupero dei dati (inseriti nell'origine dati principale o in un'origine dati secondaria) oppure per l'invio dei dati.

Una connessione dati utilizzata per il recupero o l'invio dei dati per l'origine dati principale corrisponderà a uno dei tipi di oggetto connessione dati seguenti:

Oggetto AdoQueryConnection o AdoSubmitConnection
Oggetto WebServiceConnection

Una connessione dati utilizzata per il recupero dei dati per un'origine dati secondaria corrisponderà a uno dei tipi di oggetto connessione dati seguenti:

ADOQueryConnection
Oggetto SharepointListQueryConnection
Oggetto WebServiceConnection
Oggetto FileQueryConnection

Una connessione dati utilizzata esclusivamente per l'invio dei dati corrisponderà a uno dei tipi di oggetto connessione dati seguenti:

Oggetto EmailSubmitConnection
Oggetto FileSubmitConnection
Oggetto WebServiceConnection

Per accedere a un oggetto DataConnection per un tipo particolare di connessione dati, utilizzare l'oggetto DataConnectionCollection associato al modello di modulo. Per accedere all'oggetto DataConnectionCollection, utilizzare la proprietà DataConnections della classe XmlForm.

Per utilizzare le proprietà e i metodi dell'oggetto restituito da DataConnectionCollection, è necessario eseguire il cast dell'oggetto al tipo che rappresenta la connessione dati utilizzata, prima di poter accedere a tali membri. Per utilizzare, ad esempio, un oggetto AdoQueryConnection, che rappresenta una connessione dati per il recupero dei dati da un database di Access o di SQL Server, è necessario eseguire il cast dell'oggetto restituito da DataConnectionCollection, come illustrato negli esempi seguenti.

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

Per ulteriori informazioni sull'utilizzo delle connessioni dati, vedere Procedura: Accedere a origini dati esterne.

Gerarchia di ereditarietà

System.Object
Microsoft.Office.InfoPath.DataConnection
Classi derivate

Thread Safety

Tutti i membri statici pubblici (Shared in Visual Basic) di questo tipo sono thread-safe. I membri di istanza non sono garantiti come thread-safe.

Vedere anche

Riferimenti

Membri DataConnection
Spazio dei nomi Microsoft.Office.InfoPath

Condividi tramite