Condividi tramite

Aggiunta di intestazioni <personalizzate>

Panoramica

L'elemento <add> dell'elemento <customHeaders> specifica un'intestazione HTTP personalizzata che Internet Information Services (IIS) 7 restituirà nelle risposte HTTP dal server Web.

Nota

Le intestazioni HTTP sono coppie nome e valore restituite nelle risposte da un server Web. Le intestazioni di risposta personalizzate vengono inviate al client insieme all'intestazione HTTP predefinita. A differenza delle intestazioni di risposta di reindirizzamento, restituite nelle risposte solo quando si verifica il reindirizzamento, le intestazioni di risposta personalizzate vengono restituite in ogni risposta.

Compatibilità

Versione Note
IIS 10.0 L'elemento <add> non è stato modificato in IIS 10.0.
IIS 8,5 L'elemento <add> non è stato modificato in IIS 8.5.
IIS 8,0 L'elemento <add> non è stato modificato in IIS 8.0.
IIS 7,5 L'elemento <add> non è stato modificato in IIS 7.5.
IIS 7.0 L'elemento <add> dell'elemento <customHeaders> è stato introdotto in IIS 7.0.
IIS 6.0 L'elemento <customHeaders> sostituisce l'oggetto metabase HttpCustomHeaders di IIS 6.0.

Installazione

L'elemento <add> dell'elemento è incluso nell'installazione <customHeaders> predefinita di IIS 7.

Procedure

Come impostare intestazioni HTTP personalizzate per un sito Web o un'applicazione

  1. Aprire Gestione Internet Information Services (IIS):

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

      • Nella barra delle applicazioni fare clic su Server Manager, scegliere Strumenti e 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 e quindi fare doppio clic su Gestione Internet Information Services (IIS).

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

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

    • Se si usa Windows Vista o Windows 7:

      • Nella barra delle applicazioni fare clic su Start e quindi fare clic su Pannello di controllo.
      • Fare doppio clic su Strumenti di amministrazione e 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 impostare un'intestazione HTTP personalizzata.

  3. Nel riquadro Home fare doppio clic su Intestazioni di risposta HTTP.
    Screenshot della finestra I S Manager che visualizza la home page del sito Web predefinito. Icona THe per le intestazioni di risposta T T T P è evidenziata.

  4. Nel riquadro Intestazioni risposta HTTP fare clic su Aggiungi... nel riquadro Azioni .
    Screenshot della finestra I S Manager che visualizza la pagina Intestazioni di risposta H T T P.

  5. Nella finestra di dialogo Aggiungi intestazione di risposta HTTP personalizzata impostare il nome e il valore per l'intestazione personalizzata e quindi fare clic su OK.
    Screenshot della finestra di dialogo Aggiungi intestazione di risposta HTTP personalizzata.

Configurazione

Attributi

Attributo Descrizione
name Attributo stringa obbligatorio.

Specifica un nome di campo per l'intestazione di risposta personalizzata. In una risposta, un nome di campo precede il valore del campo correlato.
Value Attributo stringa facoltativo.

Specifica un valore di campo per l'intestazione di risposta personalizzata. In una risposta, un valore di campo segue il nome del campo correlato.

Elementi figlio

Nessuno.

Esempio di configurazione

L'esempio di configurazione seguente imposta un'intestazione e un valore HTTP personalizzati.

<configuration>
   <system.webServer>
      <httpProtocol>
         <customHeaders>
            <add name="X-Custom-Name" value="MyCustomValue" />
         </customHeaders>
      </httpProtocol>
   </system.webServer>
</configuration>

Nota

L'elemento predefinito <httpProtocol> seguente è configurato nel file ApplicationHost.config in IIS 7.

<httpProtocol>
   <customHeaders>
      <clear />
      <add name="X-Powered-By" value="ASP.NET" />
   </customHeaders>
   <redirectHeaders>
      <clear />
   </redirectHeaders>
</httpProtocol>

Codice di esempio

Gli esempi di codice seguenti impostano un'intestazione e un valore HTTP personalizzati.

AppCmd.exe

appcmd.exe set config "Default Web Site" -section:system.webServer/httpProtocol /+"customHeaders.[name='X-Custom-Name',value='MyCustomValue']"

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 httpProtocolSection = config.GetSection("system.webServer/httpProtocol");
         ConfigurationElementCollection customHeadersCollection = httpProtocolSection.GetCollection("customHeaders");

         ConfigurationElement addElement = customHeadersCollection.CreateElement("add");
         addElement["name"] = @"X-Custom-Name";
         addElement["value"] = @"MyCustomValue";
         customHeadersCollection.Add(addElement);

         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 httpProtocolSection As ConfigurationSection = config.GetSection("system.webServer/httpProtocol")
      Dim customHeadersCollection As ConfigurationElementCollection = httpProtocolSection.GetCollection("customHeaders")

      Dim addElement As ConfigurationElement = customHeadersCollection.CreateElement("add")
      addElement("name") = "X-Custom-Name"
      addElement("value") = "MyCustomValue"
      customHeadersCollection.Add(addElement)

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST/Default Web Site";
var httpProtocolSection = adminManager.GetAdminSection("system.webServer/httpProtocol", "MACHINE/WEBROOT/APPHOST/Default Web Site");
var customHeadersCollection = httpProtocolSection.ChildElements.Item("customHeaders").Collection;

var addElement = customHeadersCollection.CreateNewElement("add");
addElement.Properties.Item("name").Value = "X-Custom-Name";
addElement.Properties.Item("value").Value = "MyCustomValue";
customHeadersCollection.AddElement(addElement);

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST/Default Web Site"
Set httpProtocolSection = adminManager.GetAdminSection("system.webServer/httpProtocol", "MACHINE/WEBROOT/APPHOST/Default Web Site")
Set customHeadersCollection = httpProtocolSection.ChildElements.Item("customHeaders").Collection

Set addElement = customHeadersCollection.CreateNewElement("add")
addElement.Properties.Item("name").Value = "X-Custom-Name"
addElement.Properties.Item("value").Value = "MyCustomValue"
customHeadersCollection.AddElement(addElement)

adminManager.CommitChanges()
  • Last updated on