Share via

ByExtension Element

  • Article

The ByExtension element defines icons for documents according to their file name extensions.

Syntax

<ByExtension>
</ByExtension>

Element Relationships

Parent Elements Child Elements
DocIcons Mapping

Remarks

This element is used in the DOCICON.XML file to drive mapping between file extensions and their corresponding document library icons.

In general, there are two ways that mapping can be performed: by extension (for example, the ByExtension element can be used to map .xls to the appropriate icon for a Microsoft Excel file) and by ProgID (an HTML document that contains <META Name="ProgId" Content="Word.Document"> would map to an icon for Microsoft Word by using the ByProgID element).

If you want the document library feature to support a new file extension, add the extension to a ByExtension section and then restart the server.

Example

The following example defines file icons by both ProgIDs and file extensions, but it also sets a default icon for new documents.

<DocIcons>
  <ByProgID>
    <Mapping Key="Excel.Sheet" Value="ichtmxls.gif"/>
    <Mapping Key="PowerPoint.Slide" Value="ichtmppt.gif"/>
    <Mapping Key="Word.Document" Value="ichtmdoc.gif"/>
  </ByProgID>
  <ByExtension>
    <Mapping Key="doc" Value="icdoc.gif"/>
    <Mapping Key="gif" Value="icgif.gif"/>
    <Mapping Key="htm" Value="ichtm.gif"/>
    <Mapping Key="html" Value="ichtm.gif"/>
    <Mapping Key="ppt" Value="icppt.gif"/>
  </ByExtension>
  <Default>
    <Mapping Value="icgen.gif"/>
  </Default>
</DocIcons>