OracleErrorクラス

OracleErrorクラスは、Oracleにより報告されるエラーを表します。

クラスの継承

System.Object

Oracle.DataAccess.Client.OracleError

宣言

// C#
public sealed class OracleError

要件

プロバイダ	ODP.NET管理対象外ドライバ	ODP.NET管理対象ドライバ
アセンブリ	`Oracle.DataAccess.dll`	`Oracle.ManagedDataAccess.dll`
ネームスペース	`Oracle.DataAccess.Client`	`Oracle.ManagedDataAccess.Client`
.NET Framework	3.5, 4.0, 4.5	4.0, 4.5

スレッド安全性

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

備考

OracleErrorクラスは、Oracleにより報告される警告またはエラーを表します。

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

例

// C#
 
using System;
using System.Data;
using Oracle.DataAccess.Client;
 
class OracleErrorsSample
{
  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.");
 
      foreach (OracleError error in ex.Errors) 
      {
        Console.WriteLine("Error Message: " + error.Message);
        Console.WriteLine("Error Source: " + error.Source);       
      }
    }
  }
}

関連項目:

OracleErrorメンバー

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

OracleError静的メソッド

OracleError静的メソッドを、表6-63にリストします。

表6-63 OracleError静的メソッド

メソッド	説明
`Equals`	`System.Object`からの継承(オーバーロード)

OracleErrorプロパティ

OracleErrorプロパティを、表6-64にリストします。

表6-64 OracleErrorプロパティ

プロパティ	説明
ArrayBindIndex	配列バインド実行時に発生したエラーの行数を指定します
DataSource	Oracle Databaseを識別するOracleサービス名(TNS名)を指定します
Message	`error`を記述する`message`を指定します
Number	Oracleの`error`番号を指定します
Procedure	`error`を引き起こすストアド・プロシージャを指定します
Source	`error`を生成するデータ・プロバイダの名前を指定します

OracleErrorメソッド

OracleErrorメソッドを、表6-65にリストします。

表6-65 OracleErrorメソッド

メソッド	説明
`Equals`	`System.Object`からの継承(オーバーロード)
`GetHashCode`	`System.Object`からの継承
`GetType`	`System.Object`からの継承
ToString	`OracleError`の文字列表現を戻します

関連項目:

OracleError静的メソッド

OracleError静的メソッドを、表6-66にリストします。

表6-66 OracleError静的メソッド

メソッド	説明
`Equals`	`System.Object`からの継承(オーバーロード)

関連項目:

OracleErrorプロパティ

OracleErrorプロパティを、表6-67にリストします。

表6-67 OracleErrorプロパティ

プロパティ	説明
ArrayBindIndex	配列バインド実行時に発生したエラーの行数を指定します
DataSource	Oracle Databaseを識別するOracleサービス名(TNS名)を指定します
Message	`error`を記述する`message`を指定します
Number	Oracleの`error`番号を指定します
Procedure	`error`を引き起こすストアド・プロシージャを指定します
Source	`error`を生成するデータ・プロバイダの名前を指定します

関連項目:

ArrayBindIndex

このプロパティでは、Array Bindの実行中に発生したエラーの行番号を指定します。

宣言

// C#
public int ArrayBindIndex {get;}

プロパティ値

Array Bindの実行中に発生したエラーの行番号を指定する整数

備考

デフォルト = 0

このプロパティはArray Bind操作専用です。

ArrayBindIndexは、Array Bind操作中にエラーが発生したゼロベースの行番号を表します。たとえば配列バインドの実行によって、2番目と4番目の操作でエラーが2つ発生すると、2と4のArrayBindIndexプロパティ値を持つ2つのOracleErrorオブジェクトがOracleErrorCollectionに表示されます。

関連項目:

DataSource

このプロパティはOracle Databaseを識別する、Oracleサービス名(TNS名)を指定します。

宣言

// C#
public string DataSource {get;}

プロパティ値

string

関連項目:

Message

このプロパティはerrorを記述するmessageを指定します。

宣言

// C#
public string Message {get;}

プロパティ値

string

関連項目:

Number

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

宣言

// C#
public int Number {get;}

プロパティ値

int

関連項目:

Procedure

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

宣言

// C#
public string Procedure {get;}

プロパティ値

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

備考

このOracleErrorオブジェクトを作成する、格納されたプロシージャを表します。

関連項目:

Source

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

宣言

// C#
public string Source {get;}

プロパティ値

string

関連項目:

OracleErrorメソッド

OracleErrorメソッドを、表6-68にリストします。

表6-68 OracleErrorメソッド

メソッド	説明
`Equals`	`System.Object`からの継承(オーバーロード)
`GetHashCode`	`System.Object`からの継承
`GetType`	System.`Object`からの継承
ToString	`OracleError`の文字列表現を戻します

関連項目:

ToString

Objectをオーバーライドします。

このメソッドにより、OracleErrorの文字列表現を戻します。

宣言

// C#
public override string ToString();

戻り値

Ora-エラー番号:Class.Method名、エラー・メッセージ、スタック・トレース情報の書式を持つ文字列を戻します。

例

ORA-24333:繰返し件数が0(ゼロ)です

関連項目: