SqlCeRemoteDataAccess.Push Method (String, String)

Articolo
01/14/2011

Trasmette le modifiche da una tabella con rilevamento di cui è stato effettuato il pull in SQL Server Compact 3.5 alla tabella di SQL Server di origine. Queste modifiche vengono singolarmente applicate al server in transazioni separate.

Spazio dei nomi: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in system.data.sqlserverce.dll)

Sintassi

'Dichiarazione
Public Sub Push ( _
    localTableName As String, _
    oleDBConnectionString As String _
)

public void Push (
    string localTableName,
    string oleDBConnectionString
)

public:
void Push (
    String^ localTableName, 
    String^ oleDBConnectionString
)

public void Push (
    String localTableName, 
    String oleDBConnectionString
)

public function Push (
    localTableName : String, 
    oleDBConnectionString : String
)

Parametri

localTableName
Nome della tabella di SQL Server Compact 3.5 in cui verranno inseriti i record estratti di SQL Server. Si verifica un errore se la tabella esiste già.

oleDBConnectionString

Osservazioni

Il metodo Push viene chiamato per trasmettere le modifiche da una tabella con rilevamento di SQL Server Compact 3.5 di cui è stato effettuato il pull a una tabella di SQL Server. È necessario che la tabella di SQL Server Compact 3.5 locale sia stata creata mediante la chiamata al metodo Pull con l'oggetto RdaTrackOption impostato su TrackingOn o su TrackingOnWithIndexes.

In oledbConnectionString sono specificate tutte le informazioni utilizzate per la connessione a SQL Server.

Se si utilizza l'autenticazione di SQL Server, è necessario che l'identificatore utente specificato in OLEDBConnectionString disponga dell'autorizzazione per la lettura della tabella di SQL Server.

Se si utilizza l'autenticazione di Windows impostando INTEGRATED SECURITY="SSPI" in OLEDBConnectionString, è necessario che l'utente Internet disponga dell'autorizzazione per la lettura della tabella di SQL Server. Di seguito viene identificato l'utente Internet in base al metodo di autenticazione:

Quando la directory virtuale di Microsoft Internet Information Services (IIS) è configurata per l'utilizzo dell'accesso anonimo, l'identità dell'utente Internet è rappresentata dall'account Guest, ovvero da IUSR_nomecomputer. Se si configura un altro account utente Windows come Internet Guest Account, l'utente Internet avrà l'identità di quell'account.
Quando la directory virtuale di IIS è configurata per l'utilizzo dell'autenticazione di base, l'utente Internet ha l'identità dell'account utente Windows i cui nome utente e password Internet sono stati forniti dal client.
Quando la directory virtuale di IIS è configurata per l'utilizzo dell'autenticazione integrata di Windows, l'utente Internet ha l'identità dell'account utente Windows i cui nome utente e password Internet sono stati forniti dal client.

Se la tabella errorTableName è stata specificata al momento della chiamata al metodo Pull, tutti gli errori rilevati durante l'esecuzione del metodo Push vengono registrati nella tabella degli errori. Per ulteriori informazioni sul funzionamento della tabella degli errori, vedere "RDA Conflict Detection and Resolution" (Rilevamento e risoluzione dei conflitti RDA) nella documentazione in linea di SQL Server Compact 3.5.

Esempio

Nell'esempio riportato di seguito viene creato un oggetto SqlCeRemoteDataAccess, vengono impostate diverse proprietà, dopodiché viene chiamato il metodo Push.

' Connection String to the SQL Server
'
Dim rdaOleDbConnectString As String = "Data Source=MySqlServer;Initial Catalog=AdventureWorks; " & _
    "User Id=username;Password = <password>"

' Initialize RDA Object
'
Dim rda As SqlCeRemoteDataAccess = Nothing

Try
    ' Try the Push Operation
    '
    rda = New SqlCeRemoteDataAccess( _
        "https://www.adventure-works.com/sqlmobile/sqlcesa35.dll", _
        "Data Source=MyDatabase.sdf")

    rda.InternetLogin = "MyLogin"
    rda.InternetPassword = "<password>"

    rda.Push("MyLocalTable", rdaOleDbConnectString, RdaBatchOption.BatchingOn)

    ' or, try this overload:
    '
    ' rda.Push("MyLocalTable", rdaOleDbConnectString)

Catch
    ' Handle errors here
    '
Finally
    ' Dispose of the RDA Object
    '
    rda.Dispose()
End Try

// Connection String to the SQL Server
//
string rdaOleDbConnectString = "Data Source=MySqlServer;Initial Catalog=AdventureWorks; " +
    "User Id=username;Password = <password>";

// Initialize RDA Object
//
SqlCeRemoteDataAccess rda = null;

try
{
    // Try the Push Operation
    //
    rda = new SqlCeRemoteDataAccess(
        "https://www.adventure-works.com/sqlmobile/sqlcesa35.dll",
        "Data Source=MyDatabase.sdf");

    rda.InternetLogin = "MyLogin";
    rda.InternetPassword = "<password>";

    rda.Push("MyLocalTable", rdaOleDbConnectString, RdaBatchOption.BatchingOn);

    // or, try this overload:
    //
    // rda.Push("MyLocalTable", rdaOleDbConnectString);
}
catch (SqlCeException)
{
    // Handle errors here
    //
}
finally
{
    // Dispose of the RDA Object
    //
    rda.Dispose();
}

Affidabilità

Tutti i membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono affidabili. Non è invece garantita l'affidabilità dei membri dell'istanza.

Piattaforme

Piattaforme di sviluppo

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Informazioni sulla versione
.NET Framework e .NET Compact Framework
Supportato in 3.5
.NET Framework
Supportato in 3.0
.NET Compact Framework e .NET Framework
Supportato in 2.0

Vedere anche

Riferimento

SqlCeRemoteDataAccess Class
SqlCeRemoteDataAccess Members
System.Data.SqlServerCe Namespace

Condividi tramite