IIS Home @ it-notebook.org

C# - Append a host header to a website in IIS by code

(Kristofer Gafvert, January 20, 2006)

The following example adds a host header to a website in IIS. This involves changing the ServerBindings property. There is no Append method that can be used to append a new serverbinding to this property, so what needs to be done is read the entire property and then add it back again, together with the new data. This is what is done in the code below. The ServerBindings property's data type is MULTISZ, and the string format is IP:Port:Hostname.

Note that this example code does not do any error checking. It is important that every ServerBindings entry is unique, and you - the programmer - is responsible for checking this (which means that you need to loop thru all entries and check if what is about to be added is unique).

    using System.DirectoryServices;
    using System;
    public class IISAdmin
       /// <summary>
       /// Adds a host header value to a specified website. WARNING: NO ERROR CHECKING IS PERFORMED IN THIS EXAMPLE.
       /// </summary>
      /// <param name="hostHeader">The host header. Must be in the form IP:Port:Hostname </param>
      /// <param name="websiteID">The ID of the website the host header should be added to </param>
      public static void AddHostHeader(string hostHeader, string websiteID)
         DirectoryEntry site = new DirectoryEntry("IIS://localhost/w3svc/" + websiteID );
            //Get everything currently in the serverbindings propery.
            PropertyValueCollection serverBindings = site.Properties["ServerBindings"];
            //Add the new binding
            //Create an object array and copy the content to this array
            Object [] newList = new Object[serverBindings.Count];
            serverBindings.CopyTo(newList, 0);
            //Write to metabase
            site.Properties["ServerBindings"].Value = newList;         
            //Commit the changes
         catch (Exception e)
   public class TestApp
      public static void Main(string[] args)
         IISAdmin.AddHostHeader(":80:test.com", "1");


Download code
Internet Information Services SDK (MSDN)
Code Access Security
ServerBindingsProperty in the IIS SDK