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

Общие сведения о файлах DocIcon.xml

  • Статья

Дата последнего изменения: 1 декабря 2010 г.

Применимо к: SharePoint Foundation 2010

Файл DocIcon.xml присутствует на каждом интерфейсном веб-сервере в развертывании Microsoft SharePoint Foundation. Этот файл позволяет задать значки, которые отображаются для конкретных типов файлов, доступных для отправки в список или библиотеку документов, и, при необходимости, задать использование элемента управления ActiveX для открытия файла.

Функции файла DocIcon.xml

На каждом интерфейсном веб-сервере в развертывании SharePoint Foundation файл DocIcon.xml располагается по следующему пути:

%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\XML\DocIcon.xml

Этот файл используется для сопоставления типов файлов со следующими компонентами:

  • Значок документа, представляющий тип файла в списках и результатах поиска.

  • (Необязательно) Элемент управления ActiveX, который открывает файл этого типа для просмотра и редактирования.

  • (Необязательно) Текст, отображаемый в раскрывающихся меню в качестве элемента редактирования ("Изменить в имя приложения”) для файла, отправленного в список.

Параметры в файле DocIcon.xml являются глобальными для развертывания SharePoint Foundation и влияют на все определения сайта на всех интерфейсных веб-серверах. Каждое расширение имени файла или программный идентификатор может сопоставляться только с одним элементом редактирования, одним значком и одной строкой отображаемого текста. Заданное сопоставление является одинаковым для всего развертывания SharePoint Foundation. Чтобы обеспечить поддержку дополнительных расширений имени файла и программных идентификаторов, можно добавлять дополнительные элементы сопоставления.

Предупреждающая заметкаВнимание!

Чтобы обеспечить синхронизацию, необходимо вносить одинаковые изменения в файл DocIcon.xml на всех интерфейсных веб-серверах. Для этого рекомендуется распространять изменения в файле DocIcon.xml в составе компонента уровня фермы. Кроме того, следует учитывать, что изменения в файле DocIcon.xml могут быть перезаписаны при установке обновлений и пакетов обновления для SharePoint Foundation, а также при обновлении установки до следующей версии продукта.

Формат файла

Дополнительные сведения о схеме файла DocIcon.xml см. в статье Схема Document Icons. В общем случае схема поддерживает два способа сопоставления: по расширению имени файла (например, "docx") и по программному идентификатору (например, "Word.Document").

ПримечаниеПримечание

Программный идентификатор — это раздел реестра, который сопоставляет программный идентификатор объекта COM с соответствующим идентификатором класса (CLSID). Например, раздел реестра HKLM\Software\Classes\Word.Document содержит подраздел CLSID с значением {F4754C9B-64F5-4B40-8AF4-679732AC0607}. В этом случае имя раздела Word.Document представляет собой программный идентификатор. Поскольку раздел содержит подраздел со значением CLSID, можно использовать краткую форму Word.Document — {F4754C9B-64F5-4B40-8AF4-679732AC0607}. Дополнительные сведения см. в статье Ключ <ProgID> (COM) (Возможно, на английском языке).

Элемент ByProgID содержит набор элементов Mapping, которые сопоставляют программные идентификаторы различных типов файлов с значками файлов, задает текст, отображаемый для каждого типа файлов в раскрывающемся меню, которое появляется при щелчке стрелки Изменить и указывает программный идентификатор элемента управления, используемого для открытия документов данного типа. В следующем примере показана часть раздела ByProgID:

<DocIcons>
  <ByProgID>
    <Mapping
      Key="Excel.Sheet" 
      Value="ichtmxls.gif" 
      EditText="Microsoft Office Excel" 
      OpenControl="SharePoint.OpenDocuments" />
    <Mapping 
      Key="FrontPage.Editor.Document" 
      Value="ichtmfp.gif" 
      EditText="Microsoft Office FrontPage" 
      OpenControl="SharePoint.OpenDocuments" />
    ...
  </ByProgID>

Изображение, на которое ссылается атрибут Value, должно храниться в папке IMAGES на каждом интерфейсном веб-сервере по следующему пути:

%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\IMAGES

Элемент управления, на который ссылается атрибут OpenControl, должен быть развернут на каждом клиенте, который осуществляет доступ к среде SharePoint Foundation.

Элемент ByExtension сопоставляет расширения имен файлов с файлами значков, задает текст, отображаемый для каждого расширения имени файла в раскрывающемся меню, которое появляется при щелчке стрелки Изменить, и указывает программный идентификатор элемента управления, используемого для открытия документов с данным расширением имени файла. В следующем примере показана часть раздела ByExtension:

  <ByExtension>
    <Mapping
      Key="asax" 
      Value="icasax.gif" />
    <Mapping 
      Key="ascx" 
      Value="icascx.gif" />
    <Mapping 
      Key="asmx" 
      Value="icasmx.gif" />
    ...
    <Mapping 
      Key="mpp" 
      Value="icmpp.gif" 
      EditText="Microsoft Office Project" 
      OpenControl="SharePoint.OpenDocuments" /> 
    <Mapping 
      Key="mps" 
      Value="icmps.gif" /> 
    <Mapping 
      Key="mpt" 
      Value="icmpt.gif" 
      EditText="Microsoft Office Project" 
      OpenControl="SharePoint.OpenDocuments" />
    ...
  </ByExtension>

Элемент Default задает файл значка по умолчанию, используемый для типов файлов, не определенных в DocIcon.xml, как показано в следующем примере:

  <Default>
    <Mapping Value="icgen.gif" />
  </Default>
</DocIcon
ПримечаниеПримечание

С целью устранения конфликтов элемент ByProgID имеет более высокий приоритет, чем ByExtension. Тем не менее, шаблоны документов, указанные в файле определения сайта Onet.xml, работают только в отношении тех типов файлов, которые указаны в элементе ByExtension.

См. также

Концепции

Схема Document Icons

Добавление шаблона документа, типа файла и приложения редактирования к определению сайта