プライマリ・コンテンツに移動

Oracle® Data Provider for .NET開発者ガイド ODAC 12.2c リリース1 (12.2.0.1) for Microsoft Windows E88311-03 |
| 目次 | 索引

前 | 次 |

# Add

このメソッドは、新しい接続文字列断片と制限されているキーワードのリストを`OraclePermission`オブジェクトに追加します。

宣言

    // C#
    public void Add(string connStr, string keyRestrict,
       KeyRestrictionBehavior behavior);

パラメータ

- `connStr`

  接続文字列断片。

- `keyRestrict`

  キー制限。

- `behavior`

  次の`KeyRestrictionBehavior`の列挙のいずれか。

  - `AllowOnly`

  - PreventUsage

例外

`ArgumentException` - `KeyRestrictionBehavior`値、あるいは`connStr`または`keyRestict`文字列の形式が無効です。

備考

`Add`メソッドは、権限オブジェクトで許可または禁止される接続文字列を構成します。

`OracleConnection`をオープンする操作は、接続文字列断片、キー制限およびキー制限の動作に基づいて、許可または拒否されます。

次の例では、`KeyRestrictionBehavior.AllowOnly`により、任意の`User Id`と`Password`の組合せとともに`orcl`を`Data Source`として使用する接続文字列を許可しています。他の接続文字列キーワードは許可されません。`User Id`と`Password`以外の接続文字列キーワードを使用すると、セキュリティ例外が発生します。

    orclPermission.Add("Data Source=orcl;","User Id=;Password=;",
       KeyRestrictionBehavior.AllowOnly);

次の例では、`KeyRestrictionBehavior.PreventUsage`により、キーワード`Pooling`を使用する接続文字列を制限しています。`Pooling`キーワードを使用すると、例外が発生します。

    orclPermission.Add("Data Source=orcl;","Pooling=;",
       KeyRestrictionBehavior.PreventUsage)

一般的なルールとして、制限のない環境では許可されていない接続文字列は制限され、セキュリティ例外がスローされる原因となります。

接続文字列断片に`password`および`proxy password`属性のキー値のペアが含まれる場合、それらの属性の値は無視されます。ただし、属性自体が存在するかどうかはチェックされます。つまり、接続が許可されるのは、`password`および`proxy attributes`キーワードが接続文字列で許可されている場合のみです。

関連項目:

- Oracle.DataAccess.ClientおよびOracle.ManagedDataAccess.Clientのネームスペース

- OraclePermissionクラス

- OraclePermissionメンバー