SqlCeRemoteDataAccess Class

Artigo
01/14/2011

Inicializa uma nova instância do objeto SqlCeRemoteDataAccess. Para obter mais informações sobre RDA, consulte Usando o RDA.

Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (em system.data.sqlserverce.dll)

Sintaxe

'Declaração
Public NotInheritable Class SqlCeRemoteDataAccess
    Implements IDisposable

public sealed class SqlCeRemoteDataAccess : IDisposable

public ref class SqlCeRemoteDataAccess sealed : IDisposable

public final class SqlCeRemoteDataAccess implements IDisposable

public final class SqlCeRemoteDataAccess implements IDisposable

Comentários

Atualmente, o SQL Server Compact 3.5 não está otimizado para servir como um banco de dados de sites. Por padrão, as conexões de aplicativos conectados ao ASP.NET são bloqueadas no SQL Server Compact 3.5. O SQL Server Compact 3.5 é otimizado para uso como um banco de dados incorporado em aplicativos. A utilização do SQL Server Compact 3.5 como banco de dados de sites exige o suporte para vários usuários e alterações de dados simultâneas. Isso pode causar problemas de desempenho. Portanto, não há suporte para esses cenários. Outras versões do SQL Server, incluindo o SQL Server 2005 Express Edition e versões posteriores, são otimizadas para servir como um banco de dados de sites.

O SQL Server Compact 3.5 pode ser usado com o ASP.NET em cenários de aplicativos nos quais o ASP.NET é usado para criar bancos de dados do SQL Server Compact 3.5 para cenários de sincronização. Use o código a seguir de forma a alterar o comportamento padrão do SQL Server Compact 3.5 para trabalhar no ASP.NET.

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

Hierarquia de herança

System.Object
System.Data.SqlServerCe.SqlCeRemoteDataAccess

Exemplo

O exemplo a seguir mostra como inicializar uma nova instância do objeto SqlCeRemoteDataAccess.

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

Segurança de thread

Quaisquer membros estáticos públicos (compartilhados no Microsoft Visual Basic) desse tipo são thread safe. Não há garantia de que qualquer membro de instância seja thread safe.

Plataformas

Plataformas de desenvolvimento

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
Informações de versão
.NET Framework e NET Compact Framework
Com suporte no 3.5
.NET Framework
Com suporte no 3.0
.NET Compact Framework e .Net Framework
Com suporte no 2.0

Consulte também

Referência

SqlCeRemoteDataAccess Members
System.Data.SqlServerCe Namespace

Compartilhar via