Compartilhar via

Associações padrão <bindings>

  • Artigo

Visão geral

O elemento <bindings> configura as informações de associação padrão para todos os sites do IIS 7.

Esse elemento pode conter uma coleção de elementos <binding>. Cada elemento da coleção define um conjunto separado de informações de associação que uma solicitação pode usar para entrar em contato com o site. Por exemplo, se o site exigir que os usuários entrem em contato com ele usando os protocolos HTTP e HTTPS, você deverá definir uma associação para cada protocolo.

Você também pode usar um elemento <clear /> no elemento <bindings> de um elemento <site> para substituir os padrões de associação herdados do elemento <siteDefaults> de nível de servidor.

Compatibilidade

Versão Observações
IIS 10.0 O elemento <bindings> não foi modificado no IIS 10.0.
IIS 8.5 O elemento <bindings> não foi modificado no IIS 8.5.
IIS 8.0 O elemento <bindings> não foi modificado no IIS 8.0.
IIS 7.5 O elemento <bindings> não foi modificado no IIS 7.5.
IIS 7.0 O elemento <bindings> foi introduzido no IIS 7.0.
IIS 6,0 A coleção <bindings> substitui seções da propriedade ServerBindings no objeto de metabase IIsWebServer do IIS 6.0.

Instalação

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

Instruções

Como configurar os padrões do site para um servidor

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

    • 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 dos Serviços de Informações da Internet (IIS).

    • 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 dos Serviços de Informações da Internet (IIS).

    • 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 dos Serviços de Informações da Internet (IIS).

    • 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 dos Serviços de Informações da Internet (IIS).

  2. No painel Conexões, expanda o nome do servidor e clique no nó Sites.

  3. No painel Sites do servidor, clique em Definir Padrões do Site... no painel Ações.
    Screenshot of the Sites pane showing the Default Web Site option.

  4. Na caixa de diálogo Padrões do Site, especifique as opções padrão para todos os sites e clique em OK.

    Screenshot of the Website Defaults dialog box showing the General and Behavior sections.

Configuração

Você pode adicionar um elemento <bindings> para um servidor, que pode conter uma coleção de elementos <binding> individuais que definem as associações de protocolo padrão para o servidor. Você também pode usar um elemento <clear /> no elemento <bindings> de um elemento <site> para substituir os padrões de associação herdados do elemento <siteDefaults> de nível de servidor.

Atributos

Nenhum.

Elementos filho

Elemento Descrição
binding Elemento opcional.

Configura uma associação padrão.
clear Elemento opcional.

Limpa a coleção de associações padrão.

Exemplo de configuração

O exemplo de configuração a seguir especifica as opções de bindings padrão para o IIS 7.

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

Exemplo de código

Os exemplos de código a seguir configuram as opções de bindings padrão para o 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

Observação

Defina o parâmetro commit para apphost quando usar AppCmd.exe para definir essas configurações. Isso confirma as definições de configuração para a seção de local apropriado no arquivo 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()