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. -->
  <Runtime resid="WebViewRuntime.Url">
    <!-- JavaScript file containing event handlers. This is used by Outlook on Windows. -->
    <Override type="javascript" resid="JSRuntime.Url"/>
  </Runtime>
</Runtimes>

另请参阅