ヘッダーをスキップ
Oracle® Data Provider for .NET開発者ガイド
11g リリース2 (11.2.0.4)
B66456-02
  目次へ移動
目次		 索引へ移動
索引
前
前 		 次
次		  

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

ODP.NETのバージョン: ODP.NET for .NET Framework 2.0またはODP.NET for .NET Framework 4


関連項目:

OracleExceptionメンバー

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

OracleException静的メソッド

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

表5-62 OracleException静的メソッド

メソッド 説明

Equals

System.Objectからの継承(オーバーロード)

OracleExceptionプロパティ

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

表5-63 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-64にリストします。

表5-64 OracleExceptionメソッド

メソッド 説明

Equals

System.Objectからの継承(オーバーロード)

GetBaseException

System.Exceptionからの継承

GetHashCode

System.Objectからの継承

GetObjectData

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

GetType

System.Objectからの継承

ToString

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


関連項目:

OracleException静的メソッド

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

表5-65 OracleException静的メソッド

メソッド 説明

Equals

System.Objectからの継承(オーバーロード)


関連項目:

OracleExceptionプロパティ

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

表5-66 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-67にリストします。

表5-67 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);

パラメータ

  • info

    SerializationInfoオブジェクト

  • context

    StreamingContextオブジェクト

備考

この情報には、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());
    }
  }
}

関連項目:

  前
前 		 次
次
  目次へ移動
目次		 索引へ移動
索引