OleDbException Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Exception levée lorsque le fournisseur sous-jacent retourne un avertissement ou une erreur pour une source de données OLE DB. Cette classe ne peut pas être héritée.
public ref class OleDbException sealed : System::Runtime::InteropServices::ExternalExceptionpublic ref class OleDbException sealed : System::Data::Common::DbException[System.Serializable]
public sealed class OleDbException : System.Runtime.InteropServices.ExternalException[System.Serializable]
public sealed class OleDbException : System.Data.Common.DbException[<System.Serializable>]
type OleDbException = class
inherit ExternalException[<System.Serializable>]
type OleDbException = class
inherit DbExceptionPublic NotInheritable Class OleDbException
Inherits ExternalExceptionPublic NotInheritable Class OleDbException
Inherits DbException- Héritage
- Héritage
- Attributs
Exemples
L’exemple suivant génère une OleDbException source de données manquante, puis affiche l’exception.
public void ShowOleDbException()
{
string mySelectQuery = "SELECT column1 FROM table1";
OleDbConnection myConnection =
new OleDbConnection("Provider=Microsoft.Jet.OLEDB.4.0;DataSource=");
OleDbCommand myCommand = new OleDbCommand(mySelectQuery,myConnection);
try
{
myCommand.Connection.Open();
}
catch (OleDbException e)
{
string errorMessages = "";
for (int i=0; i < e.Errors.Count; i++)
{
errorMessages += "Index #" + i + "\n" +
"Message: " + e.Errors[i].Message + "\n" +
"NativeError: " + e.Errors[i].NativeError + "\n" +
"Source: " + e.Errors[i].Source + "\n" +
"SQLState: " + e.Errors[i].SQLState + "\n";
}
System.Diagnostics.EventLog log = new System.Diagnostics.EventLog();
log.Source = "My Application";
log.WriteEntry(errorMessages);
Console.WriteLine("An exception occurred. Please contact your system administrator.");
}
}
Public Sub ShowOleDbException()
Dim mySelectQuery As String = "SELECT column1 FROM table1"
Dim myConnection As New OleDbConnection _
("Provider=Microsoft.Jet.OLEDB.4.0;DataSource=")
Dim myCommand As New OleDbCommand(mySelectQuery, myConnection)
Try
myCommand.Connection.Open()
Catch e As OleDbException
Dim errorMessages As String
Dim i As Integer
For i = 0 To e.Errors.Count - 1
errorMessages += "Index #" & i.ToString() & ControlChars.Cr _
& "Message: " & e.Errors(i).Message & ControlChars.Cr _
& "NativeError: " & e.Errors(i).NativeError & ControlChars.Cr _
& "Source: " & e.Errors(i).Source & ControlChars.Cr _
& "SQLState: " & e.Errors(i).SQLState & ControlChars.Cr
Next i
Dim log As New System.Diagnostics.EventLog()
log.Source = "My Application"
log.WriteEntry(errorMessages)
Console.WriteLine("An exception occurred. Please contact your system administrator.")
End Try
End Sub
Remarques
Cette classe est créée chaque fois que le Fournisseur de données .NET Framework pour OLE DB rencontre une erreur générée à partir du serveur. (Les erreurs côté client sont levées en tant qu’exceptions standard du Common Language Runtime.) OleDbException contient toujours au moins une instance de OleDbError.
Si la gravité de l’erreur est trop grande, le serveur peut fermer le OleDbConnection. Toutefois, l’utilisateur peut rouvrir la connexion et continuer.
Pour obtenir des informations générales sur la gestion des exceptions pour un fournisseur de données .NET Framework, consultez SqlException.
Propriétés
| Nom | Description |
|---|---|
| Data |
Obtient une collection de paires clé/valeur qui fournissent des informations supplémentaires définies par l’utilisateur sur l’exception. (Hérité de Exception) |
| ErrorCode |
Obtient le HRESULT de l’erreur. |
| Errors |
Obtient une collection d’un ou plusieurs objets OleDbError qui fournissent des informations détaillées sur les exceptions générées par le Fournisseur de données .NET Framework pour OLE DB. |
| HelpLink |
Obtient ou définit un lien vers le fichier d’aide associé à cette exception. (Hérité de Exception) |
| HResult |
Obtient ou définit HRESULT, valeur numérique codée affectée à une exception spécifique. (Hérité de Exception) |
| InnerException |
Obtient l’instance Exception qui a provoqué l’exception actuelle. (Hérité de Exception) |
| Message |
Obtient le texte décrivant l’erreur. |
| Message |
Obtient un message qui décrit l’exception actuelle. (Hérité de Exception) |
| Source |
Obtient le nom du fournisseur OLE DB qui a généré l’erreur. |
| Source |
Obtient ou définit le nom de l’application ou de l’objet qui provoque l’erreur. (Hérité de Exception) |
| StackTrace |
Obtient une représentation sous forme de chaîne des images immédiates sur la pile des appels. (Hérité de Exception) |
| TargetSite |
Obtient la méthode qui lève l’exception actuelle. (Hérité de Exception) |
Méthodes
| Nom | Description |
|---|---|
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| GetBaseException() |
En cas de substitution dans une classe dérivée, retourne la Exception qui est la cause racine d’une ou plusieurs exceptions ultérieures. (Hérité de Exception) |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
Ce membre remplace GetObjectData(SerializationInfo, StreamingContext). |
| GetType() |
Obtient le type d’exécution de l’instance actuelle. (Hérité de Exception) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| ToString() |
Retourne une chaîne qui contient le HRESULT de l’erreur. (Hérité de ExternalException) |
Événements
| Nom | Description |
|---|---|
| SerializeObjectState |
Se produit lorsqu’une exception est sérialisée pour créer un objet d’état d’exception qui contient des données sérialisées sur l’exception. (Hérité de Exception) |