Conteúdo estático <staticContent>

Artigo
03/25/2024

Visão geral

O elemento <staticContent> define várias configurações relacionadas ao processamento de solicitações de arquivos estáticos no IIS (Serviços de Informações da Internet) 7.

O elemento <staticContent> contém os três atributos a seguir que especificam se o IIS 7 deve aplicar um rodapé de documento a arquivos estáticos:

O atributo enableDocFooter especifica se os rodapés do documento estão habilitados.
O atributo defaultDocFooter contém:
- Uma cadeia de caracteres de texto que o IIS 7 usará para o rodapé do documento se o atributo isDocFooterFileName estiver definido como false
- O caminho totalmente qualificado para um arquivo que contém o texto que o IIS 7 usará para o rodapé do documento se o atributo isDocFooterFileName estiver definido como true.
Conforme observado acima, o atributo isDocFooterFileName especifica se o atributo defaultDocFooter contém uma cadeia de caracteres de texto que o IIS 7 usará para o rodapé do documento ou o caminho totalmente qualificado para um arquivo que contém o texto que o IIS 7 usará para o rodapé do documento.

Observação

Por padrão, o atributo isDocFooterFileName é definido como false e bloqueado globalmente. Para usar arquivos para rodapés de documentos, você precisaria definir o atributo isDocFooterFileName como true no nível global ou desbloquear o atributo. Para saber mais sobre como bloquear e desbloquear atributos, consulte o passo a passo Como Usar o Bloqueio na Configuração do IIS 7.0.

Compatibilidade

Versão	Observações
IIS 10.0	O elemento `<staticContent>` não foi modificado no IIS 10.0.
IIS 8.5	O elemento `<staticContent>` não foi modificado no IIS 8.5.
IIS 8.0	O elemento `<staticContent>` não foi modificado no IIS 8.0.
IIS 7.5	O elemento `<staticContent>` não foi modificado no IIS 7.5.
IIS 7.0	O elemento `<staticContent>` foi introduzido no IIS 7.0.
IIS 6,0	O elemento `<staticContent>` substitui as seguintes propriedades de metabase do IIS 6.0: DefaultDocFooter EnableDocFooter

Instalação

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

Instruções

Não há interface de usuário para configurar o elemento <staticContent> para IIS 7. Para obter exemplos de como configurar o elemento <staticContent> programaticamente, confira a seção Exemplos de Código deste documento.

Configuração

Atributos

Atributo	Descrição
`defaultDocFooter`	Atributo de cadeia de caracteres opcional. Especifica o texto de rodapé padrão para cada página em um site ou o caminho de um arquivo que contém o texto de rodapé padrão. O uso pelo IIS 7 dessa propriedade depende do valor do atributo isDocFooterFileName. Observação: o rodapé personalizado só será enviado se o atributo enableDocFooter estiver definido como true.
`enableDocFooter`	Atributo booliano opcional. Especifica se o texto indicado pelo atributo defaultDocFooter aparecerá em todas as páginas estáticas de um site. O valor padrão é `false`.
`isDocFooterFileName`	Atributo booliano opcional. Especifica se a cadeia de caracteres no atributo defaultDocFooter contém um caminho de um arquivo que contém o texto de rodapé padrão para cada página da Web estática em um site. O valor padrão é `false`.

Elementos filho

Elemento	Descrição
`clientCache`	Elemento opcional. Especifica as configurações para armazenar em cache o conteúdo estático que é enviado ao cliente.
`mimeMap`	Elemento opcional. Especifica uma lista das extensões de nome de arquivo para mapeamentos MIME.

Exemplo de configuração

O exemplo de configuração a seguir habilita um rodapé de documento para conteúdo estático e adiciona um aviso de direitos autorais simples como o texto do rodapé.

<configuration>
   <system.webServer>
      <staticContent enableDocFooter="true"
         defaultDocFooter="The information in this web site is copyrighted." />
   </system.webServer>
</configuration>

Exemplo de código

Os exemplos de código a seguir habilitam um rodapé de documento para conteúdo estático e adicionam um aviso de direitos autorais simples como o texto do rodapé.

AppCmd.exe

appcmd.exe set config "Default Web Site" -section:system.webServer/staticContent /enableDocFooter:"True"

appcmd.exe set config "Default Web Site" -section:system.webServer/staticContent /defaultDocFooter:"The information in this web site is copyrighted."

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");
         staticContentSection["defaultDocFooter"] = @"The information in this web site is copyrighted.";
         staticContentSection["enableDocFooter"] = true;

         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")
      staticContentSection("defaultDocFooter") = "The information in this web site is copyrighted."
      staticContentSection("enableDocFooter") = True

      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");
staticContentSection.Properties.Item("defaultDocFooter").Value = "The information in this web site is copyrighted.";
staticContentSection.Properties.Item("enableDocFooter").Value = true;

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")
staticContentSection.Properties.Item("defaultDocFooter").Value = "The information in this web site is copyrighted."
staticContentSection.Properties.Item("enableDocFooter").Value = True

adminManager.CommitChanges()

Compartilhar via