Override 元素

  • 项目

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

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

Runtime 元素内部的 <Override 元素必须是 RuntimeOverride 类型。><>

Override 元素没有overrideType属性<。> 差异由父元素和父元素的类型决定。 位于 Token> 元素内的<Override> 元素，其 为 ，必须为 RequirementTokenOverride 类型。<RequirementTokenxsi:type <任何其他>父元素内部或类型 LocaleToken为 的 Override 元素内的 <Override> 元素必须是 LocaleTokenOverride 类型。 有关当它是 Token> 元素的子<元素时使用此元素的详细信息，请参阅使用清单的扩展替代。

本文后面的各节将介绍每种类型。

的 Override 元素 LocaleToken

<Override> 元素表示条件，并且可以读取为“If...然后...”声明。 <如果 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>

另请参阅

的 Override 元素 RequirementToken

<Override> 元素表示条件，并且可以读取为“If...然后...”声明。 <如果 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<Override> 元素必须包含以下子元素，具体取决于外接程序类型。

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

属性

属性 类型 必需 说明
值 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>

另请参阅

的 Override 元素 Runtime

重要

邮箱 要求集 1.10 中引入了对此元素的支持，具有 基于事件的激活功能。 请查看支持此要求集的客户端和平台。

<Override> 元素表示条件，并且可以读取为“If...然后...”声明。 <如果 Override> 元素的类型为 RuntimeOverride，则 type 属性为 条件，而 resid 属性为结果。 例如，以下内容为“如果类型为 'javascript'，则 resid 为 'JSRuntime.Url'”。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 是 指定 JavaScript 文件的 URL 位置，该文件应替代在父 运行时 元素 的 中定义的默认 HTML 的 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 (preview). -->
  <Runtime resid="WebViewRuntime.Url">
    <!-- JavaScript file containing event handlers. This is used by Outlook on Windows. -->
    <Override type="javascript" resid="JSRuntime.Url"/>
  </Runtime>
</Runtimes>

另请参阅