Compartilhar via

Como Adicionar Mapeamentos MIME de Conteúdo Estático <mimeMap>

  • Artigo

Visão geral

O elemento <mimeMap> do elemento <staticContent> adiciona um tipo MIME exclusivo à coleção de tipos de conteúdo estático. Cada entrada <mimeMap> deve consistir em duas partes:

  • Uma extensão de nome de arquivo exclusiva especificada pelo atributo fileExtension, por exemplo, ".txt", ".png" etc.
  • Um tipo MIME para a extensão de nome de arquivo especificada pelo atributo mimeType, por exemplo, "text/plain", "image/jpg" etc.

Observação

O IIS 7 não retornará os tipos de arquivo que não são adicionados ao elemento <staticContent> ou que têm mapeamentos no elemento <handlers> por padrão. Esse comportamento impede o acesso não autorizado a arquivos que não têm mapeamentos nas configurações do IIS 7.

Compatibilidade

Versão Observações
IIS 10.0 O elemento <mimeMap> não foi modificado no IIS 10.0.
IIS 8.5 O elemento <mimeMap> não foi modificado no IIS 8.5.
IIS 8.0 O elemento <mimeMap> não foi modificado no IIS 8.0.
IIS 7.5 O elemento <mimeMap> não foi modificado no IIS 7.5.
IIS 7.0 O elemento <mimeMap> do elemento <staticContent> foi introduzido no IIS 7.0.
IIS 6,0 O elemento <mimeMap> substitui a propriedade de metabase dos IIS 6.0 MimeMap.

Instalação

O elemento <mimeMap> do elemento <staticContent> está incluído na instalação padrão do IIS 7.

Instruções

Como adicionar um tipo MIME a um site ou aplicativo

  1. Abra o Gerenciador do IIS (Serviços de Informações da Internet):

    • Caso você esteja usando o Windows Server 2012 ou o Windows Server 2012 R2:

      • Na barra de tarefas, clique em Gerenciador do Servidor, em Ferramentas e em Gerenciador do IIS (Serviços de Informações da Internet).

    • Se você estiver usando o Windows 8 ou Windows 8.1:

      • Mantenha pressionada a tecla Windows, pressione a letra X e clique em Painel de Controle.
      • Clique em Ferramentas Administrativas e clique duas vezes em Gerenciador do IIS (Serviços de Informações da Internet).

    • Caso você esteja usando o Windows Server 2008 ou o Windows Server 2008 R2:

      • Na barra de tarefas, clique em Iniciar, vá para Ferramentas Administrativas e clique em Gerenciador do IIS (Serviços de Informações da Internet).

    • Se você estiver usando o Windows Vista ou Windows 7:

      • Na barra de tarefas, clique em Iniciar e, depois, em Painel de Controle.
      • Clique duas vezes em Ferramentas Administrativas e clique duas vezes em Gerenciador do IIS (Serviços de Informações da Internet).

  2. No painel Conexões, acesse o site, o aplicativo ou o diretório para o qual você deseja adicionar um tipo MIME.

  3. No painel Página Inicial, clique duas vezes em Tipos MIME.
    Screenshot that shows the Default Web Site Home pane. MIME Types is selected.

  4. No painel Tipos MIME, clique em Adicionar... no painel Ações.
    Screenshot that shows the MIME Types pane.

  5. Na caixa de diálogo Adicionar Tipo MIME, adicione a extensão de nome de arquivo e o tipo MIME e clique em 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.

Configuração

Atributos

Atributo Descrição
fileExtension Atributo de cadeia de caracteres obrigatório.

Especifica uma extensão de nome de arquivo exclusiva para um tipo MIME.

Confira a seção Configuração padrão mais adiante neste tópico para obter a lista completa de valores padrão
mimeType Atributo de cadeia de caracteres obrigatório.

Especifica o tipo de arquivo e o aplicativo que usa esse tipo de extensão de nome de arquivo.

Confira a seção Configuração padrão mais adiante neste tópico para obter a lista completa de valores padrão.

Elementos filho

Nenhum.

Exemplo de configuração

O exemplo de configuração a seguir adiciona os tipos de arquivo para Mensagens Sysex (Exclusivo do Sistema) MIDI e arquivos Guitar Tablature (TAB) ao IIS, permitindo que os clientes baixem esses tipos de arquivo.

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

Exemplo de código

Os exemplos de código a seguir adicionam os tipos de arquivo para Mensagens Sysex (Exclusivo do Sistema) MIDI e arquivos Guitar Tablature (TAB) ao IIS, permitindo que os clientes baixem esses tipos de arquivo.

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