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

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

前 | 次 |

# ServiceName

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

宣言

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

プロパティ値

`ServiceName`は、接続のサービス名を示す文字列を戻します。

例外

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

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

備考

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

接続に正しいサービスが使用されるように、接続をオープンする前に`ServiceName`を設定する必要があります。

`ServiceName`プロパティが設定されている場合、`PDBName`プロパティを設定する必要があります。設定されていない場合、接続をオープンするときに例外がスローされます。

接続をオープンする前に`ServiceName`プロパティが指定されている場合、接続をオープンしときに、接続のサービスは指定された`ServiceName`と同じになります。

接続を次にオープンするまでサービス名が変更されなければ、接続は引き続き以前に設定された`ServiceName`の値を使用します。

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

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

接続をオープンした後、`ServiceName`プロパティを使用してセッション・サービス名を取得することもできます。接続をオープンする前に取得すると、`ServiceName`はアプリケーションによって指定されたサービス名(ある場合)を戻します。

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

関連項目:

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

- OracleConnectionクラス

- OracleConnectionメンバー