共用方式為

新增靜態內容 MIME 對應 < mimeMap>

  • 發行項

概觀

<mimeMap>staticContent > 元素的 <元素會將唯一的 MIME 類型新增至靜態內容類型的集合。 每個 <mimeMap> 專案都必須包含兩個部分：

  • fileExtension屬性所指定的唯一副檔名，例如「.txt」、「.png」。
  • mimeType屬性所指定副檔名的 MIME 類型，例如「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 在 IIS 8.0 中未修改專案 <mimeMap> 。
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 類型新增至網站或應用程式

  1. (IIS) 管理員開啟 Internet Information Services：

    • 如果您使用 Windows Server 2012 或 Windows Server 2012 R2：

      • 在工作列上，依序按一下 [伺服器管理員]、[工具]，然後按一下 [Internet Information Services] ([IIS) 管理員]。

    • 如果您使用 Windows 8 或 Windows 8.1：

      • 按住Windows鍵，按字母X，然後按一下[主控台]。
      • 按一下 [ 系統管理工具]，然後按兩下 [Internet Information Services] ([IIS) 管理員]。

    • 如果您使用 Windows Server 2008 或 Windows Server 2008 R2：

      • 在工作列上，按一下 [ 開始]，指向 [ 系統管理工具]，然後按一下 [ Internet Information Services (IIS) 管理員]。

    • 如果您使用 Windows Vista 或 Windows 7：

      • 在工作列上，按一下 [開始]，然後按一下[主控台]。
      • 按兩下 [ 系統管理工具]，然後按兩下 [Internet Information Services] ([IIS) 管理員]。

  2. 在 [ 連線 ] 窗格中，移至您要新增 MIME 類型的月臺、應用程式或目錄。

  3. 在 [ 首頁] 窗格中，按兩下 [MIME 類型]。
    顯示 [預設網站首頁] 窗格的螢幕擷取畫面。已選取 MIME 類型。

  4. 在[MIME 類型]窗格中，按一下 [動作] 窗格中的 [新增...]。
    顯示 [MIME 類型] 窗格的螢幕擷取畫面。

  5. 在 [ 新增 MIME 類型 ] 對話方塊中，新增副檔名和 MIME 類型，然後按一下 [ 確定]。
    顯示 [新增 MIME 類型] 對話方塊的螢幕擷取畫面。索引標籤會在 [副檔名] 方塊中輸入。文字斜線純文字會在 [MIME 類型] 文字方塊中輸入。

組態

屬性

屬性 描述
fileExtension 必要的字串屬性。

指定 MIME 類型的唯一副檔名。

如需預設值的完整清單，請參閱本主題稍後的預設組態一節
mimeType 必要的字串屬性。

指定檔案類型，以及使用這種副檔名的應用程式。

如需預設值的完整清單，請參閱本主題稍後的 [預設組態] 一節。

子元素

無。

組態範例

下列組態範例會將 MIDI 系統獨佔 (Sysex) 訊息和檔案 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 系統獨佔 (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()