Proprietà XmlForm.QueryDataConnection

Articolo
04/27/2010

Ottiene un riferimento all'oggetto DataConnection che rappresenta la connessione dati associata al modulo.

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

Sintassi

Public MustOverride ReadOnly Property QueryDataConnection As DataConnection

Dim instance As XmlForm
Dim value As DataConnection

value = instance.QueryDataConnection

public abstract DataConnection QueryDataConnection { get; }

Valore proprietà

Oggetto DataConnection che rappresenta la connessione dati associata al modulo.

Osservazioni

L'oggetto DataConnection implementa proprietà e metodi che consentono di recuperare e inviare dati a origini dati esterne. La connessione dati associata a un modulo dipende dal tipo di origine dati utilizzato al momento della creazione del modulo.

La proprietà QueryDataConnection consente di accedere all'origine dati principale di un modulo di InfoPath. Per accedere agli oggetti adattatore dati utilizzati per le origini dati secondarie di un modulo, utilizzare la proprietà DataSources.

Nota:
La proprietà QueryDataConnection offre funzionalità simili a quelle della proprietà QueryAdapter dell'oggetto XDocument del modello a oggetti COM o script e della proprietà QueryAdapter dell'interfaccia _XDocument2 del modello a oggetti in codice gestito compatibile con InfoPath 2003.

Possono accedere a questo membro solo moduli eseguiti nello stesso dominio del modulo aperto oppure moduli a cui sono state concesse autorizzazioni tra domini.

A questo tipo o membro può accedere solo il codice in esecuzione in moduli aperti in Microsoft Office InfoPath 2007 o in un browser.

Esempio

Nell'esempio seguente viene utilizzata la proprietà QueryDataConnection della classe XmlForm per impostare un riferimento agli oggetti ADOQueryConnection e ADOSubmitConnection associati al modello di modulo. Vengono quindi utilizzate la proprietà Command dell'oggetto ADOQueryConnection e la proprietà Command degli oggetti ADOQueryConnection per visualizzare il testo del comando SQL per ogni tipo di connessione in una finestra di messaggio.

ADOQueryConnection queryConnection;
ADOSubmitConnection submitConnection;

queryConnection = (ADOQueryConnection) this.QueryConnection;
MessageBox.Show("Query SQL command text: " + queryConnection.Command);

submitConnection = (ADOSubmitConnection) this.QueryConnection;
MessageBox.Show("Submit SQL command text: " + querySubmit.Command);
Dim queryConnection As ADOQueryConnection
Dim submitConnectionmAs ADOSubmitConnection

queryConnection = DirectCast(ADOQueryConnection, Me.QueryConnection)
MessageBox.Show("Query SQL command text: " & queryConnection.Command)

submitConnection = DirectCast(ADOSubmitConnection, Me.QueryConnection)
MessageBox.Show("Submit SQL command text: " & querySubmit.Command)

Vedere anche

Riferimenti

Classe XmlForm
Membri XmlForm
Spazio dei nomi Microsoft.Office.InfoPath

Condividi tramite