<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	為功能區元素定義指定唯一識別碼。強烈建議的命名慣例是使用句號分隔名稱的各個部分，如下：[solution identifier].[entity].[ribbon].[function].[element name]。例如：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	藉由將 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