Элемент MapToIcon (View)

Статья
04/08/2023

Применимо к: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Возвращает имя файла значка, сопоставленного с данным расширением имени файла и ProgID.

<MapToIcon>
    ProgID|File_Extension
</MapToIcon>

Элементы и атрибуты

В разделах ниже приводится описание атрибутов, дочерних и родительских элементов.

Атрибуты

Нет

Дочерние элементы

Многочисленные

Родительские элементы

Многочисленные

Occurrences

Минимум: 0
Максимум: без ограничений

Замечания

Элемент MapToIcon использует следующий синтаксис, отделяя ProgID от расширения имени файла с помощью вертикальной черты ("|"):

<MapToIcon>ProgID|File_Extension </MapToIcon>

Этот элемент можно использовать в любом сценарии визуализации (например, в представлении или самостоятельном элементе в документе), но наиболее полезен он в представлении библиотеки документов.

Например, отрисовывает файл Microsoft Excel .gif, <MapToIcon>|xls</MapToIcon> определенный в элементе ByExtension файлаDocIcon.xml , и с помощью <MapToIcon>Excel.Sheet|htm</MapToIcon> отрисовывает файл Excel .gif, определенный в элементе ByProgID DocIcon.xml, но <MapToIcon>CustomApp.Baz|htm</MapToIcon> отрисовывает универсальный значок HTML, так как ProgID "CustomApp.Baz" неизвестен.

Обратите внимание, что набор поддерживаемых расширений имен файлов и идентификаторов ProgID может быть расширяемым системным администратором. Их можно изменить в DocIcon.xml, а затем файлы изображений можно включить в \TEMPLATES\1033 каталог. После такого изменения необходимо перезапустить Microsoft IIS (IIS). Впоследствии все новые веб-сайты на основе Microsoft SharePoint Foundation будут поддерживать новые типы файлов и отображать правильные значки. Количество значков и идентификаторов ProgID , которые могут поддерживаться, ограничено только системными ресурсами (память и дисковое пространство).

Пример

Следующий пример создает связанный значок приложения, возникающий на панели инструментов в представлении изменения свойств элемента библиотеки документов. В примере элемент MapToIcon используется для построения URL-адреса значка на основе расширения имени файла документа и идентификатора ProgID приложения, сопоставленного с документом.

<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>

Поделиться через