SqlCeRemoteDataAccess.Push Method (String, String, RdaBatchOption)

Article
01/14/2011

Retransmet les modifications effectuées dans une table extraite qui fait l'objet d'un suivi dans SQL Server Compact 3.5 à la table SQL Server. Ces modifications peuvent être appliquées individuellement au serveur ou groupées en une seule transaction.

Espace de noms: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (dans system.data.sqlserverce.dll)

Syntaxe

'Déclaration
Public Sub Push ( _
    localTableName As String, _
    oleDBConnectionString As String, _
    batchOption As RdaBatchOption _
)

public void Push (
    string localTableName,
    string oleDBConnectionString,
    RdaBatchOption batchOption
)

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

public void Push (
    String localTableName, 
    String oleDBConnectionString, 
    RdaBatchOption batchOption
)

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

Paramètres

localTableName
Nom de la table SQL Server Compact 3.5 qui recevra les enregistrements SQL Server extraits. Une erreur se produit si la table existe déjà.

oleDBConnectionString

batchOption
L'option indique si les modifications renvoyées à la table SQL Server doivent être groupées en une seule transaction ou appliquées individuellement.

Remarques

Les applications appellent la méthode Push afin de retransmettre les modifications effectuées dans une table SQL Server Compact 3.5 extraite qui fait l'objet d'un suivi vers une table SQL Server. L'application doit avoir créé la table SQL Server Compact 3.5 locale en appelant la méthode Pull avec RdaTrackOption ayant la valeur TrackingOn ou TrackingOnWithIndexes.

oledbConnectionString spécifie toutes les informations de connexion utilisées pendant la connexion à SQL Server.

Si l'authentification SQL Server est utilisée, l'ID d'utilisateur spécifié dans OLEDBConnectionString doit disposer de l'autorisation requise pour lire la table SQL Server.

Si l'authentification Windows est utilisée en définissant INTEGRATED SECURITY="SSPI" dans OLEDBConnectionString, l'utilisateur Internet doit avoir l'autorisation requise pour lire la table SQL Server. Ce qui suit identifie l'utilisateur Internet en fonction de la méthode d'authentification :

Lorsque le répertoire virtuel des services IIS ( Microsoft Internet Information Services) est configuré de manière à utiliser l'accès anonyme, l'utilisateur Internet utilise l'identité du Compte Invité Internet (IUSR_NomOrdinateur). Si vous configurez un autre compte d'utilisateur Windows en tant que Compte Invité Internet, l'utilisateur Internet utilise l'identité de ce compte.
Lorsque le répertoire virtuel IIS est configuré de manière à employer l'authentification de base, l'utilisateur Internet utilise l'identité du compte d'utilisateur Windows pour lequel le client a fourni le nom d'utilisateur Internet et le mot de passe correspondant.
Lorsque le répertoire virtuel IIS est configuré de manière à employer l'authentification intégrée de Windows, l'utilisateur Internet utilise l'identité du compte d'utilisateur Windows pour lequel le client a fourni le nom d'utilisateur Internet et le mot de passe correspondant.

Si errorTableName a été spécifié lors de l'appel de la méthode Pull, les erreurs éventuellement détectées pendant Push sont consignées dans la table des erreurs. Pour plus d'informations sur le fonctionnement de la table des erreurs, consultez « Détection et signalement des conflits RDA » dans la documentation en ligne de SQL Server Compact 3.5.

Exemple

L'exemple suivant crée un objet SqlCeRemoteDataAccess, définit plusieurs propriétés, puis appelle la méthode 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();
}

Sécurité des threads

Tout membre statique public (Partagé dans Microsoft Visual Basic) de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme sûrs.

Plateformes

Plateformes de développement

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
Informations sur la version
.NET Framework et NET Compact Framework
Pris en charge dans 3.5
.NET Framework
Pris en charge dans 3.0
.NET Compact Framework et .Net Framework
Pris en charge dans 2.0

Voir aussi

Référence

SqlCeRemoteDataAccess Class
SqlCeRemoteDataAccess Members
System.Data.SqlServerCe Namespace

Partager via