OpenWithNewClientSecret

このメソッドは、新しいAzure ADクライアント・シークレットを使用して新しい接続をオープンします。

宣言

// C#
public static void OpenWithNewClientSecret(this OracleConnection @this, SecureString clientSecret)

パラメータ

clientSecret – 新しいクライアント・シークレットSecureStringオブジェクト参照

例外

新しいクライアント・シークレットがnullとして渡されると、ArgumentNullExceptionが発生します。
新しいクライアント・シークレットの長さが0の場合、または対応するセキュアな文字列が読取り専用として設定されていない場合は、ArgumentExceptionが発生します。
InvalidOperationException - 接続がすでにオープンされているか、TokenAuthenticationプロパティがAzureServicePrincipalに設定されていません。
OracleException – トークン認証の場合、エラーには「ORA-50109: トークンベース認証の構成が無効です」が含まれます

説明

ODP.NETは、新しいクライアント・シークレット値を使用して新しい接続をオープンします。新しい接続が正常にオープンすると、この新しいクライアント・シークレットが接続プールにキャッシュされます。新しい接続が正常にオープンできない場合は、例外がスローされ、新しいクライアント・シークレットは無視されます。

備考

このメソッドは、現在のAzureクライアント・シークレットが期限切れになった場合、または別のクライアント・シークレットで接続をオープンする場合にのみ推奨されます。

ODP.NETは、新しいクライアント・シークレットが、接続プール内の既存のキャッシュされたクライアント・シークレットと同じ値または参照であるかをチェックしません。

このメソッドでは、既存の接続プールが関連付けられていない場合でも、完全に新しい接続と接続プールが正常にオープンします。