OleDbError Class

OleDbError Class

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 OleDbError Members.

System.Object
   System.Data.OleDb.OleDbError

[Visual Basic]
<Serializable>
NotInheritable Public Class OleDbError
[C#]
[Serializable]
public sealed class OleDbError
[C++]
[Serializable]
public __gc __sealed class OleDbError
[JScript]
public
   Serializable
class OleDbError

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 OleDb data adapter when an error occurs. An instance of OleDbError is created and managed by the OleDbErrorCollection class, which in turn is created by the OleDbException class.

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

Example

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

[Visual Basic] 
Public Sub DisplayOleDbErrorCollection(myException As OleDbException)
    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 DisplayOleDbErrorCollection(OleDbException 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 DisplayOleDbErrorCollection(OleDbException* myException) 
 {
    for (int i=0; i < myException->Errors->Count; i++)
    {
       MessageBox::Show(String::Concat(
          String::Format( S"Index #{0}\nMessage: {1}\nNative: {2}\nSource:",
              __box(i),
              myException->Errors->Item[i]->Message,
              myException->Errors->Item[i]->NativeError.ToString() ),
          String::Format( S"{0}\nSQL: {1}\n",
              myException->Errors->Item[i]->Source, 
              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.

Requirements

Namespace: System.Data.OleDb

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

OleDbError Members | System.Data.OleDb Namespace | OleDbErrorCollection | OleDbException

Show:
© 2016 Microsoft