SqlCeRemoteDataAccess.Pull-Methode (String, String, String, RdaTrackOption, String)

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

Extrahiert Daten aus einer SQL Server-Datenbank und speichert sie in einer Tabelle einer SQL Server CE-Datenbank.

Overloads Public Sub Pull( _
   ByVal localTableName As String, _   ByVal sqlSelectString As String, _   ByVal oledbConnectionString As String, _   ByVal trackOption As RdaTrackOption, _   ByVal errorTable As String _)
[C#]
public void Pull(stringlocalTableName,stringsqlSelectString,stringoledbConnectionString,RdaTrackOptiontrackOption,stringerrorTable);
[C++]
public: void Pull(String* localTableName,String* sqlSelectString,String* oledbConnectionString,RdaTrackOptiontrackOption,String* errorTable);
[JScript]
public function Pull(
   localTableName : String,sqlSelectString : String,oledbConnectionString : String,trackOption : RdaTrackOption,errorTable : 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.
• sqlSelectString
  Jede gültige Transact-SQL-Anweisung, einschließlich SELECT-Anweisungen und gespeicherter Prozeduren, die angibt, welche Tabellen, Spalten und Datensätze aus der SQL Server-Datenbank zum Speichern in der SQL Server CE-Datenbank extrahiert werden.
• oledbConnectionString
  Die beim Herstellen einer Verbindung mit der SQL Server-Datenbank verwendete OLE DB-Verbindungszeichenfolge.
• trackOption
  Diese Option gibt an, ob SQL Server CE Änderungen an der abgerufenen Tabelle verfolgt und ob die Indizes in der abgerufenen Tabelle mit den PRIMARY KEY-Einschränkungen an das Gerät übermittelt werden.
• errorTable
  Der Name der lokalen Fehlertabelle, die beim Auftreten eines Fehlers erstellt wird, wenn später die Push-Methode zum Zurücksenden von Änderungen an den Server aufgerufen wird. Diese Option kann nur angegeben werden, wenn der RdaTrackOption-Wert TrackingOn oder TrackingOnWithIndexes ist.

Hinweise

Wenn das virtuelle Verzeichnis, das den SQL Server CE Server-Agent enthält, für die Standardauthentifizierung oder die integrierte Windows-Authentifizierung konfiguriert ist, müssen die InternetLogin-Eigenschaft und die InternetPassword-Eigenschaft angegeben werden. sqlSelectString steuert, welche Daten aus der SQL Server-Tabelle abgerufen werden. Wenn das resultierende Recordset einen nicht unterstützten Datentyp enthält, z. B. timestamp, tritt ein Fehler auf. sqlSelectString kann eine WHERE-Klausel angeben, um zu steuern, welche Datensätze zurückgegeben werden. Beispielsweise werden mit SELECT * FROM Customers WHERE

State='CA' ausschließlich Kunden abgerufen, die in Kalifornien leben. sqlSelectString unterstützt auch gespeicherte Prozeduren oder Sichten, die Zeilen zurückgeben. Bei Verwendung der TrackingOff-Option können auch ausgewählte Tabellen aus mehreren Tabellen in eine einzelne Tabelle übertragen 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.

Weitere Informationen über Datenzugriff und Einschränkungen finden Sie in der SQL Server CE-Onlinedokumentation unter "Supported Data Types and Data Type Mappings" und unter "RDA Limitations" (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.Pull("Employees", "Select * from Employees", _
       rdaOleDbConnectString, _
       RdaTrackOption.TrackingOnWithIndexes, _
       "ErrorTable")

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.Pull(
                "Employees", 
                "Select * from Employees", 
                rdaOleDbConnectString, 
                RdaTrackOption.TrackingOnWithIndexes , 
                "ErrorTable");
        }
        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" .

Anforderungen

Plattformen: .NET Compact Framework - Windows CE .NET

.NET Framework-Sicherheit:

• Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

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