IDbDataAdapter.SelectCommand-Eigenschaft

Ruft eine SQL-Anweisung ab, mit der Datensätze in der Datenquelle ausgewählt werden, oder legt diese fest.

Namespace: System.Data
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Property SelectCommand As IDbCommand
'Usage
Dim instance As IDbDataAdapter
Dim value As IDbCommand

value = instance.SelectCommand

instance.SelectCommand = value

IDbCommand SelectCommand { get; set; }

property IDbCommand^ SelectCommand {
    IDbCommand^ get ();
    void set (IDbCommand^ value);
}

/** @property */
IDbCommand get_SelectCommand ()

/** @property */
void set_SelectCommand (IDbCommand value)

function get SelectCommand () : IDbCommand

function set SelectCommand (value : IDbCommand)

Eigenschaftenwert

Ein IDbCommand, der während der Ausführung von Update verwendet wird, um Datensätze aus der Datenquelle zur Platzierung im Dataset auszuwählen.

Hinweise

Wenn SelectCommand einem zuvor erstellten IDbCommand zugeordnet wird, wird IDbCommand nicht geklont. Der SelectCommand verwaltet einen Verweis auf das zuvor erstellte IDbCommand-Objekt.

Wenn der SelectCommand keine Zeilen zurückgibt, werden DataSet keine Tabellen hinzugefügt, und es wird keine Ausnahme ausgelöst.

Beispiel

Im folgenden Beispiel wird eine Instanz der vererbten OleDbDataAdapter-Klasse erstellt, und die SelectCommand-Eigenschaft sowie die InsertCommand-Eigenschaft werden festgelegt. Es wird davon ausgegangen, dass bereits ein OleDbConnection-Objekt erstellt wurde.

Public Shared Function CreateCustomerAdapter( _
    connection As OleDbConnection) As OleDbDataAdapter 

    Dim adapter As OleDbDataAdapter = New OleDbDataAdapter()
    Dim command As OleDbCommand

    ' Create the SelectCommand.
    command = New OleDbCommand("SELECT * FROM Customers " & _
        "WHERE Country = ? AND City = ?", connection)

    command.Parameters.Add("Country", OleDbType.VarChar, 15)
    command.Parameters.Add("City", OleDbType.VarChar, 15)

    adapter.SelectCommand = command

    ' Create the InsertCommand.
    command = New OleDbCommand( _
        "INSERT INTO Customers (CustomerID, CompanyName) " & _
        "VALUES (?, ?)", connection)

    command.Parameters.Add( _
        "CustomerID", OleDbType.Char, 5, "CustomerID")
    command.Parameters.Add( _
        "CompanyName", OleDbType.VarChar, 40, "CompanyName")

    adapter.InsertCommand = command
    Return adapter
End Function

public static OleDbDataAdapter CreateCustomerAdapter(
    OleDbConnection connection)
{
    OleDbDataAdapter adapter = new OleDbDataAdapter();
    OleDbCommand command;

    // Create the SelectCommand.
    command = new OleDbCommand("SELECT * FROM Customers " +
        "WHERE Country = ? AND City = ?", connection);

    command.Parameters.Add("Country", OleDbType.VarChar, 15);
    command.Parameters.Add("City", OleDbType.VarChar, 15);

    adapter.SelectCommand = command;

    // Create the InsertCommand.
    command = new OleDbCommand(
        "INSERT INTO Customers (CustomerID, CompanyName) " +
        "VALUES (?, ?)", connection);

    command.Parameters.Add(
        "CustomerID", OleDbType.Char, 5, "CustomerID");
    command.Parameters.Add(
        "CompanyName", OleDbType.VarChar, 40, "CompanyName");

    adapter.InsertCommand = command;
    return adapter;
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

IDbDataAdapter-Schnittstelle
IDbDataAdapter-Member
System.Data-Namespace