Export (0) Print
Expand All

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.

System.Object
   System.Data.Odbc.OdbcError

[Visual Basic]
<Serializable>
NotInheritable Public Class OdbcError
[C#]
[Serializable]
public sealed class OdbcError
[C++]
[Serializable]
public __gc __sealed class OdbcError
[JScript]
public
   Serializable
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.

Remarks

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.

Example

[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

[C#] 
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");
   }
}

[C++] 
public:
    void DisplayOdbcErrorCollection(OdbcException* myException)
    {
        for (int i=0; i < myException->Errors->Count; i++)
        {
            MessageBox::Show(String::Concat(
                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, 
                S"\n"));
        }
    };

[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.

Requirements

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

Show:
© 2015 Microsoft