WHENNOT 元素（工作项类型定义架构）

更新：2007 年 11 月

指定将一个或多个规则应用于当前字段的条件。该规则可在其他字段不包含特定值时应用于当前字段。父元素用于定义当前字段。

<xs:element name="WHENNOT" type="FieldValueCondition"/>

属性和元素

下面几节描述了定义 WHENNOT 元素的属性和子元素，还描述了定义 WHENNOT 元素的应用方式的父元素。您必须至少定义一个子元素。

属性

属性	说明
field	必需的属性。 标识根据此元素中将应用到当前字段的规则，必须具有指定值的字段。 您可以按字段引用名称来指定此属性。有关引用名称的更多信息，请参见 FIELD 元素（WORKITEMTYPE 元素）。
value	必需的属性。 指定根据此元素中将应用到当前字段的规则，field 属性标识的字段所不得包含的值。

子元素

元素	说明
REQUIRED 元素（工作项类型定义架构）	可选。 指定当 field 属性标识的字段不包含指定值时，当前字段（包含 WHENNOT 元素的字段）必须包含一个值。
READONLY 元素（工作项类型定义架构）	可选。 指定当 field 属性标识的字段不包含指定值时，当前字段为只读。
EMPTY 元素（工作项类型定义架构）	可选。 指定当 field 属性标识的字段不包含指定值时，当前字段不得包含值。
FROZEN 元素（工作项类型定义架构）	可选。 指定当 field 属性标识的字段不包含指定值时，当前字段将被冻结。提交更改后，不能将冻结的字段更改为任何非空值。但是，您可以手动清除此字段，保存工作项，然后指定其他值。
CANNOTLOSEVALUE 元素（工作项类型定义架构）	可选。 指定当 field 属性标识的字段的值未发生更改时，不能清除当前字段，也不能在该字段获得值后将它清空。
NOTSAMEAS 元素（工作项类型定义架构）	可选。 指定当 field 属性标识的字段不包含指定值时，当前字段的值不能与第三方字段的值匹配。在 NOTSAMEAS 元素中指定第三个字段。
VALIDUSER 元素（工作项类型定义架构）	可选。 指定当 field 属性标识的字段不包含指定值时，允许值的列表必须仅包含系统中有效的用户。
ALLOWEXISTINGVALUE 元素（工作项类型定义架构）	可选。 指定当 field 属性标识的字段不包含指定值时，允许使用已经存在的当前字段的值，即使该值违反其他规则也是如此。如果当前字段的值发生更改，则该元素不适用。
MATCH 元素（工作项类型定义架构）	可选。 指定当 field 属性标识的字段不包含指定值时，当前字段的值必须与指定模式匹配。
ALLOWEDVALUES 元素（工作项类型定义架构）	可选。 指定当 field 属性标识的字段不包含指定值时，当前字段必须包含一个由指定值列表提供的值。允许的值指工作项窗体上以及查询生成器中的字段列表中可供选择的值。必须从这些值中选择一个。
SUGGESTEDVALUES 元素（工作项类型定义架构）	可选。 指定当 field 属性标识的字段不包含指定值时，指定列表包含当前字段的建议值。建议的值指工作项窗体上以及查询生成器中的字段列表中可供选择的值。您可以输入列表中可用值以外的其他值。
PROHIBITEDVALUES 元素（工作项类型定义架构）	可选。 指定当 field 属性标识的字段不包含指定值时，当前字段不能包含此列表中的任何值。
DEFAULT 元素（工作项类型定义架构）	可选。 指定当 field 属性标识的字段不包含指定值时，此元素为当前字段指定默认值。
COPY 元素（工作项类型定义架构）	可选。 指定当 field 属性标识的字段不包含指定值时，来自第三个字段的值将自动复制到当前字段。在 COPY 元素中指定第三个字段。
SERVERDEFAULT 元素（工作项类型定义架构）	可选。 指定当 field 属性标识的字段不包含指定值时，当前字段使用来自指定服务器组件的值。该服务器组件是“clock”（表示更新工作项的时间）和“currentuser”（表示更新工作项的用户标识）。

父元素

元素	说明
FIELD 元素（工作项类型定义架构）	必需。 引用一个工作项字段定义以及应用到该字段的规则和条件。该引用基于 STATE、TRANSITION、DEFAULTREASON 或 REASON 元素，引用的父 FIELDS 元素是这些元素的子元素。
FIELD 元素（WORKITEMTYPE 元素）	必需。 定义一个工作项字段，并指定应用到该字段的规则和条件。

备注

WHENNOT 是 FIELD（工作项类型定义架构）和 FIELD（WORKITEMTYPE 元素）的可选子元素。

示例

<WHENNOT field="field reference name" value="value">
    <REQUIRED>…</REQUIRED>
    <READONLY>…</READONLY>
    <EMPTY>…</EMPTY>
    <FROZEN>…</FROZEN>
    <CANNOTLOSEVALUE>…</CANNOTLOSEVALUE>
    <NOTSAMEAS>…</NOTSAMEAS>
    <VALIDUSER>…</VALIDUSER>
    <ALLOWEXISTINGVALUE>…<ALLOWEXISTINGVALUE>
    <MATCH>…</MATCH>
    <ALLOWEDVALUES>…</ALLOWEDVALUES>
    <SUGGESTEDVALUES>…</SUGGESTEDVALUES>
    <PROHIBITEDVALUES>…</PROHIBITEDVALUES>
    <DEFAULT>…</DEFAULT>
    <COPY>…</COPY>
    <SERVERDEFAULT>…</SERVERDEFAULT>
</WHENNOT>

元素信息

命名空间	https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typedef
架构名称	工作项类型定义
验证文件	WorkItemTypeDefinition.xsd
元素类型	FieldValueCondition 复杂类型（工作项类型定义架构）
是否可以为空	否

请参见

其他资源

工作项类型定义架构

字段条件