The CData ADO.NET Provider for Microsoft Dynamics 365 Business Central implements two ADO.NET interfaces you can use to retrieve data from Microsoft Dynamics 365 Business Central: D365BusinessCentralDataAdapter and D365BusinessCentralDataReader objects. Whereas D365BusinessCentralDataAdapter objects retrieve a single result set of all the data that matches a query, D365BusinessCentralDataReader objects fetch data in subset increments as needed.

Using the D365BusinessCentralDataAdapter

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 D365BusinessCentralDataAdapter is slower than the D365BusinessCentralDataReader because the Fill method needs to retrieve all data from the data source before returning.

The following example selects the accountid and Name columns of the Accounts table:

C#

string connectionString = "InitiateOAuth=GETANDREFRESH;OrganizationUrl=https://api.businesscentral.dynamics.com/v1.0/api/v1.0";

using (D365BusinessCentralConnection connection = new D365BusinessCentralConnection(connectionString)) {
  D365BusinessCentralDataAdapter dataAdapter = new D365BusinessCentralDataAdapter(
  "SELECT accountid, Name FROM Accounts", connection);

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

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

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

VB.NET

Dim connectionString As String = "InitiateOAuth=GETANDREFRESH;OrganizationUrl=https://api.businesscentral.dynamics.com/v1.0/api/v1.0"

Using connection As New D365BusinessCentralConnection(connectionString)
  Dim dataAdapter As New D365BusinessCentralDataAdapter("SELECT accountid, Name FROM Accounts", connection)

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

  Console.WriteLine("Contents of Accounts.")

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