OpenWithNewPasswordAsync(SecureString)

このメソッドは、新しいSecureStringパスワードを使用して非同期的に新規接続をオープンします。

宣言

// C#
public Task OpenWithNewPasswordAsync(SecureString newSecurePassword);

パラメータ

newSecurePassword

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

戻り値

オープンしている接続の期間全体にわたりコール元のスレッドをブロックすることがない、即座に非同期処理を表すTaskオブジェクト。

例外

ArgumentNullException - newSecurePasswordがNULLであるか読取り専用ではありません。
InvalidOperationException - OracleConnectionコンストラクタを使用するかOracleConnectionのCredentialプロパティを使用してOracleConnectionでOracleCredentialが設定されていません。
InvalidOperationException - OracleConnectionがすでにオープン状態です。
InvalidOperationException - 接続文字列がNULLであるかその長さが0です。
InvalidOperationException - 接続文字列を使用してユーザーID、プロキシ・ユーザーID、パスワード、プロキシ・パスワード、DBA権限が設定されています。

備考

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

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

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