Grundlegendes zu "DocIcon.xml"-Dateien

Letzte Änderung: Mittwoch, 1. Dezember 2010

Gilt für: SharePoint Foundation 2010

Die Datei DocIcon.xml ist auf allen Front-End-Webservern in einer Microsoft SharePoint Foundation-Bereitstellung vorhanden. Ihr Zweck ist das Bereitstellen einer Möglichkeit zum Angeben des Symbols, das für einen beliebigen angegebenen Dateityp angezeigt wird, der ggf. in eine Liste oder Dokumentbibliothek hochgeladen wird. Ferner gibt sie an, ob ein ActiveX-Steuerelement zum Öffnen der Datei verwendet werden soll.

Aufgaben von "DocIcon.xml"

Auf jedem Front-End-Webserver in einer SharePoint Foundation-Bereitstellung befindet sich DocIcon.xml im folgenden Pfad:

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

Der Zweck dieser Datei ist das Zuordnen von Dateitypen zu folgenden Elementen:

• Dem Dokumentsymbol, das einen Dateityp in Listen und Suchergebnissen darstellt.

• (Optional) Dem ActiveX-Steuerelement, das zum Öffnen einer Datei dieses Typs zum Anzeigen oder Bearbeiten dient.

• (Optional) Dem Text, der in Dropdownmenüs als Bearbeitungselement (Bearbeiten in Anwendungsname) für eine in eine Liste hochgeladene Datei angezeigt wird.

Die Einstellungen in DocIcon.xml gelten in einer SharePoint Foundation-Bereitstellung global und wirken sich auf alle Websitedefinitionen auf allen Front-End-Webservern aus. Jede Dateinamenerweiterung bzw. ProgID kann nur einem Bearbeitungssteuerelement, einem Symbol und einer Zeichenfolge mit Anzeigetext zugeordnet werden. Diese Zuordnung ist in der gesamten SharePoint Foundation-Bereitstellung identisch. Sie können zur Unterstützung weiterer Dateinamenerweiterungen und ProgIDs Zuordnungselemente hinzufügen.

Vorsicht

Wenn Sie DocIcon.xml modifizieren, müssen dieselben Änderungen auf allen Front-End-Webservern erfolgen, damit alle Server synchron bleiben. Verteilen Sie hierzu die Änderungen an DocIcon.xml am besten als Teile eines Features auf Farmebene. Darüber hinaus sollten Sie bedenken, dass Änderungen an DocIcon.xml ggf. überschrieben werden, wenn Sie für SharePoint Foundation Updates und Services Packs installieren oder ein Upgrade einer Installation auf die nächste Produktversion durchführen.

Dateiformat

Detaillierte Informationen zum Schema für DocIcon.xml finden Sie unter Schema für Dokumentsymbole. Im Wesentlichen bietet das Schema zwei Möglichkeiten der Zuordnung: nach Dateinamenerweiterung (z. B. "docx") und nach ProgId (z. B. "Word.Document").

Hinweis

Eine ProgId ist ein Registrierungseintrag, der die Programm-ID (ProgId) eines COM-Objekts dessen Klassen-ID (CLSID) zuordnet. Der Registrierungsschlüssel HKLM\Software\Classes\Word.Document hat beispielsweise den Unterschlüssel CLSID mit dem Wert {F4754C9B-64F5-4B40-8AF4-679732AC0607}. In diesem Fall ist der Schlüsselname Word.Document eine ProgId. Da der Schlüssel einen Unterschlüssel mit einem CLSID-Wert hat, können Sie Word.Document als Kurzform von {F4754C9B-64F5-4B40-8AF4-679732AC0607} verwenden. Weitere Informationen finden Sie unter <ProgId>-Schlüssel (COM).

Das ByProgID-Element enthält eine Folge von Mapping-Elementen, mit denen die Programm-IDs verschiedener Dateitypen Dateisymbolen zugeordnet werden, der Text angegeben wird, der für jeden Dateityp im Dropdownmenü angezeigt wird, wenn auf den Pfeil Bearbeiten geklickt wird, und die ProgId des Steuerelements bestimmt wird, das zum Öffnen von Dokumenten eines bestimmten Typs verwendet werden soll. Das folgende Beispiel zeigt einen Teil des Abschnitts 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>

Das Bild, auf das im Value-Attribut verwiesen wird, muss im Ordner IMAGES der einzelnen Front-End-Server im folgenden Pfad gespeichert werden:

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

Das Steuerelement, auf das das OpenControl-Attribut verweist, muss auf allen Clients bereitgestellt werden, die auf die SharePoint Foundation-Umgebung zugreifen.

Das ByExtension-Element ordnet Dateinamenerweiterungen Dateisymbolen zu, gibt den Text an, der für jede Dateinamenerweiterung im Dropdownmenü angezeigt wird, wenn auf den Pfeil Bearbeiten geklickt wird, und gibt die ProgId des Steuerelements an, das zum Öffnen von Dokumenten mit einer bestimmten Dateinameerweiterung verwendet werden soll. Das folgende Beispiel zeigt einen Teil des Abschnitts 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>

Das Default-Element gibt das für Dateitypen, die nicht in DocIcon.xml angegeben sind, zu verwendende Standardbild an. Siehe das folgende Beispiel:

  <Default>
    <Mapping Value="icgen.gif" />
  </Default>
</DocIcon

Hinweis
Zum Beheben von Konflikten hat ByProgID Vorrang vor ByExtension. In der Datei Onet.xml einer Websitedefinition angegebene Dokumentvorlagen funktionieren jedoch nur in Relation zu Dateitypen, die im ByExtension-Element angegeben sind.

Siehe auch

Konzepte

Schema für Dokumentsymbole

Gewusst wie: Hinzufügen einer Dokumentvorlage, eines Dateityps und einer Bearbeitungsanwendung zu einer Websitedefinition