Associazioni predefinite <>

Articolo
07/19/2023

Panoramica

L'elemento <bindings> configura le informazioni di associazione predefinite per tutti i siti Web IIS 7.

Questo elemento può contenere una raccolta di <binding> elementi. Ogni elemento della raccolta definisce un set separato di informazioni di associazione che una richiesta può usare per contattare il sito Web. Ad esempio, se il sito richiede agli utenti di contattarlo usando sia il protocollo HTTP che il protocollo HTTPS, è necessario definire un'associazione per ogni protocollo.

È anche possibile usare un <clear /> elemento nell'elemento di un <site> elemento per eseguire l'override delle impostazioni predefinite di associazione ereditate dall'elemento <bindings> a livello <siteDefaults> di server.

Compatibilità

Versione	Note
IIS 10.0	L'elemento `<bindings>` non è stato modificato in IIS 10.0.
IIS 8,5	L'elemento `<bindings>` non è stato modificato in IIS 8.5.
IIS 8,0	L'elemento `<bindings>` non è stato modificato in IIS 8.0.
IIS 7,5	L'elemento `<bindings>` non è stato modificato in IIS 7.5.
IIS 7.0	L'elemento `<bindings>` è stato introdotto in IIS 7.0.
IIS 6.0	L'insieme `<bindings>` sostituisce le sezioni della proprietà ServerBindings nell'oggetto metabase IIsWebServer IIS 6.0.

Installazione

L'elemento <bindings> è incluso nell'installazione predefinita di IIS 7.

Procedure

Come configurare le impostazioni predefinite del sito per un server

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).
Nel riquadro Connessioni espandere il nome del server e quindi fare clic sul nodo Siti .
Nel riquadro Siti del server fare clic su Imposta impostazioni predefinite sito Web... nel riquadro Azioni .
Nella finestra di dialogo Impostazioni predefinite sito Web specificare le opzioni predefinite per tutti i siti Web e quindi fare clic su OK.

Configurazione

È possibile aggiungere un <bindings> elemento per un server, che può contenere una raccolta di singoli <binding> elementi che definiscono le associazioni di protocolli predefinite per il server. È anche possibile usare un <clear /> elemento nell'elemento di un <site> elemento per eseguire l'override delle impostazioni predefinite di associazione ereditate dall'elemento <bindings> a livello <siteDefaults> di server.

Attributi

Nessuno.

Elementi figlio

Elemento	Descrizione
`binding`	Elemento facoltativo. Configura un'associazione predefinita.
`clear`	Elemento facoltativo. Cancella la raccolta di associazioni predefinite.

Esempio di configurazione

L'esempio di configurazione seguente specifica le opzioni predefinite bindings per IIS 7.

<system.applicationHost>
   <sites>
      <siteDefaults>
         <bindings>
            <binding protocol="http" bindingInformation="127.0.0.1:8080:" />
         </bindings>
      </siteDefaults>
   </sites>
</system.applicationHost>

Codice di esempio

Gli esempi di codice seguenti configurano le opzioni predefinite bindings per IIS 7.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.bindings.[protocol='http',bindingInformation='*:8080:contoso.com'].bindingInformation:"127.0.0.1:8080:" /commit:apphost

Nota

È necessario assicurarsi di impostare il parametro commit su apphost quando si usa AppCmd.exe per configurare queste impostazioni. Questa operazione esegue il commit delle impostazioni di configurazione nella sezione percorso appropriata nel file di ApplicationHost.config.

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.GetApplicationHostConfiguration();
         ConfigurationSection sitesSection = config.GetSection("system.applicationHost/sites");
         ConfigurationElement siteDefaultsElement = sitesSection.GetChildElement("siteDefaults");

         ConfigurationElementCollection bindingsCollection = siteDefaultsElement.GetCollection("bindings");
         ConfigurationElement bindingElement = bindingsCollection.CreateElement("binding");
         bindingElement["protocol"] = @"http";
         bindingElement["bindingInformation"] = @"127.0.0.1:8080:";
         bindingsCollection.Add(bindingElement);

         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.GetApplicationHostConfiguration
      Dim sitesSection As ConfigurationSection = config.GetSection("system.applicationHost/sites")
      Dim siteDefaultsElement As ConfigurationElement = sitesSection.GetChildElement("siteDefaults")

      Dim bindingsCollection As ConfigurationElementCollection = siteDefaultsElement.GetCollection("bindings")
      Dim bindingElement As ConfigurationElement = bindingsCollection.CreateElement("binding")
      bindingElement("protocol") = "http"
      bindingElement("bindingInformation") = "127.0.0.1:8080:"
      bindingsCollection.Add(bindingElement)

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST");
var siteDefaultsElement = sitesSection.ChildElements.Item("siteDefaults");

var bindingsCollection = siteDefaultsElement.ChildElements.Item("bindings").Collection;
var bindingElement = bindingsCollection.CreateNewElement("binding");
bindingElement.Properties.Item("protocol").Value = "http";
bindingElement.Properties.Item("bindingInformation").Value = "127.0.0.1:8080:";
bindingsCollection.AddElement(bindingElement);

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST")
Set siteDefaultsElement = sitesSection.ChildElements.Item("siteDefaults")

Set bindingsCollection = siteDefaultsElement.ChildElements.Item("bindings").Collection
Set bindingElement = bindingsCollection.CreateNewElement("binding")
bindingElement.Properties.Item("protocol").Value = "http"
bindingElement.Properties.Item("bindingInformation").Value = "127.0.0.1:8080:"
bindingsCollection.AddElement(bindingElement)

adminManager.CommitChanges()

Condividi tramite