MapToIcon-Element (View)

  • Artikel

Gilt für: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online-| SharePoint Server 2013

Gibt den Dateinamen des Symbols zurück, das einer bestimmten Dateinamenerweiterung und ProgID zugeordnet ist.

<MapToIcon>
    ProgID|File_Extension
</MapToIcon>

Elemente und Attribute

In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.

Attribute

Keine

Untergeordnete Elemente

Zahlreiche

Übergeordnete Elemente

Zahlreiche

Vorkommen

  • Minimum: 0
  • Maximum: Unbegrenzt

HinwBemerkungeneise

Das MapToIcon-Element verwendet die folgende Syntax, wobei die ProgID mithilfe eines senkrechten Strichs ("|") von der Dateinamenerweiterung getrennt wird:

<MapToIcon>ProgID|File_Extension </MapToIcon>

Dieses Element kann in jedem Renderingszenario verwendet werden (beispielsweise in einer Ansicht oder als eigenständiges Element in einem Dokument), am besten kann es jedoch in einer Ansicht einer Dokumentbibliothek verwendet werden.

Beispielsweise rendert die Microsoft Excel-.gif-Datei, <MapToIcon>|xls</MapToIcon> die im ByExtension-Element der DocIcon.xml Datei definiert ist, und die Verwendung von <MapToIcon>Excel.Sheet|htm</MapToIcon> rendert die Excel-.gif-Datei, die im ByProgID-Element von DocIcon.xml definiert ist, würde aber <MapToIcon>CustomApp.Baz|htm</MapToIcon> das generische HTML-Symbol rendern, da die ProgID "CustomApp.Baz" unbekannt ist.

Beachten Sie, dass die unterstützten Dateinamenerweiterungen und ProgIDs vom Systemadministrator erweiterbar sind. Sie können in DocIcon.xml bearbeitet werden, und dann können die Bilddateien in das \TEMPLATES\1033 Verzeichnis eingeschlossen werden. Nach einer solchen Änderung muss Microsoft-Internetinformationsdienste (IIS) neu gestartet werden. Anschließend unterstützen alle neuen Websites, die auf Microsoft SharePoint Foundation basieren, die neuen Dateitypen und zeigen die richtigen Symbole an. Die Anzahl der Symbole und ProgIDs , die unterstützt werden können, ist nur durch Systemressourcen (Arbeitsspeicher und Speicherplatz) begrenzt.

Beispiel

Mit dem folgenden Beispiel wird das verknüpfte Anwendungssymbol erstellt, das auf der Symbolleiste in der Ansicht zum Bearbeiten von Eigenschaften für ein Dokumentbibliothekselement angezeigt wird. Im Beispiel wird das MapToIcon-Element zum Konstruieren der URL des Symbols auf der Grundlage der Dateierweiterung des Dokuments und der ProgID der dem Dokument zugeordneten Anwendung verwendet.

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