Использование класса TestContext

Статья
11/05/2008

Обновлен: Ноябрь 2007

Класс TestContext используется в модульных тестах для выполнения нескольких задач. Далее представлены случаи наиболее частого использования класса.

В любом модульном тесте — поскольку в классе TestContext хранятся сведения, предоставляемые для модульных тестов, например путь к каталогу развертывания. Дополнительные сведения см. в разделе Структура модульных тестов.
В модульных тестах для проверки веб-тестов, выполняющихся на сервере ASP.NET Development Server. В этом случае TestContext хранит URL-адрес веб-службы. Дополнительные сведения см. в разделе Тестирование веб-служб.
В модульных тестах ASP.NET — для получения доступа к объекту Page. Дополнительные сведения см. в разделе Работа с модульными тестами ASP.NET.
В управляемых данными модульных тестах класс TestContext необходим для предоставления доступа к строке данных. Дополнительные сведения см. в разделах Работа с модульными тестами на основе данных, Написание кода модульного теста, управляемого данными и Пошаговое руководство. Использование файла конфигурации для определения источника данных.

Получение TestContext

При выполнении модульного теста пользователю автоматически предоставляется конкретный экземпляр типа TestContext, если в тестовом классе, содержащем метод модульного теста имеется определенное свойство TestContext. Платформа модульного теста автоматически заполняет члены TestContext, которые будут использоваться во время всех тестов. (Дополнительные сведения о членах TestContext см. в разделе TestContext.) Это значит, что тип TestContext не нужно создавать в коде. Его можно сразу же использовать, поскольку данный тип имеет поддержку IntelliSense.

Свойство TestContext автоматически определяется только в некоторых тестовых классах. Эта возможность зависит от способа создания теста.

Случаи, в которых свойство TestContext определяется автоматически

При создании модульного теста из кода происходит автоматическое определение свойства TestContext. Дополнительные сведения о способах создания модульных тестов см. в разделе Практическое руководство. Создание модульного теста.

Случаи, в которых свойство TestContext Property не определяется автоматически

Для создания модульных тестов можно воспользоваться несколькими способами, а не создавать их автоматически. При создании теста любым из следующих способов в тестовом классе будет отсутствовать автоматически определенное свойство TestContext.

Кодирование нового тестового класса вручную.
Добавление в проект нового файла модульного теста. Например, для этого в меню Тест следует выбрать пункт Создать тест, а затем в диалоговом окне Добавление нового теста выбрать Модульный тест.

В этих случаях свойство TestContext необходимо добавить вручную. Дополнительные сведения о кодировании модульных тестов см. в разделе Практическое руководство. Создание модульного теста.

Пример TestContext

Для использования TestContext создайте в тестовом классе член и свойство, как описано в следующем примере в C#.

private TestContext testContextInstance;
/// <summary>
///Gets or sets the test context which provides
///information about and functionality for the current test run.
///</summary>
public TestContext TestContext
{
    get
    {
        return testContextInstance;
    }
    set
    {
        testContextInstance = value;
    }
}

Тестовая платформа автоматически задает значение свойству, которое затем можно использовать в модульных тестах.