Partager via

Push méthode (String, String, RdaBatchOption)

  • Article

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 regroupé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 _
)
'Utilisation
Dim instance As SqlCeRemoteDataAccess
Dim localTableName As String
Dim oleDBConnectionString As String
Dim batchOption As RdaBatchOption

instance.Push(localTableName, oleDBConnectionString, _
    batchOption)

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

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

member Push : 
        localTableName:string * 
        oleDBConnectionString:string * 
        batchOption:RdaBatchOption -> unit 

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

Paramètres

  • localTableName
    Type : System. . :: . .String
    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à.

Notes

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 de Microsoft Internet Information Services (IIS) 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 lors du 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.

Exemples

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();
}

Voir aussi

Référence

SqlCeRemoteDataAccess Classe

Membres SqlCeRemoteDataAccess

Surcharge Push

Espace de noms System.Data.SqlServerCe