Condividi tramite

Aggiunta di mapping <MIME del contenuto statico mimeMap>

  • Articolo

Panoramica

L'elemento <mimeMap> dell'elemento <staticContent> aggiunge un tipo MIME univoco alla raccolta di tipi di contenuto statici. Ogni <mimeMap> voce deve essere costituita da due parti:

  • Estensione di file univoca specificata dall'attributo fileExtension , ad esempio ".txt", ".png" e così via.
  • Tipo MIME per l'estensione del nome file specificato dall'attributo mimeType , ad esempio "text/plain", "image/jpg" e così via.

Nota

IIS 7 non restituirà i tipi di file che non vengono aggiunti all'elemento <staticContent> o che dispongono di mapping nell'elemento <handlers> per impostazione predefinita. Questo comportamento impedisce l'accesso non autorizzato ai file che non dispongono di mapping nelle impostazioni di configurazione di IIS 7.

Compatibilità

Versione Note
IIS 10.0 L'elemento <mimeMap> non è stato modificato in IIS 10.0.
IIS 8,5 L'elemento <mimeMap> non è stato modificato in IIS 8.5.
IIS 8,0 L'elemento <mimeMap> non è stato modificato in IIS 8.0.
IIS 7,5 L'elemento <mimeMap> non è stato modificato in IIS 7.5.
IIS 7.0 L'elemento <mimeMap> dell'elemento <staticContent> è stato introdotto in IIS 7.0.
IIS 6.0 L'elemento <mimeMap> sostituisce la proprietà metabase MimeMap di IIS 6.0.

Installazione

L'elemento <mimeMap> dell'elemento è incluso nell'installazione <staticContent> predefinita di IIS 7.

Procedure

Come aggiungere un tipo MIME a un sito Web o a un'applicazione

  1. Aprire Gestione Internet Information Services (IIS):

    • Se si usa Windows Server 2012 o Windows Server 2012 R2:

      • Sulla barra delle applicazioni fare clic su Server Manager, scegliere Strumenti, quindi fare clic su Gestione Internet Information Services (IIS).

    • Se si usa Windows 8 o Windows 8.1:

      • Tenere premuto il tasto Windows, premere la lettera X e quindi fare clic su Pannello di controllo.
      • Fare clic su Strumenti di amministrazione, quindi fare doppio clic su Gestione Internet Information Services (IIS).

    • Se si usa Windows Server 2008 o Windows Server 2008 R2:

      • Sulla barra delle applicazioni fare clic su Start, scegliere Strumenti di amministrazione, quindi fare clic su Gestione Internet Information Services (IIS).

    • Se si usa Windows Vista o Windows 7:

      • Sulla barra delle applicazioni fare clic su Start e quindi su Pannello di controllo.
      • Fare doppio clic su Strumenti di amministrazione, quindi fare doppio clic su Gestione Internet Information Services (IIS).

  2. Nel riquadro Connessioni passare al sito, all'applicazione o alla directory per cui si vuole aggiungere un tipo MIME.

  3. Nel riquadro Home fare doppio clic su Tipi MIME.
    Screenshot che mostra il riquadro Home del sito Web predefinito. È selezionata l'opzione Tipi MIME.

  4. Nel riquadro Tipi MIME fare clic su Aggiungi... nel riquadro Azioni .
    Screenshot che mostra il riquadro Tipi MIME.

  5. Nella finestra di dialogo Aggiungi tipo MIME aggiungere l'estensione del nome file e il tipo MIME e quindi fare clic su OK.
    Screenshot che mostra la finestra di dialogo Aggiungi tipo MIME. La scheda viene immessa nella casella Estensione nome file. La barra di testo normale viene immessa nella casella di testo TIPO MIME.

Configurazione

Attributi

Attributo Descrizione
fileExtension Attributo stringa obbligatorio.

Specifica un'estensione di file univoca per un tipo MIME.

Vedere la sezione Configurazione predefinita più avanti in questo argomento per l'elenco completo dei valori predefiniti
mimeType Attributo stringa obbligatorio.

Specifica il tipo di file e l'applicazione che usa questo tipo di estensione del nome file.

Vedere la sezione Configurazione predefinita più avanti in questo argomento per l'elenco completo dei valori predefiniti.

Elementi figlio

Nessuno.

Esempio di configurazione

Nell'esempio di configurazione seguente vengono aggiunti i tipi di file per i file MIDI System Exclusive (Sysex) e Guitar Tablature (TAB) a IIS, consentendo così ai client di scaricare questi tipi di file.

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

Codice di esempio

Gli esempi di codice seguenti aggiungono i tipi di file per i file MIDI System Exclusive (Sysex) e Guitar Tablature (TAB) a IIS, consentendo così ai client di scaricare questi tipi di file.

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()