<CustomAction> (RibbonDiffXml)

应用到: CRM 2016 on-prem, CRM Online

定义用于添加或替换功能区中的项的操作。

语法

<CustomAction 
 Id="String"
 Location="String"
 Sequence="Integer"
 Title="String">
 <CommandUIDefinition />
</CustomAction>

The following table lists the attributes, child elements, and parent elements.

Attribute	Description	Type	Usage
Id	指定功能区元素的定义的唯一标识符。强烈建议的命名约定是使用句点分隔名称的各个部分，如：[解决方案标识符].[实体].[功能区].[函数].[元素名称]。例如：MyISV.account.form.SendToOtherSystem.Button。 The recommended naming convention is to use a period to separate consistent components like so: <solution identifier>.<entity>.<ribbon>.<function>.<element name>. For example: MyISV.account.form.SendToOtherSystem.CustomAction.	String	Optional
Location	References the Id of an existing ribbon element that contains the modification defined in the CustomAction. To add a new ribbon element, refer to the containing element Id and include the suffix ”._children”.	String	Optional
Sequence	通过将序列值设置为高于或低于现有功能区元素来指定功能区修改内容的位置。	Integer	Optional
Title	本元素不用于 Microsoft Dynamics CRM。	String	Optional

Element	Description
<CommandUIDefinition> (RibbonDiffXml)	指定要包含在 CustomAction 元素中的可见 Ribbon 元素。

Element	Description
<CustomActions> (RibbonDiffXml)	包含一个可添加、替换或删除功能区中的项的操作的集合。

XPath	`//RibbonDiffXml/CustomActions/CustomAction`
Schema Name	CustomActionType
Validation File	RibbonCore.xsd
Can be Empty	No