Contains

このメソッドは、Oracleソフトウェア・バージョンに応じて、ロールがロール・コレクションに存在するか、接続がオープンしている場合はロールが接続で有効になっているかを確認します。

宣言

// C#
public bool Contains(string Role)

パラメータ

Role - ロール・コレクションでの存在をチェックするロール名。

戻り値

ロールがODP.NETロール・コレクションに存在するかを示す、または現在のセッションでそのロールが有効になっているかを示すブール値。正確な動作は、データベースのバージョンによって異なります。

例外

ArgumentNullException - ロール名がNullとして指定された場合にスローされます。

ArgumentException - ロール名が空の文字列として指定された場合にスローされます。

ArgumentException - 大/小文字が区別されるロール名が二重引用符で正しく囲まれていない場合にスローされます。

備考

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

Oracle DatabaseおよびODP.NETバージョン23.9以降では、このメソッドは、指定されたロールが現在のセッションで有効になっているかどうかをチェックします。これには、その接続がオープンされている必要があります。このメソッドは、OracleRoleCollection.Addを使用して指定されたロールではなく、現在のセッションで引き続き有効になっているロールについてもtrueを返します。例としては、セッションが確立されるとすぐに有効になるデフォルトのロールがあります。

DRCP接続の場合、セッションがOracleConnectionオブジェクトにアタッチされるまで、このメソッドはOracleRoleCollectionオブジェクトで指定されたロール名を検索します。