ITestRun Interface

Represents an execution of a set of tests against a specific build.

Namespace:  Microsoft.TeamFoundation.TestManagement.Client
Assembly:  Microsoft.TeamFoundation.TestManagement.Client (in Microsoft.TeamFoundation.TestManagement.Client.dll)

Syntax

'Declaration
Public Interface ITestRun _
    Inherits IIdentifiable(Of Integer), IAttachmentOwner, ITestMessageLogOwner,  _
    INotifyPropertyChanged

public interface ITestRun : IIdentifiable<int>, 
    IAttachmentOwner, ITestMessageLogOwner, INotifyPropertyChanged

public interface class ITestRun : IIdentifiable<int>, 
    IAttachmentOwner, ITestMessageLogOwner, INotifyPropertyChanged

type ITestRun =  
    interface
        interface IIdentifiable<int>
        interface IAttachmentOwner
        interface ITestMessageLogOwner
        interface INotifyPropertyChanged
    end

public interface ITestRun extends IIdentifiable<int>, IAttachmentOwner, ITestMessageLogOwner, INotifyPropertyChanged

The ITestRun type exposes the following members.

Properties

	Name	Description
	Attachments	Gets the collection of attachments. (Inherited from IAttachmentOwner.)
	BuildConfigurationId	Gets the build configuration ID for this test run.
	BuildDirectory	Gets or sets the path of the output of the build.
	BuildFlavor	Gets or sets the flavor of the build (that is, "Release" or "Debug").
	BuildNumber	Gets or sets the name of the build.
	BuildPlatform	Gets or sets the platform of the build.
	BuildUri	Gets or sets the uniform resource identifier (URI) of the build against which this test run was executed.
	Comment	Gets or sets a string containing all comments entered by those analyzing the test run.
	Controller	Gets the name of the controller for this test run.
	DateCompleted	Gets or sets the date and time that the last test completed.
	DateCreated	Gets the date that this test run was created.
	DateDue	Gets the date that this test run is due.
	DateStarted	Gets or sets the date that this test run was started.
	ErrorMessage	Gets or sets a short description of a failure, if any.
	Id	Gets the identifier. (Inherited from IIdentifiable<TKey>.)
	IsAutomated	Gets or sets a value that indicates whether the test run contains tests that should be automatically executed.
	IsBvt	Gets or sets a value that indicates whether this test run is a build verification test.
	IsDirty	Gets a value that indicates whether this test run has been changed since the last save operation.
	Iteration	Gets or sets the number of times that this test run has been executed.
	LastUpdated	Gets the date and time that this test run was last updated.
	LastUpdatedBy	Gets the identity of the last person to update this test run.
	Owner	Gets or sets the identity of the person who owns this test run.
	PostProcessState	Gets the state of any post-process activities that occur on the server.
	Project	Gets the team project for this run.
	Revision	Gets the incremental revision number that is used for concurrency control.
	State	Gets the current state of this test run.
	Statistics	Gets the statistics that detail the number of test cases in various states in this test run.
	TestEnvironmentId	Gets the GUID for the test environment for this test run.
	TestMessageLogEntries	Gets a collection of test message log entries. (Inherited from ITestMessageLogOwner.)
	TestPlanId	Gets the ID of the test plan that contains this test run.
	TestSettings	Gets the test settings that are used for this test execution.
	TestSettingsId	Gets the ID for the test settings that are used for this test execution.
	Title	Gets or sets the title of this test run.
	Type	Gets the type of this test run.
	Version	Gets the client version that ran the test.

Top

Methods

	Name	Description
	Abort()	Aborts this test run.
	Abort(TestRunAbortOptions)	Aborts this test run by using the given options.
	AddTest	Adds a test case and configuration to the test run.
	AddTestPoint	Adds a new test point to this test run.
	CopyTestSettings	Copies the provided test settings object to this test run.
	CreateAttachment(String)	Creates an attachment from a file. (Inherited from IAttachmentOwner.)
	CreateAttachment(String, SourceFileAction)	Creates an attachment from a file, optionally deleting the source file after uploading. (Inherited from IAttachmentOwner.)
	CreateAttachment(array<Byte[], Int32, Int32)	Creates an attachment for a test result from the provided byte array.
	CreateLogEntry	Creates a test message log entry and adds it to the TestMessageLogEntryCollection. (Inherited from ITestMessageLogOwner.)
	Delete	Removes this test run and its results from the server.
	QueryResults	Returns a collection that contains all test results for this test run.
	QueryResultsByOutcome	Returns a collection of test results for this test run that has the provided test outcome.
	QueryResultsByOwner	Returns a collection of test results for this test run that has the provided test owner.
	QueryResultsByStatus	Returns a collection of test results for this test run that has the provided test status.
	Refresh	Updates this test run by using new data from the server.
	RefreshLogEntries	Refreshes the log entries from the server. (Inherited from ITestMessageLogOwner.)
	Save	Writes new or updated test run data to the server.
	SaveLogEntries	Saves changed log entries to the server. (Inherited from ITestMessageLogOwner.)

Top

Events

	Name	Description
	AttachmentUploadCompleted	This event is raised when the attachment upload is completed. (Inherited from IAttachmentOwner.)
	PropertyChanged	Occurs when a property value changes. (Inherited from INotifyPropertyChanged.)

Top

See Also

Reference

Microsoft.TeamFoundation.TestManagement.Client Namespace

IIdentifiable<TKey>

IAttachmentOwner

ITestMessageLogOwner

INotifyPropertyChanged