ADO.NET Provider for API

Build 24.0.9060

Querying with the DataAdapter

The CData ADO.NET Provider for API implements two ADO.NET interfaces you can use to retrieve data from API: APIDataAdapter and APIDataReader objects. Whereas APIDataAdapter objects retrieve a single result set of all the data that matches a query, APIDataReader objects fetch data in subset increments as needed.

Using the APIDataAdapter

Use the adapter's Fill method to retrieve data from the data source. An empty DataTable instance is passed as an argument to the Fill method. When the method returns, the DataTable instance is populated with the queried data. Note that the APIDataAdapter is slower than the APIDataReader because the Fill method needs to retrieve all data from the data source before returning.

The following example selects the Email and Username columns of the NorthwindOData table:

C#

string connectionString = "Profile=<Path to Profile>;ProfileSettings=<Profile Configuration Settings>";

using (APIConnection connection = new APIConnection(connectionString)) {
  APIDataAdapter dataAdapter = new APIDataAdapter(
  "SELECT Email, Username FROM NorthwindOData", connection);

  DataTable table = new DataTable();
  dataAdapter.Fill(table);

  Console.WriteLine("Contents of NorthwindOData.");

  foreach (DataRow row in table.Rows) {
    Console.WriteLine("{0}: {1}", row["Email"], row["Username"]);
  }
}

VB.NET

Dim connectionString As String = "Profile=<Path to Profile>;ProfileSettings=<Profile Configuration Settings>"

Using connection As New APIConnection(connectionString)
  Dim dataAdapter As New APIDataAdapter("SELECT Email, Username FROM NorthwindOData", connection)

  Dim table As New DataTable()
  dataAdapter.Fill(table)

  Console.WriteLine("Contents of NorthwindOData.")

  For Each row As DataRow In table.Rows
    Console.WriteLine("{0}: {1}", row("Email"), row("Username"))
  Next
End Using

Copyright (c) 2024 CData Software, Inc. - All rights reserved.
Build 24.0.9060