Freigeben über


SqlCeRemoteDataAccess.Push-Methode (String, String)

Hinweis: Dieser Namespace oder Member bzw. diese Klasse wird nur von .NET Framework, Version 1.1, unterstützt.

Überträgt Änderungen aus einer abgerufenen und verfolgten Tabelle in SQL Server CE zurück an die ursprüngliche SQL Server-Tabelle. Diese Änderungen werden einzeln in gesonderten Transaktionen auf den Server angewendet.

Overloads Public Sub Push( _
   ByVal localTableName As String, _   ByVal oledbConnectionString As String _)
[C#]
public void Push(stringlocalTableName,stringoledbConnectionString);
[C++]
public: void Push(String* localTableName,String* oledbConnectionString);
[JScript]
public function Push(
   localTableName : String,oledbConnectionString : String);

Parameter

  • localTableName
    Der Name der SQL Server CE-Tabelle, die die extrahierten SQL Server-Datensätze empfängt. Wenn die Tabelle bereits vorhanden ist, tritt ein Fehler auf.
  • oledbConnectionString
    Die beim Herstellen einer Verbindung mit der SQL Server-Datenbank verwendete OLE DB-Verbindungszeichenfolge.

Hinweise

Anwendungen rufen die Push-Methode auf, um Änderungen aus einer abgerufenen und verfolgten SQL Server CE-Tabelle an eine SQL Server-Tabelle zurückzusenden. Die Anwendung muss die lokale SQL Server CE-Tabelle durch Aufruf der Pull-Methode erstellt haben, wobei RdaTrackOption auf TrackingOn oder TrackingOnWithIndexes festgelegt ist.

oledbConnectionString gibt alle Verbindungsinformationen an, die beim Herstellen einer Verbindung mit SQL Server verwendet werden.

Bei Verwendung von SQL Server-Authentifizierung muss die in OLEDBConnectionString angegebene Benutzer-ID über die Berechtigung zum Lesen der SQL Server-Tabelle verfügen.

Wenn zum Verwenden der Windows-Authentifizierung in OLEDBConnectionString INTEGRATED SECURITY="SSPI" festgelegt ist, muss der Internetbenutzer über die Berechtigung zum Lesen der SQL Server-Tabelle verfügen. Im Folgenden wird der Internetbenutzer auf der Grundlage der Authentifizierungsmethode identifiziert:

  • Wenn das virtuelle Verzeichnis von Microsoft Internet-Informationsdienste (IIS) für anonymen Zugriff konfiguriert ist, wird der Internetbenutzer unter der Identität des Internetgastkontos (IUSR-Computername) geführt. Wenn Sie ein anderes Windows-Benutzerkonto als Internetgastkonto konfigurieren, wird für den Internetbenutzer die Identität dieses Kontos verwendet.
  • Wenn das virtuelle IIS-Verzeichnis für die Standardauthentifizierung konfiguriert ist, wird der Internetbenutzer unter der Identität des Windows-Benutzerkontos geführt, für das der Client den Namen und das Kennwort des Internetbenutzers bereitgestellt hat.
  • Wenn das virtuelle IIS-Verzeichnis für die integrierte Windows-Authentifizierung konfiguriert ist, wird der Internetbenutzer unter der Identität des Windows-Benutzerkontos geführt, für das der Client den Namen und das Kennwort des Internetbenutzers bereitgestellt hat.

Wenn beim Aufruf der Pull-Methode errorTableName angegeben wurde, werden sämtliche während der Ausführung von Push erkannten Fehler in der Fehlertabelle protokolliert. Weitere Informationen über die Funktionsweise der Fehlertabelle finden Sie in der SQL Server CE-Onlinedokumentation unter "RDA Conflict Detection and Resolution" (nur auf Englisch verfügbar).

Beispiel

 
' Connection String to the SQL Server.
Dim rdaOleDbConnectString As String = _
    "Provider=sqloledb; Data Source=MySqlServer;Initial Catalog=Northwind; " + "User Id=username;Password = <password>"

' Initialize RDA Object.
Dim rda As SqlCeRemoteDataAccess = Nothing

Try
   'Try the Pull Operation.
   rda = New SqlCeRemoteDataAccess()
   
   rda.InternetLogin         = "MyLogin"
   rda.InternetPassword      = "<password>"
   rda.InternetUrl           = "<http://www.northwindtraders.com/sqlce/sscesa20.dll>"
   rda.LocalConnectionString = "Provider=Microsoft.SQLSERVER.OLEDB.CE.2.0;Data Source=\ssce.sdf"
   
   rda.Push("MyLocalTable", rdaOleDbConnectString, RdaBatchOption.BatchingOn)

Catch e As SqlCeException
'Use you own Error Handling Routine.
'ShowErrors(e);
Finally
   'Dispose of the RDA Object.
   rda.Dispose()
End Try

[C#] 

        // Connection String to the SQL Server.
        string rdaOleDbConnectString  = "Provider=sqloledb; Data Source=MySqlServer;Initial Catalog=Northwind; " +
            "User Id=username;Password = <password>"; 
                                      
        // Initialize RDA Object.
        SqlCeRemoteDataAccess rda = null;

        try {
            //Try the Pull Operation.
            rda = new SqlCeRemoteDataAccess();
            
            rda.InternetLogin          = "MyLogin";
            rda.InternetPassword       = "<password>";
            rda.InternetUrl            = "<http://www.northwindtraders.com/sqlce/sscesa20.dll>";
            rda.LocalConnectionString  = @"Provider=Microsoft.SQLSERVER.OLEDB.CE.2.0;Data Source=\ssce.sdf";
           
            rda.Push("MyLocalTable", 
                rdaOleDbConnectString, 
                RdaBatchOption.BatchingOn);
        }
        catch(SqlCeException) {
            //Use you own Error Handling Routine.
        }
        finally {
            //Dispose of the RDA Object.
            rda.Dispose();
        }

[C++, JScript] Für C++ oder JScript ist kein Beispiel verfügbar. Klicken Sie zum Anzeigen eines Beispiels für Visual Basic oder C# in der linken oberen Ecke der Seite auf die Schaltfläche "Sprachfilter" Sprachfilter.

Anforderungen

Plattformen: .NET Compact Framework - Windows CE .NET

.NET Framework-Sicherheit:

Siehe auch

SqlCeRemoteDataAccess-Klasse | SqlCeRemoteDataAccess-Member | System.Data.SqlServerCe-Namespace | SqlCeRemoteDataAccess.Push-Überladungsliste