Добавление сопоставлений <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 на веб-сайт или приложение

  1. Откройте диспетчер служб 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.
  2. В области Подключения перейдите к сайту, приложению или каталогу, для которых требуется добавить тип MIME.

  3. В области Главная дважды щелкните Типы MIME.
    Снимок экрана: панель

  4. В области Типы MIME нажмите кнопку Добавить... в области Действия .
    Снимок экрана: область

  5. В диалоговом окне Добавление типа 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()