再生中に特定のイベントを待機するようにコード化された UIT テストを設定

コード化された UI テストの再生では、テストに対して指示することで、ウィンドウの表示やプログレス バーの非表示などの特定のイベントが発生するまで待機することができます。これを実行するには、次の表で説明されているように、該当する UITestControl.WaitForControlXXX() メソッドを使用します。WaitForControlEnabled メソッドで有効化されるコントロールを待機するコード化された UI テストの例については、「チュートリアル: コード化された UI テストの作成、編集、および保守」を参照してください。

要件

• Visual Studio Ultimate, Visual Studio Premium

ヒント
また Coded UI Test Editor で操作の前に遅延を追加できます。詳細については、「方法: コード化された UI テスト エディターを使用して UI アクションの前に遅延を挿入する」を参照してください。

UITestControl.WaitForControlXXX() メソッド

// Define the method to evaluate the condition 
private static bool IsStatusDone(UITestControl control) 
{ 
    WinText statusText = control as WinText; 
    return statusText.DisplayText == "Succeeded" || statusText.DisplayText == "Failed"; 
} 
// In test method, wait till the method evaluates to true 
statusText.WaitForControlCondition(IsStatusDone);

// Define the method to evaluate the condition 
private static bool IsStatusDoneOrError(UITestControl[] controls) 
{ 
    WinText statusText = controls[0] as WinText; 
    WinWindow errorDialog = controls[1] as WinWindow; 
    return statusText.DisplayText == "Succeeded" || errorDialog.Exists; 
} 
// In test method, wait till the method evaluates to true 
UITestControl.WaitForCondition<UITestControl[]>(new UITestControl[] { statusText, errorDialog }, IsStatusDoneOrError); 

上記のメソッドはすべて次のように動作します。

• 待機が成功すれば true を返し、失敗すれば false を返します。

• 待機操作の暗黙的なタイムアウトは、WaitForReadyTimeout プロパティによって指定されます。このプロパティの既定値は 60000 ミリ秒 (1 分) です。

• メソッドには、ミリ秒単位の明示的なタイムアウトを取得するためのオーバーロードがあります。ただし、待機操作の結果、コントロールが暗黙的に検索されたり、アプリケーションがビジー状態であったりすると、実際の待機時間が指定されたタイムアウトよりも長くなる可能性があります。

上で説明した機能は強力で柔軟性があり、ほとんどの条件を満たすと考えられます。しかし、これらのメソッドでもニーズが満たされず、コード内で Wait または Sleep をコード化する必要がある場合は、Thread.Sleep() API の代わりに Playback.Wait() を使用することをお勧めします。これには次の理由があります。

• ThinkTimeMultiplier プロパティを使用してスリープの継続時間を変更できます。既定ではこの変数は 1 ですが、値を増減させてコード全体で待機時間を変更することができます。たとえば、低速なネットワークで特別にテストを実行する場合や、その他のパフォーマンスが低下している状況で、特定の位置で (または構成ファイル内で) この変数を 1.5 に変更すると、あらゆる位置の待機時間を 50% 余分に追加できます。

• Playback.Wait() は、ユーザー取り消し\ブレーク操作の確認中に for ループ内の小さなチャンクで Thread.Sleep() を呼び出します (上記の計算後)。つまり、Playback.Wait() を使用すると、スリープにならなかったり、例外が発生しても、待機が完了する前に再生を取り消すことができます。

ヒント
Coded UI Test Editor (コード化された UI テスト エディター) を使用すると、コード化された UI テストを簡単に変更できます。Coded UI Test Editor (コード化された UI テスト エディター) を使用すると、テスト メソッドを検索、表示、および編集できます。また、UI コントロール マップ内の UI 操作および関連コントロールを編集することもできます。詳細については、「コード化された UI テスト エディターを使用したコード化された UI テストの編集」を参照してください。

ガイダンス

詳細については、"参照してください。Visual Studio 2012 –の"第 5 章連続的な配信のためにテスト: システム テストの自動化

参照

処理手順

チュートリアル: コード化された UI テストの作成、編集、および保守

方法: コード化された UI テスト エディターを使用して UI アクションの前に遅延を挿入する

概念

UI オートメーションを使用したコードの検証

コード化された UI テストの構造

コード化された UI テストと操作の記録でサポートされている構成とプラットフォーム

その他の技術情報

コード化された UI テストを作成する