SqlCeRemoteDataAccess-Klasse

Artikel
01/17/2011

Initialisiert eine neue Instanz des SqlCeRemoteDataAccess-Objekts. Weitere Informationen zum Remotedatenzugriff finden Sie unter Verwenden des Remotedatenzugriffs.

Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)

Syntax

'Declaration
Public NotInheritable Class SqlCeRemoteDataAccess _
    Implements IDisposable
'Usage
Dim instance As SqlCeRemoteDataAccess

public sealed class SqlCeRemoteDataAccess : IDisposable

public ref class SqlCeRemoteDataAccess sealed : IDisposable

[<SealedAttribute>]
type SqlCeRemoteDataAccess =  
    class
        interface IDisposable
    end

public final class SqlCeRemoteDataAccess implements IDisposable

Hinweise

SQL Server Compact 3.5 wird derzeit nicht für die Verwendung als Datenbank für Websites optimiert. Standardmäßig werden Verbindungen von Anwendungen, die mit ASP.NET verbunden sind, in SQL Server Compact 3.5 blockiert. SQL Server Compact 3.5 wurde für die Verwendung als eingebettete Datenbank in Anwendungen optimiert. Die Verwendung von SQL Server Compact 3.5 als Datenbank für Websites erfordert die Unterstützung von mehreren Benutzern und gleichzeitigen Datenänderungen. Dies kann Leistungsprobleme verursachen. Deshalb werden diese Szenarios nicht unterstützt. Andere Editionen von SQL Server, einschließlich SQL Server 2005 Express Edition und höher, wurden für die Verwendung als Datenbank für Websites optimiert.

SQL Server Compact 3.5 kann zusammen mit ASP.NET in Anwendungsszenarios verwendet werden, in denen ASP.NET für das Erstellen von SQL Server Compact 3.5-Datenbanken für die Synchronisierung verwendet wird. Verwenden Sie den folgenden Code, um das Standardverhalten von SQL Server Compact 3.5 zu ändern, damit diese Edition in ASP.NET verwendet werden kann.

AppDomain.CurrentDomain.SetData("SQLServerCompactEditionUnderWebHosting", true)

Beispiele

Im folgenden Beispiel wird das Initialisieren einer neuen Instanz des SqlCeRemoteDataAccess-Objekts veranschaulicht.

' 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 Pull Operation
    '
    rda = New SqlCeRemoteDataAccess( _
        "https://www.adventure-works.com/sqlmobile/sqlcesa35.dll", _
        "MyLogin", _
        "<password>", _
        "Data Source=MyDatabase.sdf")

    rda.Pull("Employees", "SELECT * FROM DimEmployee", rdaOleDbConnectString, _
        RdaTrackOption.TrackingOnWithIndexes, "ErrorTable")

    ' or, try one of these overloads:
    ' rda.Pull("Employees", "SELECT * FROM DimEmployee", rdaOleDbConnectString, _
    '     RdaTrackOption.TrackingOnWithIndexes)
    '
    ' rda.Pull("Employees", "SELECT * FROM DimEmployee", 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 Pull Operation
    //
    rda = new SqlCeRemoteDataAccess(
        "https://www.adventure-works.com/sqlmobile/sqlcesa35.dll",
        "MyLogin",
        "<password>",
        "Data Source=MyDatabase.sdf");

    rda.Pull("Employees", "SELECT * FROM DimEmployee", rdaOleDbConnectString,
        RdaTrackOption.TrackingOnWithIndexes, "ErrorTable");

    // or, try one of these overloads:
    //
    // rda.Pull("Employees", "SELECT * FROM DimEmployee", rdaOleDbConnectString,
    //     RdaTrackOption.TrackingOnWithIndexes);
    //
    // rda.Pull("Employees", "SELECT * FROM DimEmployee", rdaOleDbConnectString);
}
catch (SqlCeException)
{
    // Handle errors here
    //
}
finally
{
    // Dispose of the RDA object
    //
    rda.Dispose();
}

Vererbungshierarchie

System. . :: . .Object
System.Data.SqlServerCe..::..SqlCeRemoteDataAccess

Threadsicherheit

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Siehe auch

Verweis

SqlCeRemoteDataAccess-Member

System.Data.SqlServerCe-Namespace

Freigeben über