Add(string, OracleOpaqueString)

このメソッドは、ロールをパスワードとともにロール・リストに追加し、新しく作成された接続または接続プールからの接続に対してロールを設定します。

宣言

// C#
public void Add(string Role,  OracleOpaqueString Password);

パラメータ

Role - 接続に設定されるロール名。
Password - ロールのパスワード

例外

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

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

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

InvalidOperationException - 接続がすでにオープンされている場合にスローされます。

備考

OracleRoleCollectionオブジェクトにロールを追加する前に、ユーザーにデータベース・ロールがすでに付与されている必要があります。そうでない場合は、ロールが付与されていないか、存在しないことを示すエラーが発生します。ODP.NETコレクションに追加されていないデータベース・ロールは、コレクションに追加されたロールがない場合を除き、セッションでは無効になります。この場合、データベース・セッションでは非パスワードベースのロールが有効になります。

既存の接続の有効なロールを変更するには、接続をクローズし、接続インスタンスに関連付けられているOracleRoleCollectionインスタンスを変更して、接続を再オープンします。