Добавление сопоставлений <MIME статического содержимого mimeMap>
Общие сведения
Элемент <mimeMap>
<staticContent> добавляет уникальный тип MIME в коллекцию статических типов контента. Каждая <mimeMap>
запись должна состоять из двух частей:
- Уникальное расширение имени файла, заданное атрибутом fileExtension , например ".txt", ".png" и т. д.
- Тип MIME для расширения имени файла, указанного атрибутом mimeType , например text/plain, image/jpg и т. д.
Примечание
IIS 7 не возвращает типы файлов, которые не добавлены в <staticContent>
элемент или имеют сопоставления в элементе <handlers>
по умолчанию. Такое поведение предотвращает несанкционированный доступ к файлам, которые не имеют сопоставлений в параметрах конфигурации IIS 7.
Совместимость
Версия | Примечания |
---|---|
IIS 10.0 | Элемент <mimeMap> не был изменен в IIS 10.0. |
IIS 8,5 | Элемент <mimeMap> не был изменен в IIS 8.5. |
IIS 8,0 | Элемент <mimeMap> не был изменен в IIS 8.0. |
IIS 7,5 | Элемент <mimeMap> не был изменен в IIS 7.5. |
IIS 7.0 | Элемент <mimeMap> элемента появился <staticContent> в IIS 7.0. |
IIS 6,0 | Элемент <mimeMap> заменяет свойство метабазы MimeMap IIS 6.0. |
Настройка
Элемент <mimeMap>
<staticContent>
элемента включен в установку IIS 7 по умолчанию.
Инструкции
Добавление типа MIME на веб-сайт или приложение
Откройте диспетчер служб IIS.
Если вы используете Windows Server 2012 или Windows Server 2012 R2:
- На панели задач щелкните диспетчер сервера, инструменты, а затем диспетчер служб IIS.
Если вы используете Windows 8 или Windows 8.1:
- Удерживая нажатой клавишу Windows, нажмите букву X и щелкните панель управления.
- Щелкните Администрирование, а затем дважды щелкните диспетчер служб IIS.
Если вы используете Windows Server 2008 или Windows Server 2008 R2:
- На панели задач нажмите кнопку Пуск, наведите указатель на пункт Администрирование, а затем щелкните Диспетчер служб IIS.
Если вы используете Windows Vista или Windows 7:
- На панели задач нажмите кнопку Пуск, а затем выберите пункт панель управления.
- Дважды щелкните элемент Администрирование, а затем дважды щелкните диспетчер служб IIS.
В области Подключения перейдите к сайту, приложению или каталогу, для которых требуется добавить тип MIME.
В области Типы MIME нажмите кнопку Добавить... в области Действия .
В диалоговом окне Добавление типа MIME добавьте расширение имени файла и тип MIME, а затем нажмите кнопку ОК.
Конфигурация
Атрибуты
Атрибут | Описание |
---|---|
fileExtension |
Обязательный строковый атрибут. Задает уникальное расширение имени файла для типа MIME. Полный список значений по умолчанию см. в разделе Конфигурация по умолчанию далее в этом разделе. |
mimeType |
Обязательный строковый атрибут. Указывает тип файла и приложение, которое использует этот тип расширения имени файла. Полный список значений по умолчанию см. в разделе Конфигурация по умолчанию далее в этом разделе. |
Дочерние элементы
Отсутствует.
Образец конфигурации
Следующий пример конфигурации добавляет типы файлов для сообщений MIDI System Exclusive (Sysex) и guitar tablature (TAB) в IIS, что позволяет клиентам скачивать эти типы файлов.
<configuration>
<system.webServer>
<staticContent>
<mimeMap fileExtension=".syx" mimeType="application/octet-stream" />
<mimeMap fileExtension=".tab" mimeType="text/plain" />
</staticContent>
</system.webServer>
</configuration>
Пример кода
В следующих примерах кода типы файлов сообщений MIDI System Exclusive (Sysex) и Guitar Tablature (TAB) добавляются в IIS, что позволяет клиентам скачивать эти типы файлов.
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()