This documentation is archived and is not being maintained.

OdbcError Class

Note: This namespace, class, or member is supported only in version 1.1 of the .NET Framework.

Collects information relevant to a warning or error returned by the data source. This class cannot be inherited.

For a list of all members of this type, see OdbcError Members.


[Visual Basic]
NotInheritable Public Class OdbcError
public sealed class OdbcError
public __gc __sealed class OdbcError
class OdbcError

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.


This class is created by the OdbcDataAdapter whenever an error occurs. Each instance of OdbcError created by the OdbcDataAdapter is then managed by the OdbcErrorCollection class, which in turn is created by the OdbcException class.

If the severity of the error is too great, the server may close the OdbcConnection. However, the user can reopen the connection and continue.


[Visual Basic, C#, C++] The following example displays the properties of the OdbcError.

[Visual Basic] 
Public Sub DisplayOdbcErrorCollection(myException As OdbcException)
    Dim i As Integer
    For i = 0 To myException.Errors.Count - 1
        MessageBox.Show("Index #" + i.ToString() + ControlChars.Cr _
           + "Message: " + myException.Errors(i).Message + ControlChars.Cr _
           + "Native: " + myException.Errors(i).NativeError.ToString() + ControlChars.Cr _
           + "Source: " + myException.Errors(i).Source + ControlChars.Cr _
           + "SQL: " + myException.Errors(i).SQLState + ControlChars.Cr)
    Next i
End Sub

public void DisplayOdbcErrorCollection(OdbcException myException) 
   for (int i=0; i < myException.Errors.Count; i++)
      MessageBox.Show("Index #" + i + "\n" +
             "Message: " + myException.Errors[i].Message + "\n" +
             "Native: " + myException.Errors[i].NativeError.ToString() + "\n" +
             "Source: " + myException.Errors[i].Source + "\n" +
             "SQL: " + myException.Errors[i].SQLState + "\n");

    void DisplayOdbcErrorCollection(OdbcException* myException)
        for (int i=0; i < myException->Errors->Count; i++)
                S"Index # ", __box(i), 
                S"\n Message: ", myException->Errors->Item[i]->Message, 
                S"\n Native: ", myException->Errors->Item[i]->NativeError, 
                S"\n Source: ", myException->Errors->Item[i]->Source, 
                S"\n SQL: ", myException->Errors->Item[i]->SQLState, 

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.


Namespace: System.Data.Odbc

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

Assembly: System.Data (in System.Data.dll)

See Also

OdbcError Members | System.Data.Odbc Namespace | OdbcErrorCollection | OdbcException