Hinzufügen statischer Inhalts-MIME-Zuordnungen <mimeMap>
Ü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()