通过

MapToIcon 元素 (视图)

  • 项目

适用于： SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013

返回与给定的文件扩展名和 ProgID 关联的图标的文件名。

<MapToIcon>
    ProgID|File_Extension
</MapToIcon>

元素和属性

下面各部分介绍了属性、子元素和父元素。

Attributes

无

子元素

众多

父元素

众多

出现次数

  • 最小值：0
  • 最大值：无限制

备注

MapToIcon 元素使用下面的语法，用竖线符号 ("|") 将 ProgID 与文件扩展名分开。

<MapToIcon>ProgID|File_Extension </MapToIcon>

此元素可以在任何呈现方案中使用（例如，视图中或作为文档中的独立元素），但是它在文档库的视图中最有用。

例如， <MapToIcon>|xls</MapToIcon> 呈现在DocIcon.xml文件的 ByExtension 元素中定义的 Microsoft Excel .gif 文件，并使用 <MapToIcon>Excel.Sheet|htm</MapToIcon> 呈现在 DocIcon.xml 的 ByProgID 元素中定义的 Excel .gif 文件，但 <MapToIcon>CustomApp.Baz|htm</MapToIcon> 会呈现通用 HTML 图标，因为 ProgID“CustomApp.Baz”未知。

请注意，受支持的文件扩展名和 ProgIDs 集可由系统管理员扩展。 可以在DocIcon.xml中编辑它们，然后图像文件可以包含在 \TEMPLATES\1033 目录中。 进行此修改之后，必须重新启动 Microsoft Internet Information Services (IIS)。 随后，任何基于 Microsoft SharePoint Foundation 的新网站都将支持新文件类型并显示正确的图标。 可以支持的图标和 ProgIDs 的数目仅受系统资源（内存和磁盘空间）的限制。

示例

下面的示例创建一个具有链接的应用程序图标，该图标显示在文档库项的编辑属性视图中的工具栏上。 该示例使用 MapToIcon 元素以基于文档的文件扩展名和与文档关联的应用程序的 ProgID 构造图标的 URL。

<HTML><![CDATA[
   <a tabindex=2 class="ms-toolbar" target=_self href="javascript:"
    onclick="javascript:editDocumentWithProgID2(' ]]>
</HTML>
<ScriptQuote NotAddingQuote="TRUE">
   <Field Name="ServerUrl" URLEncodeAsURL="TRUE" />
</ScriptQuote>
<HTML><![CDATA[ ',' ]]></HTML>
<GetVar Name="ProgID" />
<HTML><![CDATA[ ',' ]]></HTML>
<GetVar Name="Editor" />
<HTML><![CDATA[ ');javascript:return false;" ACCESSKEY=I
   ID=diidEditItem> <IMG BORDER=0 ALT=" ]]>
</HTML>
<HTML>Icon</HTML>
<HTML><![CDATA[ " SRC=" ]]></HTML>
<ImagesPath />
<MapToIcon>
   <Column Name="HTML_x0020_File_x0020_Type" />
   <HTML>|</HTML>
   <Column Name="File_x0020_Type" />
</MapToIcon>
<HTML><![CDATA[ "></a>]]></HTML>