EnableConnectionStringAllowedProperties(FileInfo, bool)

このメソッドは、JSONファイルで許可されるパラメータ・リストのファイル・パスを受け入れます。

宣言

// C#
public static void EnableConnectionStringAllowedProperties(FileInfo jsonFile, bool enforceOnAlias)

パラメータ

  • jsonFile

    JSONで許可されるパラメータ・ファイルのパスを指定します。

  • enforceOnAlias

    許可されるパラメータ・リストをTNS別名に対して強制するかどうか

例外

OracleException – ユニバーサル・ネーミング規則(UNC)ファイル・パスが許可されておらず、ファイル・パスがUNCファイル・パスで構成されている場合。

OracleException – ファイル・パスにODPConnectionStringAllowedProperties.json以外のファイル名が含まれている場合は、OracleException (ORA-50124: 構成ファイルに{0}という名前を付ける必要があります)がスローされます。

InvalidOperationException – 少なくとも1つの接続がオープンした後に、以前に使用されたJSONファイル・パスとは異なるパスでこのメソッドが呼び出された場合。

備考

FileInfo型のJSONファイル・パラメータは、ODPConnectionStringAllowedProperties.jsonファイルが格納されているディレクトリ、またはそのJSONファイルがあるファイルのフル・パスに設定できます。ファイル名を指定する場合は、ODPConnectionStringAllowedProperties.jsonにする必要があります。

ODP.NETは、許可されていないパラメータが含まれているかについて、接続文字列のデータ・ソースをチェックします。その場合、接続は許可されません。

最初の接続が作成される前にアプリケーションがEnableConnectionStringAllowedPropertiesメソッドをコールすると、ODP.NETはODPConnectionStringAllowedProperties.jsonファイルをオープンして読取りを試みます。ファイルのオープンまたは読取りに失敗すると、例外がスローされます。

アプリケーションでEnableConnectionStringAllowedPropertiesメソッドを呼び出せません。有効な接続がオープンされた後に別のJSONファイルの場所が取得されています。ただし、アプリケーションは、同じファイル・パスと異なるenforceOnAlias値を使用してメソッドを再度呼び出す可能性があります。Booleanパラメータは、構成どおりに適用されます。

アプリケーションは、実行時にJSONファイルの内容を更新できます。ODP.NETは、ファイルが保存された後、ファイルの事前読取りを試みます。

関連項目: