6.4.6.21 OpenWithNewPassword(SecureString)

このメソッドは、新規パスワードで新規接続をオープンします。

宣言

// C#
public void OpenWithNewPassword(SecureString newSecurePassword)

パラメータ

  • newSecurePassword

    ユーザーIDの新規パスワードが含まれるSecureStringオブジェクト。

備考

このメソッドを使用して、ユーザーIDのパスワードを変更します。このメソッドを使用できるのは、OracleConnectionコンストラクタまたはOracleConnection Credentialプロパティを使用してOracleCredentialインスタンスが渡された場合に限られます。

このメソッドは、OracleConnectionコンストラクタまたはOracleConnection Credentialプロパティを使用して渡されたOracleCredentialインスタンスのパスワードの更新も行います。

OracleCredentialでは、SecureStringパスワードの二重引用符をサポートしません。ただし、二重引用符はパスワード内で使用できます。

例外

newSecurePasswordがNULLの場合、または読取り専用でない場合は、ArgumentNullExceptionが発生します。

OracleConnectionコンストラクタを使用するか、OracleConnectionCredentialプロパティを使用してOracleConnectionOracleCredentialが設定されていない場合は、InvalidOperationExceptionが発生します。

OracleConnectionがすでにオープン状態である場合は、InvalidOperationExceptionが発生します。

接続文字列がNULLまたは長さ0の場合は、InvalidOperationExceptionが発生します。

接続文字列を使用して、ユーザーID、プロキシ・ユーザーID、パスワード、プロキシ・パスワード、DBA権限が設定されている場合は、InvalidOperationExceptionが発生します。