Hinzufügen statischer Inhalts-MIME-Zuordnungen <mimeMap>

Artikel
03/26/2024

Übersicht

Das <mimeMap>-Element des <staticContent>-Elements fügt der Auflistung statischer Inhaltstypen einen eindeutigen MIME-Typen hinzu. Jeder <mimeMap>-Eintrag muss aus zwei Teilen bestehen:

Eine eindeutige Dateinamenerweiterung, die durch das fileExtension-Attribut angegeben wird, z. B. „.txt“, „.png“ usw.
Ein MIME-Typ für die Dateinamenerweiterung, die durch das mimeType-Attribut angegeben wird, z. B. „text/plain“, „image/jpg“ usw.

Hinweis

IIS 7 gibt keine Dateitypen zurück, die dem <staticContent>-Element nicht hinzugefügt werden oder standardmäßig Zuordnungen im <handlers>-Element aufweisen. Dieses Verhalten verhindert nicht autorisierten Zugriff auf Dateien, die keine Zuordnungen in den IIS 7-Konfigurationseinstellungen aufweisen.

Kompatibilität

Version	Hinweise
IIS 10.0	Das `<mimeMap>` Element wurde in IIS 10.0 nicht geändert.
IIS 8.5	Das `<mimeMap>` Element wurde in IIS 8.5 nicht geändert.
IIS 8.0	Das `<mimeMap>` Element wurde in IIS 8.0 nicht geändert.
IIS 7.5	Das `<mimeMap>`-Element wurde in IIS 7.5 nicht geändert.
IIS 7.0	Das `<mimeMap>`-Element des `<staticContent>`-Elements wurde in IIS 7.0 eingeführt.
IIS 6.0	Das Element `<mimeMap>` ersetzt die IIS 6.0 MimeMap-Metabasiseigenschaft.

Setup

Das <mimeMap>-Element des <staticContent>-Elements ist in der Standardinstallation von IIS 7 enthalten.

Gewusst wie

Hinzufügen eines MIME-Typs zu einer Website oder Anwendung

Öffnen Sie den Internet Information Services (IIS) Manager:
- Wenn Sie Windows Server 2012 oder Windows Server 2012 R2 verwenden:
  - Klicken Sie auf der Taskleiste auf Server-Manager, dann auf Tools und danach auf Internetinformationsdienste-Manager (IIS).
- Wenn Sie Windows 8 oder Windows 8.1 verwenden:
  - Halten Sie die Windows-Taste gedrückt, drücken Sie den Buchstaben X, und klicken Sie dann auf Systemsteuerung.
  - Klicken Sie auf Verwaltung und doppelklicken Sie dann auf den Internetinformationsdienste (IIS) Manager.
- Wenn Sie Windows Server 2008 oder Windows Server 2008 R2 verwenden:
  - Klicken Sie auf der Taskleiste auf Start, zeigen Sie auf Verwaltung und dann auf den Internet Information Services (IIS) Manager.
- Wenn Sie Windows Vista oder Windows 7 verwenden:
  - Klicken Sie auf der Taskleiste auf Start und dann auf Systemsteuerung.
  - Doppelklicken Sie auf Verwaltung und doppelklicken Sie dann auf den Internet Information Services (IIS) Manager.
Navigieren Sie im Bereich Verbindungen zu der Site, Anwendung oder dem Verzeichnis, für das Sie einen MIME-Typ hinzufügen möchten.
Doppelklicken Sie im Startbereich auf MIME-Typen.
Klicken Sie im Bereich MIME-Typen im Bereich Aktionen auf Hinzufügen....
Fügen Sie im Dialogfeld MIME-Typ hinzufügen die Dateinamenerweiterung und den MIME-Typen hinzu, und klicken Sie dann auf OK.

Konfiguration

Attribute

Attribut	Beschreibung
`fileExtension`	Erforderliches Zeichenfolgenattribut. Gibt eine eindeutige Dateinamenerweiterung für einen MIME-Typen an. Im Abschnitt „Standardkonfiguration“ weiter unten in diesem Thema finden Sie die vollständige Liste der Standardwerte
`mimeType`	Erforderliches Zeichenfolgenattribut. Gibt den Dateityp und die Anwendung an, die diese Art von Dateinamenerweiterung verwendet. Im Abschnitt „Standardkonfiguration“ weiter unten in diesem Thema finden Sie die vollständige Liste der Standardwerte.

Untergeordnete Elemente

Keine.

Konfigurationsbeispiel

Im folgenden Konfigurationsbeispiel werden die Dateitypen für MIDI System Exclusive (Sysex)-Nachrichten und Guitar Tablature-Dateien (TAB-Dateien) zu IIS hinzugefügt, sodass Clients diese Dateitypen herunterladen können.

<configuration>
   <system.webServer>
      <staticContent>
         <mimeMap fileExtension=".syx" mimeType="application/octet-stream" />
         <mimeMap fileExtension=".tab" mimeType="text/plain" />
      </staticContent>
   </system.webServer>
</configuration>

Beispielcode

Die folgenden Codebeispiele fügen die Dateitypen für MIDI System Exclusive (Sysex)-Nachrichten und Guitar Tablature-Dateien (TAB-Dateien) zu IIS hinzu, sodass Clients diese Dateitypen herunterladen können.

AppCmd.exe

appcmd.exe set config "Default Web Site" -section:system.webServer/staticContent /+"[fileExtension='syx',mimeType='application/octet-stream']"

appcmd.exe set config "Default Web Site" -section:system.webServer/staticContent /+"[fileExtension='tab',mimeType='text/plain']"

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetWebConfiguration("Default Web Site");
         ConfigurationSection staticContentSection = config.GetSection("system.webServer/staticContent");
         ConfigurationElementCollection staticContentCollection = staticContentSection.GetCollection();

         ConfigurationElement mimeMapElement = staticContentCollection.CreateElement("mimeMap");
         mimeMapElement["fileExtension"] = @"syx";
         mimeMapElement["mimeType"] = @"application/octet-stream";
         staticContentCollection.Add(mimeMapElement);

         ConfigurationElement mimeMapElement1 = staticContentCollection.CreateElement("mimeMap");
         mimeMapElement1["fileExtension"] = @"tab";
         mimeMapElement1["mimeType"] = @"text/plain";
         staticContentCollection.Add(mimeMapElement1);

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample

   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetWebConfiguration("Default Web Site")
      Dim staticContentSection As ConfigurationSection = config.GetSection("system.webServer/staticContent")
      Dim staticContentCollection As ConfigurationElementCollection = staticContentSection.GetCollection

      Dim mimeMapElement As ConfigurationElement = staticContentCollection.CreateElement("mimeMap")
      mimeMapElement("fileExtension") = "syx"
      mimeMapElement("mimeType") = "application/octet-stream"
      staticContentCollection.Add(mimeMapElement)

      Dim mimeMapElement1 As ConfigurationElement = staticContentCollection.CreateElement("mimeMap")
      mimeMapElement1("fileExtension") = "tab"
      mimeMapElement1("mimeType") = "text/plain"
      staticContentCollection.Add(mimeMapElement1)

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST/Default Web Site";
var staticContentSection = adminManager.GetAdminSection("system.webServer/staticContent", "MACHINE/WEBROOT/APPHOST/Default Web Site");
var staticContentCollection = staticContentSection.Collection;

var mimeMapElement = staticContentCollection.CreateNewElement("mimeMap");
mimeMapElement.Properties.Item("fileExtension").Value = "syx";
mimeMapElement.Properties.Item("mimeType").Value = "application/octet-stream";
staticContentCollection.AddElement(mimeMapElement);

var mimeMapElement1 = staticContentCollection.CreateNewElement("mimeMap");
mimeMapElement1.Properties.Item("fileExtension").Value = "tab";
mimeMapElement1.Properties.Item("mimeType").Value = "text/plain";
staticContentCollection.AddElement(mimeMapElement1);

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST/Default Web Site"
Set staticContentSection = adminManager.GetAdminSection("system.webServer/staticContent", "MACHINE/WEBROOT/APPHOST/Default Web Site")
Set staticContentCollection = staticContentSection.Collection

Set mimeMapElement = staticContentCollection.CreateNewElement("mimeMap")
mimeMapElement.Properties.Item("fileExtension").Value = "syx"
mimeMapElement.Properties.Item("mimeType").Value = "application/octet-stream"
staticContentCollection.AddElement(mimeMapElement)

Set mimeMapElement1 = staticContentCollection.CreateNewElement("mimeMap")
mimeMapElement1.Properties.Item("fileExtension").Value = "tab"
mimeMapElement1.Properties.Item("mimeType").Value = "text/plain"
staticContentCollection.AddElement(mimeMapElement1)

adminManager.CommitChanges()

Freigeben über