ヘッダーをスキップ
Oracle Data Provider for .NET開発者ガイド
11g リリース1（11.1）
E05791-01
  目次へ
目次		 索引へ
索引
戻る
戻る 		 次へ
次へ		  

OracleExceptionクラス

OracleExceptionクラスは、Oracle Data Provider for .NETでエラーが発生したときに表示される例外を表します。各OracleExceptionオブジェクトには、エラーまたは警告について説明するErrorプロパティ内のOracleErrorオブジェクトが少なくとも1つ含まれます。

クラスの継承

System.Object

  System.Exception

    System.SystemException

      System.Runtime.InteropServices.ExternalException（ADO.NET 2.0のみ）

        System.Data.Common.DbException（ADO.NET 2.0のみ）

         Oracle.DataAccess.Client.OracleException

宣言

// C#
public sealed class OracleException : SystemException

スレッド安全性

パブリック静的メソッドはスレッドセーフですが、インスタンス・メソッドではスレッド安全性は保証されません。

備考

複数のエラーがある場合、ODP.NETはスタック上の最初のエラー・メッセージのみを戻します。

例

// C#

using System;
using System.Data;
using Oracle.DataAccess.Client;

class OracleExceptionSample
{
  static void Main()
  {
    string constr = "User Id=scott;Password=tiger;Data Source=oracle";
    OracleConnection con = new OracleConnection(constr);
    con.Open();

    // Create an OracleCommand object using the connection object
    OracleCommand cmd = con.CreateCommand();

    try
    {
      cmd.CommandText = "insert into notable values (99, 'MyText')";
      cmd.ExecuteNonQuery();
    }
    catch (OracleException ex)
    {
      Console.WriteLine("Record is not inserted into the database table.");
      Console.WriteLine("Exception Message: " + ex.Message);
      Console.WriteLine("Exception Source: " + ex.Source);
    }
  }
}

要件

ネームスペース: Oracle.DataAccess.Client

アセンブリ: Oracle.DataAccess.dll

Microsoft .NET Frameworkバージョン: 1.xまたは2.0


参照:

OracleExceptionメンバー

OracleExceptionメンバーは次の表にリストされています。

OracleException静的メソッド

OracleException静的メソッドのリストを、表5-57に示します。

表5-57 OracleException静的メソッド

メソッド 説明

Equals

System.Objectからの継承（オーバーロード）

OracleExceptionプロパティ

OracleExceptionプロパティのリストを、表5-58に示します。

表5-58 OracleExceptionプロパティ

プロパティ 説明

DataSource

Oracleインスタンスへの接続の情報を含むTNS名を指定します

Errors

Oracle Databaseによって生成される例外に関する情報を含む、1つ以上のOracleErrorオブジェクトのコレクションを指定します

HelpLink

System.Exceptionからの継承

InnerException

System.Exceptionからの継承

Message

例外時に出されるエラー・メッセージを指定します

Number

Oracleのエラー番号を指定します

Procedure

例外を引き起こすストアド・プロシージャを指定します

Source

エラーを生成するデータ・プロバイダの名前を指定します

StackTrace

System.Exceptionからの継承

TargetSite

System.Exceptionからの継承

OracleExceptionメソッド

OracleExceptionメソッドのリストを、表5-59に示します。

表5-59 OracleExceptionメソッド

メソッド 説明

Equals

System.Objectからの継承（オーバーロード）

GetBaseException

System.Exceptionからの継承

GetHashCode

System.Objectからの継承

GetObjectData

例外に関する情報でシリアル化可能なinfoオブジェクトを設定します

GetType

System.Objectからの継承

ToString

この例外の完全修飾名を戻します


参照:

OracleException静的メソッド

OracleException静的メソッドのリストを、表5-60に示します。

表5-60 OracleException静的メソッド

メソッド 説明

Equals

System.Objectからの継承（オーバーロード）


参照:

OracleExceptionプロパティ

OracleExceptionプロパティのリストを、表5-61に示します。

表5-61 OracleExceptionプロパティ

プロパティ 説明

DataSource

Oracleインスタンスへの接続の情報を含むTNS名を指定します

Errors

Oracle Databaseによって生成される例外に関する情報を含む、1つ以上のOracleErrorオブジェクトのコレクションを指定します

HelpLink

System.Exceptionからの継承

InnerException

System.Exceptionからの継承

Message

例外時に出されるエラー・メッセージを指定します

Number

Oracleのエラー番号を指定します

Procedure

例外を引き起こすストアド・プロシージャを指定します

Source

エラーを生成するデータ・プロバイダの名前を指定します

StackTrace

System.Exceptionからの継承

TargetSite

System.Exceptionからの継承


参照:

DataSource

このプロパティは、Oracleインスタンスへの接続の情報を含むTNS名を指定します。

宣言

// C#
public string DataSource {get;}

プロパティ値

接続情報を含むTNS名


参照:

Errors

このプロパティは、Oracle Databaseによって生成される例外に関する情報を含む、1つ以上のOracleErrorオブジェクトのコレクションを指定します。

宣言

// C#
public OracleErrorCollection Errors {get;}

プロパティ値

OracleErrorCollection

備考

ErrorsプロパティにはOracleErrorオブジェクトの、少なくとも1つのインスタンスが含まれます。


参照:

Message

Exceptionをオーバーライドします

このプロパティは、例外時に出されるエラー・メッセージを指定します。

宣言

// C#
public override string Message {get;}

プロパティ値

string

備考

MessageはErrorsコレクションの全エラーを連結したものです。各エラー・メッセージは連結され、最後の1つ以外は改行で繋げられます。


参照:

Number

このプロパティはOracleのエラー番号を指定します。

宣言

// C#
public int Number {get;}

プロパティ値

エラー番号

備考

このエラー番号は、Oracleによって生成されたエラーの最上位レベルであり、プロバイダ固有のエラー番号である可能性があります。


参照:

Procedure

このプロパティは、例外を引き起こす、格納されたプロシージャを指定します。

宣言

// C#
public string Procedure {get;}

プロパティ値

格納されたプロシージャ名


参照:

Source

Exceptionをオーバーライドします

このプロパティは、エラーを生成するデータ・プロバイダの名前を指定します。

宣言

// C#
public override string Source {get;}

プロパティ値

データ・プロバイダの名前


参照:

OracleExceptionメソッド

OracleExceptionメソッドのリストを、表5-62に示します。

表5-62 OracleExceptionメソッド

メソッド 説明

Equals

System.Objectからの継承（オーバーロード）

GetBaseException

System.Exceptionからの継承

GetHashCode

System.Objectからの継承

GetObjectData

例外に関する情報でシリアル化可能なinfoオブジェクトを設定します

GetType

System.Objectからの継承

ToString

この例外の完全修飾名を戻します


参照:

GetObjectData

Exceptionをオーバーライドします

このメソッドにより、例外に関する情報で、シリアル化可能なinfoオブジェクトを設定します。

宣言

// C#
public override void GetObjectData(SerializationInfo info, StreamingContext
    context);

パラメータ

備考

この情報には、DataSource、Message、Number、Procedure、SourceおよびStackTraceが含まれます。


参照:

ToString

Exceptionをオーバーライドします

このメソッドにより、この例外の完全修飾名、Messageプロパティのerrorメッセージ、InnerException.ToString()メッセージおよびスタック・トレースを戻します。

宣言

// C#
public override string ToString();

戻り値

例外の文字列表現

例

// C#

using System;
using Oracle.DataAccess.Client;

class ToStringSample
{
  static void Main()
  {
    string constr = "User Id=scott;Password=tiger;Data Source=oracle";
    OracleConnection con = new OracleConnection(constr);
    con.Open();

    // Create an OracleCommand object using the connection object
    OracleCommand cmd = con.CreateCommand();

    try
    {
      cmd.CommandText = "insert into notable values (99, 'MyText')";
      cmd.ExecuteNonQuery();  // This will throw an exception
    }
    catch (OracleException ex)
    {
      Console.WriteLine("Record is not inserted into the database table.");
      Console.WriteLine("ex.ToString() : " + ex.ToString());
    }
  }
}

参照:

  戻る
戻る 		 次へ
次へ
  目次へ
目次		 索引へ
索引