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

Using the SalesforceDataAdapter

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

The following example selects the BillingState and Name columns of the Account table:

C#

string connectionString = "AuthScheme=Basic;User=myUser;Password=myPassword;Security Token=myToken;";

using (SalesforceConnection connection = new SalesforceConnection(connectionString)) {
  SalesforceDataAdapter dataAdapter = new SalesforceDataAdapter(
  "SELECT BillingState, Name FROM Account", connection);

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

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

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

VB.NET

Dim connectionString As String = "AuthScheme=Basic;User=myUser;Password=myPassword;Security Token=myToken;"

Using connection As New SalesforceConnection(connectionString)
  Dim dataAdapter As New SalesforceDataAdapter("SELECT BillingState, Name FROM Account", connection)

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

  Console.WriteLine("Contents of Account.")

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