SqlCeDataAdapter-Klasse
Stellt einen Satz von Datenbefehlen und eine Datenbankverbindung dar, die zum Füllen des DataSet und zum Aktualisieren der Datenquelle verwendet werden.
Namespace: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)
Syntax
'Declaration
Public NotInheritable Class SqlCeDataAdapter _
Inherits DbDataAdapter _
Implements ICloneable
'Usage
Dim instance As SqlCeDataAdapter
public sealed class SqlCeDataAdapter : DbDataAdapter,
ICloneable
public ref class SqlCeDataAdapter sealed : public DbDataAdapter,
ICloneable
[<SealedAttribute>]
type SqlCeDataAdapter =
class
inherit DbDataAdapter
interface ICloneable
end
public final class SqlCeDataAdapter extends DbDataAdapter implements ICloneable
Hinweise
Die SqlCeDataAdapter-Klasse fungiert als Brücke zwischen einer DataSet-Klasse und einer Datenquelle. Sie wird zum Abrufen von Daten aus und zum Speichern von Daten in der Datenquelle verwendet. Die SqlCeDataAdapter-Klasse stellt diese Verbindung bereit, indem mit der Fill-Methode Daten aus der Datenquelle in die DataSet-Klasse geladen und in der DataSet-Klasse vorgenommene Änderungen mit der Update-Methode zurück an die Datenquelle gesendet werden.
Wenn die SqlCeDataAdapter-Klasse eine DataSet-Klasse füllt, erstellt sie die für die zurückgegebenen Daten erforderlichen Tabellen und Spalten, sofern diese nicht bereits vorhanden sind. Primärschlüsselinformationen sind jedoch in dem implizit erstellten Schema nur enthalten, wenn die MissingSchemaAction-Eigenschaft auf AddWithKey festgelegt ist. Das Schema der DataSet-Klasse kann, einschließlich der Primärschlüsselinformationen, auch durch die SqlCeDataAdapter-Klasse erstellt werden, bevor es unter Verwendung der FillSchema-Methode mit Daten gefüllt wird.
Die SqlCeDataAdapter-Klasse enthält außerdem die Eigenschaften SelectCommand, InsertCommand, DeleteCommand, UpdateCommand und TableMappings für das Laden und Aktualisieren von Daten.
Wenn Sie eine Instanz der SqlCeDataAdapter-Klasse erstellen, werden die Eigenschaften auf die Anfangswerte festgelegt. Eine Liste dieser Werte finden Sie unter dem SqlCeDataAdapter-Konstruktor.
Beispiele
Im folgenden Beispiel werden die Klassen SqlCeCommand, SqlCeDataAdapter und SqlCeConnection verwendet, um Datensätze aus einer Datenbank auszuwählen und eine DataSet-Klasse mit den ausgewählten Zeilen zu füllen. Anschließend wird die gefüllte DataSet-Klasse zurückgegeben. Dafür werden der Methode ein initialisiertes DataSet, eine Verbindungszeichenfolge und eine Abfragezeichenfolge übergeben, die eine SQL-SELECT-Anweisung darstellt.
Try
Dim strDataSource As String
strDataSource = "" & _
"Data Source = C:\Program Files\" & _
"Microsoft SQL Server Compact Edition\v3.5\Samples\" & _
"Northwind.sdf"
Dim conn As New SqlCeConnection
conn.ConnectionString = strDataSource & ";Password='<password>'"
Dim selectCmd As SqlCeCommand = conn.CreateCommand
selectCmd.CommandText = "SELECT * FROM Employees"
Dim adp As New SqlCeDataAdapter(selectCmd)
Dim ds As New DataSet
' Note: Fill will leave the connection in its original state;
' In this case, the connection was closed so it will be left closed
adp.Fill(ds)
Console.WriteLine(("The SqlCeDataAdapter succesfully filled " & _
ds.Tables.Item(0).Rows.Count & " rows in the DataSet!"))
Catch ds As Exception
Console.WriteLine(ds.Message)
Finally
Console.WriteLine(vbNewLine & vbNewLine & vbNewLine & _
"Press any key to continue...")
Console.ReadKey()
End Try
try
{
string strDataSource =
@"Data Source = C:\Program Files\" +
@"Microsoft SQL Server Compact Edition\v3.5\Samples\" +
@"Northwind.sdf";
SqlCeConnection conn = new SqlCeConnection();
conn.ConnectionString = strDataSource + ";Password='<password>'";
SqlCeCommand selectCmd = conn.CreateCommand();
selectCmd.CommandText = "SELECT * FROM Employees";
SqlCeDataAdapter adp = new SqlCeDataAdapter(selectCmd);
DataSet ds = new DataSet();
// Note: Fill will leave the connection in its original state;
// In this case, the connection was closed so it will be left closed
//
adp.Fill(ds);
Console.WriteLine("The SqlCeDataAdapter succesfully filled " +
ds.Tables[0].Rows.Count + " rows in the DataSet!");
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
finally
{
Console.WriteLine("\n\n\nPress any key to continue...");
Console.ReadKey();
}
Vererbungshierarchie
System. . :: . .Object
System. . :: . .MarshalByRefObject
System.ComponentModel. . :: . .Component
System.Data.Common. . :: . .DataAdapter
System.Data.Common. . :: . .DbDataAdapter
System.Data.SqlServerCe..::..SqlCeDataAdapter
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.