OpenWithNewPasswordAsync(SecureString, CancellationToken)

このメソッドは、新しいSecureStringパスワード、およびタスクを取り消すことができるトークンを使用して非同期的に新規接続をオープンします。

宣言

// C#
public Task OpenWithNewPasswordAsync(SecureString newSecurePassword, CancellationToken
    cancellationToken);

パラメータ

newSecurePassword

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

接続のタイムアウトが発生する前にタスクを取り消すためにアプリケーションによって使用可能な入力取消しトークン。

戻り値

オープンしている接続の期間全体にわたりコール元のスレッドをブロックすることがない、即座に非同期処理を表す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パスワードの二重引用符をサポートしません。ただし、パスワード内では二重引用符を使用できます。