You are currently offline, waiting for your internet to reconnect

The DataAdapter.Fill method does not set all of the properties of the DataTable and DataColumn objects

This article was previously published under Q310373
This article refers to the following Microsoft .NET Framework Class Library namespace:
  • System.Data
After you use the DataAdapter.Fill method, various properties of the DataTable and DataColumn objects (such as primary keys, auto increment fields, nullable fields, unique indexes, and so on) are not set.
The DataAdapter object is optimized for read-only scenarios by default. The Fill method only retrieves the amount of schema that is necessary to display the data. You must take extra steps to obtain the additional schema that are necessary to update or validate an object.
To obtain additional information about the DataSet object, use one of the following methods:
  • Call the DataAdapter.FillSchema method to obtain extended schema information.
  • Set DataAdapter.MissingSchemaAction to MissingSchemaAction.AddWithKey before you call the Fill method.
For additional information about when to use the FillSchema method and MissingSchemaAction property, click the article number below to view the article in the Microsoft Knowledge Base:
310128 When to use FillSchema and MissingSchemaAction

Steps to reproduce the behavior

  1. Start Microsoft Visual Studio .NET.
  2. Create a new Windows Application project in Visual Basic .NET. Form1 is added to the project by default.
  3. Make sure that your project contains a reference to the System.Data namespace.
  4. Place a Button control and a DataGrid control on Form1.
  5. Change the Name property of the button to btnTest and the Text property to Test.
  6. Use the Imports statement on the System and System.Data namespaces so that you are not required to qualify declarations in those namespaces later in your code. Add the following code to the "General Declarations" section of Form1:
    Imports SystemImports System.Data.OleDbImports System.Data.SqlClient					
  7. Add the following code in the Code window after the "Windows Form Designer generated code" region:
        Private Sub btnTest_Click(ByVal sender As System.Object, _    ByVal e As System.EventArgs) Handles btnTest.Click        Dim myConnString As String = _                "User ID=sa;password=sa;Initial Catalog=Northwind;Data Source=myServer"        Dim ds As New DataSet()        Dim con As New SqlConnection(myConnString)        Dim daCust As New SqlDataAdapter("Select * From Customers", con)        'Uncomment either of the following two lines to obtain additional schema information.        'daCust.MissingSchemaAction = MissingSchemaAction.AddWithKey        'daCust.FillSchema(ds, SchemaType.Source, "Cust")        daCust.Fill(ds, "Cust")        DataGrid1.DataSource = ds        DataGrid1.DataMember = "Cust"        Dim colArr() As DataColumn        colArr = ds.Tables(0).PrimaryKey        If colArr.Length.ToString() = 0 Then            MessageBox.Show("No Primary Key is defined.")        End If        Dim i As Integer        For i = 0 To colArr.GetUpperBound(0)            MessageBox.Show("Primary Key : " & colArr(i).ColumnName)        Next i    End Sub					
  8. Modify the connection string (myConnString) as appropriate for your environment.
  9. Save your project. On the Debug menu, click Start to run your project.
  10. Click Test. Notice that you cannot retrieve the primary key information from the table.
  11. Uncomment the code to either set MissingSchemaAction or use FillSchema, and then click Test again. Notice that the primary key information is retrieved properly.
For more information on ADO.NET objects and syntax, see the following Microsoft .NET Framework Software Development Kit (SDK) documentation or MSDN Online:

Article ID: 310373 - Last Review: 05/13/2007 05:02:03 - Revision: 2.7

Microsoft ADO.NET 2.0, Microsoft ADO.NET (included with the .NET Framework), Microsoft Visual Basic .NET 2002 Standard Edition, Microsoft Visual Basic .NET 2003 Standard Edition, Microsoft Visual Basic 2005

  • kbtshoot kbprb kbsqlclient kbsystemdata KB310373
y>display: none; " src="">ar varClickTracking = 1; var varCustomerTracking = 1; var Route = "76500"; var Ctrl = ""; document.write(" d=1&t=">//">