Metodo Pull (RDA)
Recupera i dati da un database di Microsoft SQL Server remoto e li archivia in un'unica tabella di un database di Microsoft SQL Server 2005 Compact Edition (SQL Server Compact Edition) locale.
Prima di chiamare il metodo Pull, è necessario impostare le proprietà dell'oggetto RDA seguenti:
- La proprietà InternetURL deve contenere l'URL di Agente server di SQL Server Compact Edition.
- La proprietà LocalConnectionString deve contenere la stringa di connessione OLE DB per il database di SQL Server Compact Edition sul dispositivo.
- Se Agente server di SQL Server Compact Edition è configurato per l'utilizzo dell'autenticazione di base o integrata, è necessario specificare le proprietà InternetLogin e InternetPassword.
Sintassi
object.Pull (localTableName, sqlSelectString, oledbConnectionString, RDA_TRACKOPTION, ErrorTableName)
Parametri
- LocalTableName
Nome della tabella di SQL Server Compact Edition che riceve i record di SQL Server estratti. Se la tabella è già esistente, si verifica un errore.
- SQLSelectString
Stringa che specifica la tabella, le colonne e i record da estrarre dal database SQL Server e da archiviare nel database di SQL Server Compact Edition. Tale stringa può essere qualsiasi istruzione SQL valida che restituisce righe, incluse le istruzioni SELECT o le stored procedure.
- OLEDBConnectionString
Stringa di connessione OLE DB utilizzata per connettersi al database SQL Server. For more information, see Programmazione di RDA per SQL Server Compact Edition.
- RDA_TRACKOPTION
L'enumerazione RDA_TRACKOPTION indica se si tiene traccia delle modifiche apportate alla tabella di cui è stato eseguito il pull. Se gli indici sono necessari, quelli presenti nella tabella di cui si esegue il pull vengono trasmessi al dispositivo con i vincoli PRIMARY KEY. Per ulteriori informazioni, vedere RDA_TRACKOPTION.
- ErrorTableName
Nome della tabella degli errori locale che viene creata se si verifica un errore quando si chiama il metodo Push per reinviare le modifiche a SQL Server. Questa opzione può essere specificata solo quando RDA_TRACKOPTION è impostato su TRACKINGON.
Si applica a
Oggetto RemoteDataAccess di SQL Server Compact Edition
Osservazioni
SQLSelectString
Il parametro SQLSelectString controlla di quali dati si esegue il pull dalla tabella SQL Server. Quando si utilizza il parametro SQLSelectString, tenere in considerazione quanto segue:
- Il parametro SQLSelectString può specificare una clausola WHERE per controllare quali record vengono restituiti. Ad esempio,
SELECT * FROM Address WHERE PostalCode='93868'recupera gli indirizzi relativi solo al codice postale specificato. - SQLSelectString supporta le stored procedure e le viste che restituiscono righe.
- SQLSelectString consente di eseguire il pull in un'unica tabella delle colonne selezionate in più tabelle, ma solo se il parametro RDA_TRACKOPTION viene impostato su TRACKINGOFF.
- Se il set di record risultante contiene un tipo di dati non supportato, ad esempio timestamp, si verifica un errore.
ErrorTableName
Il parametro ErrorTableName specifica il nome della tabella in cui archiviare gli errori che si verificano durante un push. In caso di errore quando l'applicazione chiama il metodo Push, SQL Server Compact Edition crea una tabella degli errori e vi aggiunge un record per ogni errore generato. Al termine del metodo Push, l'applicazione potrà esaminare questa tabella per determinare se si sono verificati errori. ErrorTableName può essere specificato solo se TRACKINGON o TRACKINGONWITHINDEXES sono specificati. Per ulteriori informazioni sul funzionamento della tabella degli errori, vedere Rilevamento e segnalazione dei conflitti RDA.
Vedere anche
Riferimenti
Metodi dell'oggetto RDA
Metodo Push (RDA)