Item

このプロパティは、索引値を使用してOracleRoleCollectionオブジェクトのロールを取得します。

宣言

// C#
public string Item[int index] {get;}

パラメータ

  • index - ロール名取得の索引値を表す整数。

プロパティ値

ロール名のstring

例外

ArgumentOutOfRangeException - 索引が有効な索引の範囲外です。

備考

ロールは、ロール名のアルファベット順に格納されます。ロール名をフェッチするには、索引値をOracleRoleCollection.Count値より小さくする必要があります。そうしないと、ArgumentOutOfRangeExceptionになります。

Oracle Database 23ai (23.8)以前のバージョンでは、このプロパティは、接続の状態(オープンまたはクローズ)に関係なく、OracleConnection.Rolesプロパティで指定されたロールのみを返します。

Oracle DatabaseおよびODP.NETバージョン23.9以降では、このプロパティは、接続がオープンされているときに、そのセッションで有効になっているデフォルトのセッション・ロール名を返します。

ロールの予約キーワード(ALLやNONEなど)がOracleRoleCollectionオブジェクトの一部である場合、このプロパティは、接続のクローズ時にロール・コレクションに追加された項目を返します。接続がオープンされている場合、このプロパティはセッション対応のロール名を返します。同様に、OracleRoleCollection.UseAllExceptプロパティがtrueに設定され、接続がクローズされていると、このプロパティはOracleRoleCollection項目名を返します。接続がオープンされている場合、このプロパティはセッション対応のロール名を返します。

DRCP接続では、接続がオープンされ、セッションがアタッチされるまで、このプロパティはOracleRoleCollectionオブジェクトで指定されたロール名を返します。

関連項目: