OleDbException クラス
基になるプロバイダが OLE DB データ ソースに関する警告またはエラーを返したときにスローされる例外。このクラスは継承できません。
この型のすべてのメンバの一覧については、OleDbException メンバ を参照してください。
System.Object
System.Exception
System.SystemException
System.Runtime.InteropServices.ExternalException
System.Data.OleDb.OleDbException
<Serializable>
NotInheritable Public Class OleDbException Inherits ExternalException
[C#]
[Serializable]
public sealed class OleDbException : ExternalException
[C++]
[Serializable]
public __gc __sealed class OleDbException : public ExternalException
[JScript]
public
Serializable
class OleDbException extends ExternalException
スレッドセーフ
この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。
解説
このクラスは、サーバーが生成したエラーを .NET Framework Data Provider for OLE DB が検出するたびに作成されます。クライアント側のエラーは、標準共通言語ランタイム例外としてスローされます。 OleDbException には、常に、 OleDbError のインスタンスが少なくとも 1 つ含まれています。
エラーの重大度レベルが非常に高い場合は、サーバーが OleDbConnection を閉じることがあります。ただし、ユーザーは接続を再び開いて、処理を継続できます。
使用例
[Visual Basic, C#, C++] データ ソースが見つからないために発生する OleDbException を生成し、その例外を表示する例を次に示します。
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 System.Diagnostics.EventLog = 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
[C#]
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.");
}
}
[C++]
public:
void ShowOleDbException()
{
String* mySelectQuery = S"SELECT column1 FROM table1";
OleDbConnection* myConnection =
new OleDbConnection(S"Provider=Microsoft.Jet.OLEDB.4.0;DataSource=");
OleDbCommand* myCommand = new OleDbCommand(mySelectQuery,myConnection);
try
{
myCommand->Connection->Open();
}
catch (OleDbException* e)
{
String* errorMessages = S"";
for (int i=0; i < e->Errors->Count; i++)
{
errorMessages = String::Concat(
String::Format( S"{0}Index #{1}\nMessage: {2}\n",
errorMessages,
__box(i),
e->Errors->Item[i]->Message ),
String::Format( S"NativeError: {0}\nSource: {1}\nSQLState: {2}\n",
__box(e->Errors->Item[i]->NativeError),
e->Errors->Item[i]->Source,
e->Errors->Item[i]->SQLState )
);
}
System::Diagnostics::EventLog* log = new System::Diagnostics::EventLog();
log->Source = S"My Application";
log->WriteEntry(errorMessages);
Console::WriteLine(S"An exception occurred. Please contact your system administrator.");
}
}
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
名前空間: System.Data.OleDb
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
アセンブリ: System.Data (System.Data.dll 内)
参照
OleDbException メンバ | System.Data.OleDb 名前空間 | OleDbError | OleDbErrorCollection