DataSet column mapping throws an InvalidOperationException exception when the specified column is missing in ADO.NET (307170)



The information in this article applies to:

  • Microsoft ADO.Net 2.0
  • Microsoft ADO.NET (included with the .NET Framework)
  • Microsoft Visual Basic .NET (2002)
  • Microsoft .NET Framework
  • Microsoft .NET Framework 2.0
  • Microsoft Visual Basic .NET (2003)
  • Microsoft Visual Basic 2005

This article was previously published under Q307170
For a Microsoft Visual C# .NET version of this article, see 307989.

This article refers to the following Microsoft .NET Framework Class Library namespaces:
  • System.Data

SYMPTOMS

When you use DataSet column mapping in ADO.NET, an InvalidOperationException exception is thrown if the MissingMappingAction property is set to Error and the column mapping that you specify is missing.

RESOLUTION

To resolve this problem, ensure that the column mapping that you specify exists. Refer to the "More Information" section for code that checks whether the specified column mapping exists.

MORE INFORMATION

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, and add a reference to this namespace if it does not.
  4. Place a Button control on Form1, and change its Name property to btnTest.
  5. Use the Imports statement on the System, System.Data, System.Data.Common, and System.Data.OleDb namespaces so that you are not required to qualify declarations in those namespaces later in your code.
    Imports System
    Imports System.Data
    Imports System.Data.Common
    Imports System.Data.OleDb
    					
  6. Paste 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 myDataAdapter As New OleDbDataAdapter()
            myDataAdapter.TableMappings.Add("Categories", "DataCategories")
    
            Dim myMessage As String = "Table Mappings:" + ControlChars.Cr
            Dim i As Integer
            For i = 0 To myDataAdapter.TableMappings.Count - 1
                myMessage += i.ToString() + " " _
                   + myDataAdapter.TableMappings(i).ToString() + ControlChars.Cr
            Next i
            MessageBox.Show(myMessage)
    
            Dim myNewMapping As New DataTableMapping()
    
            'Uncomment the if loop to check if the column mapping that you specify exists.
            'If myDataAdapter.TableMappings.Contains("Categories1") Then
                myNewMapping = DataTableMappingCollection.GetTableMappingBySchemaAction _
                   (myDataAdapter.TableMappings, "Categories1", "", MissingMappingAction.Error)
            'End If
        End Sub
    					
  7. Save your project. On the Debug menu, click Start, and then run your project.
  8. Click the button. You receive the above-mentioned exception.
  9. To resolve this problem, uncomment the "if" loop in the preceding sample code, and then run the project again. Because the "if" loop checks whether the specified column mapping exists, you no longer receive the exception.

REFERENCES

For more information on ADO.NET objects and syntax, refer to the following Microsoft .NET Framework Software Development Kit (SDK) documentation:

Modification Type:MinorLast Reviewed:10/3/2006
Keywords:kbtshoot kberrmsg kbnofix kbprb kbreadme kbSystemData KB307170 kbAudDeveloper