Coercion 元素

(Coercions 元素) (WorkflowInfo 元素) (Action4)

适用于：SharePoint Server 2013

指定用于将数据从一种窗体转换为另一种窗体的强制方法。

用法

    <Coercions>
        <Coercion />
    </Coercions>

元素信息

信息	位置
元素类型
命名空间
架构文件	Actions4.xsd

定义

    <xs:element name="Coercion"      minOccurs="0"     maxOccurs="unbounded"    >
        <xs:complexType>
            <xs:all>
                <xs:element name="Parameters"      type="coercionParametersType" minOccurs="0"     maxOccurs="1"    >
                </xs:element>
            </xs:all>
            <xs:attribute name="Name"   type="s:string"      use="required"     />
            <xs:attribute name="Assembly"   type="s:string"     />
            <xs:attribute name="DisplayName"   type="s:string"      use="required"     />
            <xs:attribute name="CatchAll"   type="s:boolean"      use="required"     />
            <xs:attribute name="RankDefault"   type="s:integer"      use="required"     />
            <xs:attribute name="SourceType"   type="s:string"     />
            <xs:attribute name="SourceFieldType"   type="s:string"     />
            <xs:attribute name="DestinationType"   type="s:string"      use="required"     />
            <xs:attribute name="DestinationFieldType"   type="s:string"     />
            <xs:attribute name="ClassName"   type="s:string"      use="required"     />
            <xs:attribute name="Id"   type="s:string"      use="required"     />
            <xs:attribute name="SourceProperty"   type="s:string"      use="required"     />
        </xs:complexType>
    </xs:element>

元素和属性

如果架构定义了特定要求（如 sequence、 minOccurs、 maxOccurs 和 choice），请参阅定义部分。

父元素

元素	类型	说明
强制

子元素

元素	类型	说明
参数	coercionParametersType

属性

属性	类型	必需	说明	可能的值
Assembly	s：string	可选	指定在其中实现强制的二进制文件。	s：string 类型的值。
CatchAll	s：boolean	必需	设置为 true 可在 DestinationType 或 DestinationFieldType 允许的情况下显示强制，而不管 SourceType 或 SourceFieldType 值如何。 设置为 false 以仅在 SourceType 或 SourceFieldType 指定应显示强制的情况下显示强制。	s：boolean 类型的值。
ClassName	s：string	必需	唯一标识由 Assembly 值指定的二进制文件中的 类。	s：string 类型的值。
DestinationFieldType	s：string	可选	强制的输出字段类型。 如果目标无法处理此类型，则不会显示强制。	s：string 类型的值。
DestinationType	s：string	必需	强制值的输出类类型。 如果目标无法处理此类型，则不会显示强制。	s：string 类型的值。
DisplayName	s：string	必需	指定强制的显示名称。	s：string 类型的值。
Id	s：string	必需	强制的唯一 guid 标识符。	s：string 类型的值。
名称	s：string	必需	强制的内部名称。	s：string 类型的值。
RankDefault	s：integer	必需	指定强制列表的排序值。	s：integer 类型的值。
SourceFieldType	s：string	可选	用于确定是否显示强制的字段类型。 如果已设置，则仅当上一个值属于匹配类型时，客户端才会显示强制，除非 SourceFieldType 或 CatchAll 另行指定。	s：string 类型的值。
SourceProperty	s：string	必需	要用于绑定到输入的活动中的参数的名称。	s：string 类型的值。
SourceType	s：string	可选	从中转换数据的类类型。 如果已设置，则仅当上一个值属于匹配类型时，客户端才会显示强制，除非 SourceFieldType 或 CatchAll 另行指定。	s：string 类型的值。

强制定义示例

在以下示例强制定义中，名称 AsDNGuidFromString 为 的强制使用活动 Microsoft.Activities.Expressions.ParseGuid 和 ParseGuid.ValueInArgument 来接受来自其他活动的输入。

    <Coercion Name="AsDNGuidFromString"
          DisplayName="As Guid"
          CatchAll="false"
          RankDefault="21"
          SourceType="System.String"
          DestinationType="System.Guid"
          Id="6682B03F-170A-461B-8DFB-D668A1C4220A"
          ClassName="Microsoft.Activities.Expressions.ParseGuid"
          Assembly="Microsoft.Activities, Version=2.0.0.0,
              Culture=neutral, PublicKeyToken=31bf3856ad364e35"
          SourceProperty="Value">