ITestRun 介面

發行項
05/07/2013

表示執行特定組建的一組測試。

命名空間： Microsoft.TeamFoundation.TestManagement.Client
組件： Microsoft.TeamFoundation.TestManagement.Client (在 Microsoft.TeamFoundation.TestManagement.Client.dll 中)

語法

'宣告
Public Interface ITestRun _
    Inherits ITestMessageLogOwner, ITestRunBase, IIdentifiable(Of Integer),  _
    IAttachmentOwner, INotifyPropertyChanged

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

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

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

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

ITestRun 型別會公開下列成員。

屬性

	名稱	說明
	Attachments	取得附件的集合。 (繼承自 IAttachmentOwner)。
	BuildConfigurationId	取得這個測試回合的組建組態 ID。
	BuildDirectory	取得或設定組建的輸出路徑。
	BuildFlavor	取得或設定組建類別 (也就是「版本」或「偵錯」)。
	BuildNumber	組建的名稱。 (繼承自 ITestRunBase)。
	BuildPlatform	取得或設定組建的平台。
	BuildUri	這個測試回合之執行依據的組建名稱 (做為 URI)。例如：new Uri("vstfs:///Build/Build/1") (繼承自 ITestRunBase)。
	Comment	分析回合者所輸入的註解。 (繼承自 ITestRunBase)。
	Controller	這個回合的控制器的名稱。 (繼承自 ITestRunBase)。
	DateCompleted	上次完成測試的日期。 (繼承自 ITestRunBase)。
	DateCreated	建立回合的日期。 (繼承自 ITestRunBase)。
	DateDue	取得這個測試回合的到期日期。
	DateStarted	啟動回合的日期。 (繼承自 ITestRunBase)。
	ErrorMessage	取得或設定失敗的簡短描述 (如果有的話)。
	Id	取得識別碼。 (繼承自 IIdentifiable<TKey>)。
	IncompleteTests	不存在要完成測試數目。
	IsAutomated	取得或設定值，指出測試回合是否包含應該自動執行的測試。
	IsBvt	取得或設定值，這個值表示這個測試回合是否為組建驗證測試。
	IsDirty	如果這個測試回合自前次儲存作業之後已變更，則為，否則為。 (繼承自 ITestRunBase)。
	Iteration	取得或設定這個測試回合的執行次數。
	LastUpdated	上次修改回合的日期 (設定標題或擁有者)。 (繼承自 ITestRunBase)。
	LastUpdatedBy	上次更新回合的人員 (繼承自 ITestRunBase)。
	LastUpdatedByName	上次更新回合的人員 (繼承自 ITestRunBase)。
	LinkedWorkItemCount	和測試結果相關聯的錯誤總數。 (繼承自 ITestRunBase)。
	Owner	啟動回合的使用者。 (繼承自 ITestRunBase)。
	OwnerName	啟動回合的使用者。 (繼承自 ITestRunBase)。
	OwnerTeamFoundationId	啟動回合的使用者。 (繼承自 ITestRunBase)。
	PassedTests	成功的測試數。
	PostProcessState	取得在伺服器上進行之任何後續處理活動的狀態。
	Project	取得這個回合的 Team 專案。
	Revision	並行存取控制項的 TestRun 修訂編號 (繼承自 ITestRunBase)。
	State	取得這個測試回合的目前狀態。
	Statistics	取得這個測試回合中處於各種狀態之測試案例數目的詳細統計資料。
	TestEnvironmentId	這個回合的測試環境。 (繼承自 ITestRunBase)。
	TestMessageLogEntries	取得測試訊息記錄項目的集合。 (繼承自 ITestMessageLogOwner)。
	TestPlanId	傳回含有這個回合的測試計劃 ID，如果這是臨機操作回合，則為零。 (繼承自 ITestRunBase)。
	TestSettings	用於這個測試回合執行作業的測試設定。如果回合沒有測試設定值，則為 null。 (繼承自 ITestRunBase)。
	TestSettingsId	用於這個測試回合的公用測試設定的 ID。 (繼承自 ITestRunBase)。
	Title	關聯的執行範本的標題。 (繼承自 ITestRunBase)。
	TotalTests	每個測試回合在執行中。
	Type	取得這個測試回合的類型。
	UnanalyzedTests	未分析測試數目。
	Version	取得已執行測試的用戶端版本。

回頁首

方法

	名稱	說明
	Abort()	中止這個測試回合。
	Abort(TestRunAbortOptions)	使用指定的選項，中止這個測試回合。
	AddTest(String)	將具有指定名稱的新測試。必須由 Save() 遵循
	AddTest(Int32, Int32, TeamFoundationIdentity)	在測試回合中加入測試案例和組態。
	AddTest(Int32, String, String, ITmiTestImplementation)	在測試回合中建立新的測試結果物件測試組態。不需要測試結果的現有測試案例。必須由 Save() 後面。
	AddTestPoint	在這個測試回合中加入新的測試點。
	AddTestPoints	若要在測試回合中新的測試點。必須由 Save() 後面。由呼叫傳回的測試結果物件不可用於儲存之後。
	CopyTestSettings	複製測試設定，並將其與測試回合產生關聯。 (繼承自 ITestRunBase)。
	CreateAttachment(String)	從檔案建立附件。 (繼承自 IAttachmentOwner)。
	CreateAttachment(String, SourceFileAction)	從檔案建立附件，上載之後選擇性地刪除原始檔。 (繼承自 IAttachmentOwner)。
	CreateAttachment(array<Byte[], Int32, Int32)	從位元組陣列建立測試結果的附件。 (繼承自 ITestRunBase)。
	CreateLogEntry	建立測試訊息記錄項目，並將它加入至 TestMessageLogEntryCollection。 (繼承自 ITestMessageLogOwner)。
	Delete	從伺服器中移除指定之測試回合和其結果。 (繼承自 ITestRunBase)。
	QueryResults()	傳回集合，這個集合包含這個測試回合的所有測試結果。
	QueryResults(Boolean)
	QueryResultsByOutcome	傳回這個具有提供的測試結果 (Test Outcome) 之測試回合的測試結果 (Test Result) 集合。
	QueryResultsByOwner	傳回這個具有提供的測試擁有者之測試回合的測試結果集合。
	QueryResultsByStatus	傳回這個具有提供的測試狀態之測試回合的測試結果集合。
	Refresh()	使用伺服器中的新資料，更新回合。 (繼承自 ITestRunBase)。
	Refresh(DateTime)	更新資料的測試回合便會從伺服器，只有在那裡的真正 lastUpdated 參數的傳回具有較新的時間戳記的測試回合，如果測試回合則為更新為新的資料和錯誤
	RefreshLogEntries	重新整理來自伺服器的記錄項目。 (繼承自 ITestMessageLogOwner)。
	Save	將新的或更新的測試回合寫入至伺服器。 (繼承自 ITestRunBase)。
	SaveLogEntries	將變更的記錄項目儲存至伺服器。 (繼承自 ITestMessageLogOwner)。

回頁首

事件

	名稱	說明
	AttachmentUploadCompleted	這個事件會在附件上傳完成時引發。 (繼承自 IAttachmentOwner)。
	PropertyChanged	發生於屬性值變更時。 (繼承自 INotifyPropertyChanged)。