정적 콘텐츠 MIME 매핑 <mimeMap 추가>

아티클
07/19/2023

개요

<mimeMap>staticContent> 요소의< 요소는 정적 콘텐츠 형식의 컬렉션에 고유한 MIME 형식을 추가합니다. 각 <mimeMap> 항목은 다음 두 부분으로 구성되어야 합니다.

fileExtension 특성으로 지정된 고유한 파일 이름 확장명(예: ".txt", ".png" 등)입니다.
mimeType 특성으로 지정된 파일 이름 확장명(예: "text/plain", "image/jpg" 등)에 대한 MIME 형식입니다.

참고

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>` IIS 6.0 MimeMap 메타베이스 속성을 대체합니다.

설치 프로그램

<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 형식 추가 대화 상자에서 파일 이름 확장명 및 MIME 형식을 추가하고 확인을 클릭합니다.

구성

특성

attribute	Description
`fileExtension`	필수 문자열 특성입니다. MIME 형식의 고유한 파일 이름 확장명을 지정합니다. 기본값의 전체 목록은 이 항목의 뒷부분에 있는 기본 구성 섹션을 참조하세요.
`mimeType`	필수 문자열 특성입니다. 파일 형식과 이러한 종류의 파일 이름 확장명을 사용하는 애플리케이션을 지정합니다. 기본값의 전체 목록은 이 항목의 뒷부분에 있는 기본 구성 섹션을 참조하세요.

자식 요소

없음

구성 샘플

다음 구성 샘플에서는 MIDI 시스템 배타적(Sysex) 메시지 및 TAB(기타 테이블레이처) 파일에 대한 파일 형식을 IIS에 추가하여 클라이언트가 이러한 파일 형식을 다운로드할 수 있도록 합니다.

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

샘플 코드

다음 코드 샘플에서는 MIDI 시스템 배타적(Sysex) 메시지 및 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()

다음을 통해 공유