查询字段、运算符、值和变量
更新：2010 年 7 月
创建查询来搜索 Visual Studio Team Foundation Server 2010 中的工作项时，可定义一个或多个子句来标识要查找的工作项集。 对于每个子句，可指定字段、运算符以及值或变量。 例如，通过指定“团队项目”字段、等号 (=) 运算符，并指定特定团队项目的名称作为值，可以搜索该项目中的所有工作项。 可以指定表示当前团队项目的变量（如 @Project）而不是指定值。
示例查询子句
And/Or |
字段 |
运算符 |
值 |
And |
团队项目 |
= |
@Project |
有关查询的更多常规信息，请参见查找 Bug、任务和其他工作项。 有关如何使用键盘快捷方式在查询编辑器或查询视图中进行导航的信息，请参见查询编辑器和查询结果视图的键盘快捷键。
主题内容
And/Or
查询字段和值
查询运算符
查询变量
有关如何定义查询子句的检查表：
在第一个空行中，单击“字段”列标题下方，单击下箭头以显示可用字段的列表，然后单击列表中的项。
有关更多信息，请参见查询字段和值。
在同一行中，单击“运算符”列标题下方，单击下箭头以显示可用运算符的列表，然后单击列表中的项。
有关更多信息，请参见运算符。
在同一行中，单击“值”列标题下方。
键入值，或单击下箭头，然后单击列表中的项。
有关如何使用变量指定当前团队项目、用户或日期的更多信息，请参见变量。
若要添加子句，请单击**“单击此处添加新子句”**。
可根据需要向查询末尾添加子句、在现有子句后插入子句 (
.gif "插入查询子句")
)、删除子句 (.gif "删除查询子句")
)、分组 (.gif "将查询子句分组")
) 以及取消分组 (.gif "将查询子句取消分组")
)。 还可以将子句的内容复制并粘贴到新位置。 有关更多信息，请参见指定查询筛选条件。
And/Or
可使用此列指定如何测试子句。 如果要查找同时满足此子句和前一个子句中条件的工作项，则可指定**“与”。 如果要查找满足此子句或前一个子句中条件的工作项，则可指定“或”**。
查询字段和值
为每个字段指定值时，该值必须符合该字段的数据类型。 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 过程模板定义的字段。
查询运算符 |
如果工作项中的值与列出的条件匹配，则返回工作项 |
适用的数据类型 |
|---|---|---|
= |
与子句中的值匹配。 |
数字、文本、日期和树 |
<> |
与子句中的值不匹配。 |
数字、文本、日期和树 |
> |
大于子句中的值。 |
数字、文本和日期 |
< |
小于子句中的值 |
数字、文本和日期 |
>= |
大于或等于子句中的值。 |
数字、文本和日期 |
<= |
小于或等于子句中的值。 |
数字、文本和日期 |
=[字段] |
与指定字段中包含的值匹配 |
与指定字段具有相同数据类型的字段的名称 |
<>[字段] |
与指定字段中包含的值不匹配 |
与指定字段具有相同数据类型的字段的名称 |
>[字段] |
大于指定字段中包含的值 |
与指定字段具有相同数据类型的字段的名称 |
<[字段] |
小于指定字段中包含的值 |
与指定字段具有相同数据类型的字段的名称 |
>=[字段] |
大于或等于指定字段中包含的值 |
与指定字段具有相同数据类型的字段的名称 |
<=[字段] |
小于或等于指定字段中包含的值 |
与指定字段具有相同数据类型的字段的名称 |
包含 |
包含子句中的文本值。 |
文本 |
不包含 |
不包含子句中的文本值。 |
Text |
在 ... 中 |
与分隔的集合中的任何值匹配。 例如，如果为 ID 字段指定值 100、101 和 102，则可查找 ID 为这些值的工作项。 .gif "重要说明") 重要事项
用列表分隔符分隔值，列表分隔符与为您的客户端计算机定义的区域设置相对应。例如，可以使用逗号 (,)。
|
数字、文本、日期和树 |
在组中 |
与作为子句中组的成员的值匹配。 可以在 Team Foundation Server 中指定默认组、自定义组或类别组。 例如，您可以创建一个查询，用来查找分配给 Contributors 组成员的所有工作项。 .gif "注意") 注意
不能将安全组或电子邮件通讯组指定为一个值。
|
与 Team Foundation Server 中的用户组或类别组的名称相匹配的字符串。 注意
只能将“在组中”运算符用于使用字符串数据类型的字段或“工作项类型”字段。
有关类别组的信息，请参见将工作项类型分组到类别中。 |
不在组中 |
与作为子句中组的成员的值不匹配。 |
与 Team Foundation Server 中的用户组或类别组的名称相匹配的字符串 注意
只能将“不在组中”运算符用于使用字符串数据类型的字段或“工作项类型”字段。
有关类别组的信息，请参见将工作项类型分组到类别中。 |
曾是 |
在以前任意时间与子句中的值匹配。 |
文本和日期 |
其下 |
与子句中的值匹配或包含在子句中节点之下。 |
树 |
不在其下 |
与子句中的值不匹配并且未包含在子句中节点之下。 |
树 |
返回页首
查询变量
可使用下表中的变量查找与当前用户、当前项目或当前日期相关的工作项。
查询变量 |
用法 |
|---|---|
@Me |
使用此变量可在包含用户别名的字段中自动搜索当前用户的别名。 例如，如果将“字段”列设置为“激活者”，将“运算符”列设置为“=”，将“值”列设置为 @Me，则可查找您打开的工作项。 |
@Project |
使用此变量可搜索当前团队项目中的工作项。 例如，如果将“字段”列设置为“团队项目”，将“运算符”列设置为“=”，将“值”列设置为 @Project，则可查找当前团队项目中的所有工作项。 |
@Today |
使用此变量可搜索与当前日期或更早日期相关的工作项。 还可以通过减去天数来修改 @Today 变量。 例如，如果将“字段”列设置为“激活日期”，将“运算符”列设置为“>=”，将“值”列设置为 @Today - 7，则可查找上周激活的所有项。 |
[Any] |
使用此变量可搜索为特定字段定义的任何值的相关工作项。 |
返回页首
请参见
任务
概念
其他资源
修订记录
日期 |
修订记录 |
原因 |
|---|---|---|
|
2010 年 7 月 |
更正了指定多个值时使用的分隔符的相关信息。 |
客户反馈 |
|
2010 年 9 月 |
更正了可为“在组中”和“不在组中”运算符指定的值的相关信息。 |
客户反馈 |