Override 元素

提供一种根据指定条件覆盖清单设置值的方法。 有三种类型的条件：

  • 不同于默认设置 LocaleToken的 Office 区域设置，称为 LocaleTokenOverride。
  • 一种不同于默认 RequirementToken 模式的需求集支持模式，称为 RequirementTokenOverride。
  • 源不同于默认值 Runtime，称为 RuntimeOverride。

运行时>元素内<的 Override> 元素的类型必须为 RuntimeOverride。<

overrideType Override> 元素没有<任何属性。 差异由父元素和父元素的类型决定。 Token> 元素内<的 <Override> 元素，其xsi:typeRequirementToken类型必须为 RequirementTokenOverride。 任何其他父元素内的 Override 元素或类型LocaleToken为 的 Override> 元素内<的 Override> 元素的类型必须为 LocaleTokenOverride。<

每种类型将在本文后面单独的部分中介绍。

替代元素 LocaleToken

替代>元素表示<条件，可以理解为“如果......那么......”语句。 如果 Override> 元素的<类型为 LocaleTokenOverride，则Locale属性为条件，Value属性为结果。 例如，“如果 Office 区域设置为 fr-fr，则显示名称为'Lecteur vidéo'”。

<DisplayName DefaultValue="Video player">
    <Override Locale="fr-fr" Value="Lecteur vidéo" />
</DisplayName>

加载项类型：内容、任务窗格和邮件

语法

<Override Locale="string" Value="string"></Override>

包含于

元素
CitationText
说明
DictionaryName
DictionaryHomePage
DisplayName
HighResolutionIconUrl
IconUrl
图像
QueryUri
SourceLocation
String
SupportUrl
标记
Url

属性

属性 类型 必需 说明
Locale string 是 在 BCP 47 语言标记格式中指定此替代的区域设置的区域设置名称，例如 "en-US"。
值 string 是 指定表示为指定区域设置的设置的值。

示例

<DisplayName DefaultValue="Video player">
    <Override Locale="fr-fr" Value="Lecteur vidéo" />
</DisplayName>

<bt:Image id="icon1_16x16" DefaultValue="https://www.contoso.com/icon_default.png">
    <bt:Override Locale="ja-jp" Value="https://www.contoso.com/ja-jp16-icon_default.png" />
</bt:Image>

  <ExtendedOverrides Url="http://contoso.com/addinmetadata/${token.locale}/extended-manifest-overrides.json">
    <Tokens>
      <Token Name="locale" DefaultValue="en-us" xsi:type="LocaleToken">
        <Override Locale="es-*" Value="es-es" />
        <Override Locale="es-mx" Value="es-mx" />
        <Override Locale="fr-*" Value="fr-fr" />
        <Override Locale="ja-jp" Value="ja-jp" />
      </Token>
    <Tokens>
  </ExtendedOverrides>

另请参阅

替代元素 RequirementToken

替代>元素表示<条件，可以理解为“如果......那么......”语句。 如果 Override> 元素的类型为 RequirementTokenOverride，则<子 <Requirements> 元素表示条件，属性Value是结果。 例如， <下面第一个替代> 是“如果当前平台支持 FeatureOne 版本 1.7，请使用字符串'oldAddinVersion'来代替 ${token.requirements} 祖父母 <ExtendedOverrides> (的 URL 中的令牌，而不是默认字符串'upgrade') 。”

<ExtendedOverrides Url="http://contoso.com/addinmetadata/${token.requirements}/extended-manifest-overrides.json">
    <Tokens>
        <Token Name="requirements" DefaultValue="upgrade" xsi:type="RequirementsToken">
            <Override Value="oldAddinVersion">
                <Requirements>
                    <Sets>
                        <Set Name="FeatureOne" MinVersion="1.7" />
                    </Sets>
                </Requirements>
            </Override>
            <Override Value="currentAddinVersion">
                <Requirements>
                    <Sets>
                        <Set Name="FeatureOne" MinVersion="1.8" />
                    </Sets>
                    <Methods>
                        <Method Name="MethodThree" />
                    </Methods>
                </Requirements>
            </Override>
        </Token>
    </Tokens>
</ExtendedOverrides>

外接程序类型：任务窗格

语法

<Override Value="string" />

包含于

元素
标记

必须包含

根据加载项类型，替代RequirementToken元素必须包含以下子元素。<>

元素 内容 邮件 任务窗格
要求 否 否 是

属性

属性 类型 必需 说明
值 string 是 满足条件时祖父母令牌的值。

示例

<ExtendedOverrides Url="http://contoso.com/addinmetadata/${token.requirements}/extended-manifest-overrides.json">
    <Token Name="requirements" DefaultValue="upgrade" xsi:type="RequirementsToken">
        <Override Value="very-old">
            <Requirements>
                <Sets>
                    <Set Name="FeatureOne" MinVersion="1.5" />
                    <Set Name="FeatureTwo" MinVersion="1.1" />
                </Sets>
            </Requirements>
        </Override>
        <Override Value="old">
            <Requirements>
                <Sets>
                    <Set Name="FeatureOne" MinVersion="1.7" />
                    <Set Name="FeatureTwo" MinVersion="1.2" />
                </Sets>
            </Requirements>
        </Override>
        <Override Value="current">
            <Requirements>
                <Sets>
                    <Set Name="FeatureOne" MinVersion="1.8" />
                    <Set Name="FeatureTwo" MinVersion="1.3" />
                </Sets>
                <Methods>
                    <Method Name="MethodThree" />
                </Methods>
            </Requirements>
        </Override>
    </Token>
</ExtendedOverrides>

另请参阅

替代元素 Runtime

重要

基于事件的激活功能引入了对此元素的支持。 请参阅 受支持的事件列表 ，了解何时为每个 Office 应用程序中的每个事件启用支持。

替代>元素表示<条件，可以理解为“如果......那么......”语句。 如果 Override> 元素的类型为 RuntimeOverride，则<type属性为条件，resid属性为结果。 例如，以下内容是“如果类型为'javascript'，则resid为'JSRuntime.Url'”。Windows 上的 Excel、PowerPoint 和 Word 以及 Windows 上的经典 Outlook 需要此元素用于 LaunchEvent 扩展点和 ReportPhishingCommandSurface 扩展点处理程序。

<Runtime resid="WebViewRuntime.Url">
  <Override type="javascript" resid="JSRuntime.Url"/>
</Runtime>

加载项类型： 文档、邮件、演示文稿、工作簿

语法

<Override type="javascript" resid="JSRuntime.Url"/>

包含于

属性

属性 类型 必需 说明
类型 string 是 指定此覆盖的语言。 是 "javascript" 目前唯一支持的选项。
resid string 是 指定应覆盖父 运行时 元素中定义的默认 HTML 的 URL 位置的 JavaScript 文件的 residURL 位置。 字符resid不能超过 32 个字符，并且必须与元素中Resources元素的Url属性匹配id。

示例

<!-- Event-based activation and integrated spam reporting happen in a lightweight runtime.-->
<Runtimes>
  <!-- HTML file including reference to or inline JavaScript event handlers.
  This is used by Outlook on the web, on the new Mac UI, and new Outlook on Windows. -->
  <Runtime resid="WebViewRuntime.Url">
    <!-- JavaScript file containing event handlers. This is used by Outlook on Windows. -->
    <Override type="javascript" resid="JSRuntime.Url"/>
  </Runtime>
</Runtimes>

另请参阅

  • Last updated on