Oggetto DataControl (Servizi Desktop remoto)

Associa un oggetto Recordset di query di dati a uno o più controlli , ad esempio una casella di testo, un controllo griglia o una casella combinata, per visualizzare i dati recordset in una pagina Web.

Importante

A partire da Windows 8 e Windows Server 2012, i componenti server di Servizi Desktop remoto non sono più inclusi nel sistema operativo Windows (per altre informazioni, vedere Windows 8 e Windows Server 2012 Compatibility Cookbook). I componenti client di Servizi Desktop remoto verranno rimossi in una versione futura Windows. Evitare di usare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata. Le applicazioni che usano Servizi Desktop remoto devono eseguire la migrazione a WCF Data Service.

Sintassi

  
<OBJECT CLASSID="clsid:BD96C556-65A3-11D0-983A-00C04FC29E33" ID="DataControl"  
   <PARAM NAME="Connect" VALUE="DSN=DSNName;UID=MyUserID;PWD=MyPassword;">  
   <PARAM NAME="Server" VALUE="https://awebsrvr">  
   <PARAM NAME="SQL" VALUE="QueryText">  
</OBJECT>  

Osservazioni

ID di classe per Servizi Desktop remoto. L'oggetto DataControl è BD96C556-65A3-11D0-983A-00C04FC29E33.

Nota

Se viene visualizzato un errore di servizi Desktop remoto. DataSpace o Servizi Desktop remoto. L'oggetto DataControl non viene caricato, assicurarsi di usare l'ID di classe corretto. Gli ID di classe per questi oggetti sono stati modificati dalla versione 1.0 e 1.1. Tenere inoltre presente che anche le colonne nullable devono essere impostate quando si usa l'oggetto DataControl di Servizi Desktop remoto.

Per uno scenario di base, è necessario impostare solo le proprietà SQL, Connessione e Server di Servizi Desktop remoto. Oggetto DataControl, che chiamerà automaticamente l'oggetto business predefinito, RDSServer.DataFactory.

Tutte le proprietà in Servizi Desktop remoto. DataControl è facoltativo perché gli oggetti business personalizzati possono sostituire le relative funzionalità.

Nota

Se si esegue una query per ottenere più risultati, viene restituito solo il primo oggetto Recordset. Se sono necessari più set di risultati, assegnare ognuno al proprio DataControl. Un esempio di query per più risultati può essere il seguente: "Select * from Authors, Select * from Topics"

Aggiunta di "DFMode=20;" alla stringa di connessione quando si usa Servizi Desktop remoto. L'oggetto DataControl può migliorare le prestazioni del server quando si aggiornano i dati. Con questa impostazione, l'oggetto RDSServer.DataFactory nel server usa una modalità meno a elevato utilizzo di risorse. Tuttavia, le funzionalità seguenti non sono disponibili in questa configurazione:

  • Uso di query con parametri.

  • Recupero di informazioni sul parametro o sulla colonna prima di chiamare il metodo Execute.

  • L'impostazione di Transact Updates su True.

  • Recupero dello stato della riga.

  • Chiamata del metodo Resync.

  • Aggiornamento (in modo esplicito o automatico) tramite la proprietà Aggiorna risincronizzazione.

  • Impostazione delle proprietà Command o Recordset.

  • Uso di adCmdTableDirect.

Servizi Desktop remoto. L'oggetto DataControl viene eseguito in modalità asincrona per impostazione predefinita. Se è necessaria l'esecuzione sincrona per l'applicazione, impostare il parametro ExecuteOptions su adcExecSync e il parametro FetchOptions uguale a adcFetchUpFront, come illustrato nell'esempio seguente.

<OBJECT CLASSID="clsid:BD96C556-65A3-11D0-983A-00C04FC29E33"   
    ID="DataControl"  
   <PARAM NAME="Connect" VALUE="DSN=DSNName;UID=MyUserID;PWD=MyPassword;">  
   <PARAM NAME="Server" VALUE="https://awebsrvr">  
   <PARAM NAME="SQL" VALUE="QueryText">  
   <PARAM NAME="ExecuteOptions" VALUE="1">   <PARAM NAME="FetchOptions" VALUE="1">  
</OBJECT>  

Usare un'unica connessione Desktop remoto. Oggetto DataControl per collegare i risultati di una singola query a uno o più controlli visivi. Si supponga, ad esempio, di codificare una query che richiede i dati dei clienti, ad esempio Nome, Residenza, Luogo di nascita, Età e Stato cliente prioritario. È possibile usare un singolo servizio Desktop remoto. Oggetto DataControl per visualizzare il nome, l'età e l'area di un cliente in tre caselle di testo separate. Priorità Stato cliente in una casella di controllo; e tutti i dati in un controllo griglia.

Usare Servizi Desktop remoto diverso. Oggetti DataControl per collegare i risultati di più query a controlli visivi diversi. Si supponga ad esempio di usare una query per ottenere informazioni su un cliente e una seconda query per ottenere informazioni sulla merce acquistata dal cliente. Si desidera visualizzare i risultati della prima query in tre caselle di testo e una casella di controllo e i risultati della seconda query in un controllo griglia. Se si usa l'oggetto business predefinito (RDSServer.DataFactory), è necessario eseguire le operazioni seguenti:

  • Aggiungere due servizi Desktop remoto. Oggetti DataControl nella pagina Web.

  • Scrivere due query, una per ogni SQL proprietà dei due Servizi Desktop remoto. Oggetti DataControl. Un servizio Desktop remoto. L'oggetto DataControl conterrà un SQL query che richiede informazioni sul cliente. la seconda conterrà una query che richiede un elenco di prodotti acquistati dal cliente.

  • Nei tag OBJECT di ogni controllo associato specificare il valore DATAFLD per impostare i valori per i dati che si desidera visualizzare in ogni controllo visivo.

Non esiste alcuna restrizione di conteggio sul numero di Servizi Desktop remoto. Oggetti DataControl che è possibile incorporare usando tag OBJECT in una singola pagina Web.

Quando si definisce Servizi Desktop remoto. Oggetto DataControl in una pagina Web, usare valori Di altezza e Larghezza diversi da zero, ad esempio 1 (per evitare l'inclusione di spazio aggiuntivo).

I componenti client di Remote Data Service sono già inclusi come parte di Internet Explorer 4.0. Pertanto, non è necessario includere un parametro CODEBASE in Servizi Desktop remoto. Tag dell'oggetto DataControl.

Con Internet Explorer 4.0 o versione successiva, è possibile eseguire l'associazione ai dati usando controlli HTML e controlli ActiveX® solo se sono contrassegnati come controlli modello apartment.

Nota

Utenti Visual Basic Microsoft Servizi Desktop remoto. DataControl è sicuro per gli script e viene usato solo nelle applicazioni basate sul Web. Un'Visual Basic client non è necessaria.

Questa sezione contiene l'argomento seguente.

Vedere anche

Esempio di oggetto DataControl (VBScript)