SqlCeRemoteDataAccess Class

Inizializza una nuova istanza dell'oggetto SqlCeRemoteDataAccess. Per ulteriori informazioni sulla funzionalità RDA, vedere Utilizzo di RDA (Remote Data Access).

Spazio dei nomi: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in system.data.sqlserverce.dll)

Sintassi

'Dichiarazione
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

Osservazioni

SQL Server Compact 3.5 non è attualmente ottimizzato per essere utilizzato come database per siti Web. Per impostazione predefinita, in SQL Server Compact 3.5 le connessioni da applicazioni collegate a ASP.NET vengono bloccate. SQL Server Compact 3.5 è ottimizzato per essere utilizzato come database incorporato all'interno di applicazioni. Per utilizzare SQL Server Compact 3.5 come database per siti Web, è necessario il supporto per più utenti e per le modifiche simultanee dei dati. Tale situazione può causare problemi di prestazioni, pertanto questi scenari non sono supportati. Altre edizioni di SQL Server, ad esempio SQL Server 2005 Express Edition e le versioni successive, sono ottimizzate per essere utilizzate come database per siti Web.

SQL Server Compact 3.5 può essere utilizzato con ASP.NET in scenari applicativi in cui ASP.NET viene utilizzato per creare database di SQL Server Compact 3.5 per scenari di sincronizzazione. Per modificare il comportamento predefinito di SQL Server Compact 3.5 in modo che sia in grado di funzionare con ASP.NET, utilizzare il codice riportato di seguito.

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

Gerarchia di ereditarietà

System.Object
  System.Data.SqlServerCe.SqlCeRemoteDataAccess

Esempio

Nell'esempio riportato di seguito viene illustrato come inizializzare una nuova istanza dell'oggetto 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();
}

Affidabilità

Tutti i membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono affidabili. Non è invece garantita l'affidabilità dei membri dell'istanza.

Piattaforme

Piattaforme di sviluppo

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
Informazioni sulla versione
.NET Framework e .NET Compact Framework
Supportato in 3.5
.NET Framework
Supportato in 3.0
.NET Compact Framework e .NET Framework
Supportato in 2.0

Vedere anche

Riferimento

SqlCeRemoteDataAccess Members
System.Data.SqlServerCe Namespace