Ajout de mappages MIME de contenu statique <mimeMap>

  • Article

Vue d’ensemble

L’élément <mimeMap> de l’élément <staticContent> ajoute un type MIME unique à la collection de types de contenu statique. Chaque entrée <mimeMap> doit se composer de deux parties :

  • Une extension de nom de fichier unique, qui est spécifiée par l’attribut fileExtension (par exemple, « .txt », « .png », etc.)
  • Un type MIME pour l’extension de nom de fichier, qui est spécifié par l’attribut mimeType (par exemple, « text/plain », « image/jpg », etc.)

Remarque

IIS 7 ne retourne pas les types de fichier qui ne sont pas ajoutés à l’élément <staticContent> ou qui ont des mappages dans l’élément <handlers> par défaut. Ce comportement empêche l’accès non autorisé aux fichiers qui n’ont pas de mappages définis dans les paramètres de configuration IIS 7.

Compatibilité

Version Notes
IIS 10.0 L’élément <mimeMap> n’a fait l’objet d’aucune modification dans IIS 10.0.
IIS 8.5 L’élément <mimeMap> n’a fait l’objet d’aucune modification dans IIS 8.5.
IIS 8.0 L’élément <mimeMap> n’a fait l’objet d’aucune modification dans IIS 8.0.
IIS 7.5 L’élément <mimeMap> n’a fait l’objet d’aucune modification dans IIS 7.5.
IIS 7.0 L’élément <mimeMap> de l’élément <staticContent> a été introduit dans IIS 7.0.
IIS 6.0 L’élément <mimeMap> remplace la propriété de métabase MimeMap IIS 6.0.

Programme d’installation

L’élément <mimeMap> de l’élément <staticContent> est inclus dans l’installation par défaut d’IIS 7.

Procédure

Ajouter un type MIME à un site web ou à une application

  1. Ouvrez le Gestionnaire Internet Information Services (IIS) :

    • Si vous utilisez Windows Server 2012 ou Windows Server 2012 R2 :

      • Dans la barre des tâches, cliquez sur Gestionnaire de serveur, cliquez sur Outils, puis cliquez sur Gestionnaire Internet Information Services (IIS).

    • Si vous utilisez Windows 8 ou Windows 8.1 :

      • Maintenez la touche Windows enfoncée, appuyez sur la lettre X, puis cliquez sur Panneau de configuration.
      • Cliquez sur Outils d’administration, puis double-cliquez sur Gestionnaire Internet Information Services (IIS).

    • Si vous utilisez Windows Server 2008 ou Windows Server 2008 R2 :

      • Dans la barre des tâches, cliquez sur Démarrer, pointez sur Outils d’administration, puis cliquez sur Gestionnaire Internet Services (IIS).

    • Si vous utilisez Windows Vista ou Windows 7 :

      • Dans la barre des tâches, cliquez sur Démarrer, puis cliquez sur Panneau de configuration.
      • Double-cliquez sur Outils d’administration, puis double-cliquez sur Gestionnaire Internet Services (IIS).

  2. Dans le volet Connexions, accédez au site, à l’application ou au répertoire pour lequel vous souhaitez ajouter un type MIME.

  3. Dans le volet Accueil, double-cliquez sur Types MIME.
    Screenshot that shows the Default Web Site Home pane. MIME Types is selected.

  4. Dans le volet Types MIME, dans le volet Actions, cliquez sur Ajouter...
    Screenshot that shows the MIME Types pane.

  5. Dans la boîte de dialogue Ajouter un type MIME, ajoutez l’extension de nom de fichier et le type MIME, puis cliquez sur OK.
    Screenshot that shows the Add MIME Type dialog box. Tab is entered in the File name extension box. Text slash plain is entered in the MIME type text box.

Configuration

Attributs

Attribut Description
fileExtension Attribut de chaîne requis.

Spécifie une extension de nom de fichier unique pour un type MIME.

Consultez la section Configuration par défaut plus loin dans cette rubrique pour avoir la liste complète des valeurs par défaut
mimeType Attribut de chaîne requis.

Spécifie le type de fichier et l’application qui utilise ce type d’extension de nom de fichier.

Consultez la section Configuration par défaut plus loin dans cette rubrique pour avoir la liste complète des valeurs par défaut.

Éléments enfants

Aucune.

Exemple Configuration

L’exemple de configuration suivant ajoute à IIS les types de fichier associés aux fichiers MIDI System Exclusive (Sysex) et Guitar Tablature (TAB), ce qui permet aux clients de télécharger ces types de fichier.

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

Exemple de code

Les exemples de code suivants ajoutent à IIS les types de fichier associés aux fichiers MIDI System Exclusive (Sysex) et Guitar Tablature (TAB), ce qui permet aux clients de télécharger ces types de fichier.

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