查詢欄位、運算子、值和變數
更新：2010 年 7 月
當您建立查詢來搜尋 Visual Studio Team Foundation Server 2010 中的工作項目時，可以定義一個或多個子句來識別您要尋找的工作項目集。 在每個子句中，您可以指定欄位、運算子和值或變數。 例如，若要搜尋特定 Team 專案中的所有工作項目，您可以指定 [Team 專案] 欄位、等於 (=) 運算子，並指定 Team 專案的名稱做為值。 如不指定值，您可以改為指定變數，例如表示目前 Team 專案的 @Project 變數。
範例查詢子句
及/或 |
欄位 |
運算子 |
值 |
及 |
Team 專案 |
= |
@Project |
如需查詢的一般資訊，請參閱尋找 Bug、工作和其他工作項目。 如需如何使用鍵盤快速鍵在查詢編輯器或查詢檢視內巡覽的詳細資訊，請參閱查詢編輯器和查詢結果檢視的鍵盤快速鍵。
本主題內容
及/或
查詢欄位和值
查詢運算子
查詢變數
關於如何定義查詢子句的檢查清單：
在第一行空白資料列的 [欄位] 資料行標題底下按一下，按一下向下箭號以顯示可用欄位清單，然後按一下清單中的項目。
如需詳細資訊，請參閱查詢欄位和值。
在相同資料列的 [運算子] 資料行標題底下按一下，按一下向下箭號以顯示可用運算子清單，然後按一下清單中的項目。
如需詳細資訊，請參閱運算子。
在相同資料列的 [值] 資料行標題底下按一下。
輸入值，或是按一下向下箭號再按一下清單中的項目。
如需如何使用變數指定目前的 Team 專案、使用者或日期的詳細資訊，請參閱變數。
若要加入子句，請按一下 [按一下這裡以加入新子句]。
您可以視需要在查詢結尾加入子句、在現有子句後面插入子句 (
.gif "插入查詢子句")
)，以及移動 (.gif "刪除查詢子句")
)、群組 (.gif "群組查詢子句")
) 和取消群組 (.gif "取消群組查詢子句")
) 子句。 您也可以將子句的內容複製並貼上至新位置。 如需詳細資訊，請參閱 指定查詢篩選準則。
及/或
您可以使用這個資料行指定測試子句的方式。 如果您要尋找同時符合這個子句和上一個子句中之準則的工作項目，可以指定 [且]。 如果您要尋找符合這個子句或上一個子句中之準則的工作項目，可以指定 [或]。
查詢欄位和值
指定每個欄位的值時，值必須符合該欄位的資料型別。 Team Foundation 中的所有欄位都具有下表所列的其中一種資料型別：
資料型別 |
儲存的資料 |
|---|---|
DateTime |
國際標準時間 (UTC) 時間點。 您可以指定變數 (例如 @Today 或 @Today-1)，也可以指定值 (例如 1/1/2009)。 |
Double |
實際數字，例如 0.2 或 3.5。 |
GUID |
字元字串，表示唯一 ID。 |
HTML |
支援格式化描述的文字字串。 |
Integer |
32 位元帶正負號的整數，例如 0、1、2、34。 |
PlainText |
支援長段描述的文字字串，例如針對工作項目定義的 [描述] 和 [記錄] 欄位。 您可以根據 PlainText 欄位內包含的片語或關鍵字，尋找工作項目。 |
String |
可以包含多達 255 個 Unicode 字元的文字字串。 |
TreePath |
分支狀樹狀結構，例如 [區域路徑] 或 [反覆項目路徑]。 您必須按一下可用值清單中的項目。 您可以尋找等於樹狀結構或在樹狀結構底下的工作項目。 |
回到頁首
查詢運算子
您可以使用下表中的查詢運算子，指定子句中的每個值必須與工作項目中的對應值有何關係。 如需指派給工作項目欄位之資料型別的詳細資訊，請參閱使用系統欄位和 MSF 流程範本所定義的欄位。
查詢運算子 |
當工作項目中的值符合所列的準則時，傳回工作項目 |
適用的資料型別 |
|---|---|---|
= |
符合子句中的值。 |
號碼、文字、日期、樹狀結構 |
<> |
不符合子句中的值。 |
號碼、文字、日期、樹狀結構 |
> |
大於子句中的值。 |
號碼、文字、日期 |
< |
小於子句中的值。 |
號碼、文字、日期 |
>= |
大於或等於子句中的值。 |
號碼、文字、日期 |
<= |
小於或等於子句中的值。 |
號碼、文字、日期 |
=[欄位] |
符合指定之欄位中包含的值 |
與指定之欄位屬於相同資料型別的欄位名稱 |
<>[欄位] |
不符合指定之欄位中包含的值 |
與指定之欄位屬於相同資料型別的欄位名稱 |
>[欄位] |
大於指定之欄位中包含的值 |
與指定之欄位屬於相同資料型別的欄位名稱 |
<[欄位] |
小於指定之欄位中包含的值 |
與指定之欄位屬於相同資料型別的欄位名稱 |
>=[欄位] |
大於或等於指定之欄位中包含的值 |
與指定之欄位屬於相同資料型別的欄位名稱 |
<=[欄位] |
小於或等於指定之欄位中包含的值 |
與指定之欄位屬於相同資料型別的欄位名稱 |
包含 |
包含子句中的文字值。 |
文字 |
不包含 |
不包含子句中的文字值。 |
文字 |
位於 |
符合分隔之集合中的任何值。 例如，如果您針對 ID 欄位指定 100、101 和 102，就可以找到具有這些 ID 值的工作項目。 .gif "重要事項") 重要事項
使用針對用戶端電腦定義之地區設定的對應清單分隔符號，來分隔值。例如，您可能會使用逗號 (,)。
|
號碼、文字、日期、樹狀結構 |
在群組中 |
符合子句中群組成員的值。 您可以在 Team Foundation Server 中指定預設、自訂或分類群組。 例如，您可以建立一個查詢，以尋找所有指派給 [Contributors] 群組成員的工作項目。 .gif "注意事項") 注意事項
您不能將安全性或電子郵件通訊群組指定為值。
|
符合 Team Foundation Server 使用者群組或分類群組名稱的字串。 注意事項
[在群組中] 運算子只能對使用 String 資料型別的欄位或 [工作項目類型] 欄位使用。
如需分類群組的詳細資訊，請參閱對工作項目類型進行分類。 |
不在群組中 |
不符合子句中群組成員的值。 |
符合 Team Foundation Server 使用者群組或分類群組名稱的字串。 注意事項
[不在群組中] 運算子只能對使用 String 資料型別的欄位或 [工作項目類型] 欄位使用。
如需分類群組的詳細資訊，請參閱對工作項目類型進行分類。 |
曾經是 |
之前曾符合子句中的值。 |
文字、日期 |
在其下 |
符合子句中的值或是包含在子句中的節點下。 |
樹狀結構 |
不在其下 |
不符合子句中的值而且不包含在子句中的節點下。 |
樹狀結構 |
回到頁首
查詢變數
您可以使用下表中的變數，尋找與目前使用者、目前專案或目前日期相關的工作項目。
查詢變數 |
使用方式 |
|---|---|
@Me |
使用這個變數以在包含使用者別名的欄位中自動搜尋目前使用者的別名。 例如，如果您將 [欄位] 資料行設為 [啟動者]、將 [運算子] 資料行設為 [=]，並將 [值] 資料行設為 [@Me]，就可以找到您所開啟的工作項目。 |
@Project |
使用這個變數以搜尋目前 Team 專案中的工作項目。 例如，如果您將 [欄位] 資料行設為 [Team 專案]、將 [運算子] 資料行設為 [=]，並將 [值] 資料行設為 [@Project]，就可以找到目前 Team 專案中的所有工作項目。 |
@Today |
使用這個變數以搜尋與目前日期或更早日期相關的工作項目。 您也可以減去一些天數來修改 @Today 變數。 例如，如果您將 [欄位] 資料行設為 [啟動日期]、將 [運算子] 資料行設為 [>=]，並將 [值] 資料行設為 [@Today - 7]，就可以找到上週所啟動的所有項目。 |
[Any] |
使用這個變數，以搜尋與針對特定欄位定義之任何值相關的工作項目。 |
回到頁首
請參閱
工作
概念
其他資源
變更記錄
日期 |
記錄 |
原因 |
|---|---|---|
|
2010 年 7 月 |
更正指定多個值時使用之分隔符號的資訊。 |
客戶回函。 |
|
2010 年 9 月 |
更正可指定給 [在群組中] 和 [不在群組中] 運算子之值的資訊。 |
客戶回函。 |