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

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

前 | 次 |

# PDBName

このプロパティは、セッションが接続されているプラガブル・データベースの名前の設定および取得に使用されます。

宣言

    // C#
    public string PDBName{ get; set; }

プロパティ値

`PDBName`は、接続のプラガブル・データベース名を示す文字列を戻します。

例外

- `InvalidOperationException()` - 接続がすでにオープンされている場合。

- `InvalidOperationException()` - `CPVersion`が`1.0`に設定され、`PDBName`プロパティが設定されている場合。ODP.NET管理対象外ドライバにのみ適用されます。

- `InvalidOperationException()` - `CPVersion`が`1.0`に設定され、`PDBName`値が取得される場合。ODP.NET管理対象外ドライバにのみ適用されます。

備考

プラガブル・データベースは、Oracle Database 12c以上で使用できます。特定のPDBで実行されている指定されたサービスに接続するには、`ServiceName`プロパティおよび`PDBName`プロパティを使用できます。

要求されたプラガブル・データベース名との接続が返されるように、接続をオープンする前にプロパティを設定する必要があります。

接続をオープンする前に`PDBName`プロパティが設定されている場合、`OracleConnection.Open()`が正常に実行されると接続のプラガブル・データベース名は`PDBName`と同じになります。

`PDBName`プロパティのみが設定されている場合、プラガブル・データベースのデフォルト・サービスはこの接続の`ServiceName`として使用されます。

管理対象外のODP.NETでは、`PDBName`プロパティが設定され、さらに.NET構成設定である`CPVersion`が設定されていない場合、`CPVersion`属性は自動的に`2.0`に設定されます。

`PDBName`プロパティの値は大/小文字を区別しません。

接続をオープンした後、セッションのプラガブル・データベース名を取得するには、`PDBName`プロパティを使用できます。接続をオープンする前にプラガブル・データベース名を取得するために使用される場合、アプリケーションで指定するプラガブル・データベース名(ある場合)を戻します。

.NET Framework 4以降でのみサポートされています。

関連項目:

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

- OracleConnectionクラス

- OracleConnectionメンバー