0 out of 1 rated this helpful - Rate this topic

ApplicationDefaults Class

IIS 7.0

Defines the default values for applications that are created for a Web site.

System..::..Object
  Microsoft.Web.Administration..::..ConfigurationElement
    Microsoft.Web.Administration..::..ApplicationDefaults

Namespace:  Microsoft.Web.Administration
Assembly:  Microsoft.Web.Administration (in Microsoft.Web.Administration.dll)
public sealed class ApplicationDefaults : ConfigurationElement

The ApplicationDefaults type exposes the following members.

  Name Description
Public property ApplicationPoolName Gets or sets the application pool that is assigned by default to all applications under the current Web site.
Public property Attributes Gets a configuration attribute collection that contains the list of attributes for this element. (Inherited from ConfigurationElement.)
Public property ChildElements Gets all the child elements of the current element. (Inherited from ConfigurationElement.)
Public property ElementTagName Gets the XML tag name of the current element. (Inherited from ConfigurationElement.)
Public property EnabledProtocols Gets or sets the protocols that are enabled by default for all applications under the current Web site.
Public property IsLocallyStored Gets a value indicating whether the configuration element is stored in a particular configuration file. (Inherited from ConfigurationElement.)
Public property Item Gets or sets an attribute with the specified name. (Inherited from ConfigurationElement.)
Public property Methods Gets a collection of methods for the configuration element. (Inherited from ConfigurationElement.)
Public property RawAttributes Gets the raw attribute names and values for the current configuration element. (Inherited from ConfigurationElement.)
Public property Schema Gets the schema for the current element. (Inherited from ConfigurationElement.)
Top
  Name Description
Public method Delete (Inherited from ConfigurationElement.)
Public method Equals (Inherited from Object.)
Protected method Finalize (Inherited from Object.)
Public method GetAttribute Returns a ConfigurationAttribute object that represents the requested attribute. (Inherited from ConfigurationElement.)
Public method GetAttributeValue Returns the value of the specified attribute. (Inherited from ConfigurationElement.)
Public method GetChildElement(String) Returns a child element that is under the current configuration element and has the specified name. (Inherited from ConfigurationElement.)
Public method GetChildElement(String, Type) Returns a child element that is under the current configuration element and has the specified name and type. (Inherited from ConfigurationElement.)
Public method GetCollection()()()() Returns the default collection for the current configuration element. (Inherited from ConfigurationElement.)
Public method GetCollection(String) Returns all configuration elements that belong to the current configuration element. (Inherited from ConfigurationElement.)
Public method GetCollection(Type) Returns the configuration element that has the specified type and is under the current configuration element. (Inherited from ConfigurationElement.)
Public method GetCollection(String, Type) Returns the configuration element that has the specified name and type and is under the current configuration element. (Inherited from ConfigurationElement.)
Public method GetHashCode (Inherited from Object.)
Public method GetMetadata Returns metadata values from the element schema. (Inherited from ConfigurationElement.)
Public method GetType (Inherited from Object.)
Protected method MemberwiseClone (Inherited from Object.)
Public method SetAttributeValue Sets the value of the specified attribute. (Inherited from ConfigurationElement.)
Public method SetMetadata Sets metadata values from the element schema. (Inherited from ConfigurationElement.)
Public method ToString (Inherited from Object.)
Top

This class is sealed and does not implement a public constructor. You can access an instance of the ApplicationDefaults class through the ApplicationDefaults property of the Site class.

The following example displays the default application values for each site.


using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.Web.Administration;
using Microsoft.Web.Management;

namespace AdministrationSnippets
{
    public class AdministrationApplicationDefaults
    {


...


// Displays the default application values for all configured sites.
public void GetApplicationDefaults()
{
    ServerManager manager = new ServerManager();
    foreach (Site s in manager.Sites)
    {
        ApplicationDefaults d = s.ApplicationDefaults;
        Console.WriteLine("Site: {0}", s.Name);
        Console.WriteLine("  |--Default Application Pool:  {0}", 
            d.ApplicationPoolName);
        Console.WriteLine("  +--Default Protocols Enabled: {0}\r\n", 
            d.EnabledProtocols);
    }

}


...


    }
}


The following example sets the default values for applications created under the default Web site, creates a new application, and then verifies that the application properties are set to the default values.


using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.Web.Administration;
using Microsoft.Web.Management;

namespace AdministrationSnippets
{
    public class AdministrationApplicationDefaults
    {


...


// Sets the default values for applications configured under the 
// default Web site.
public void SetApplicationDefaults()
{
    ServerManager manager = new ServerManager();
    Site defaultSite = manager.Sites["Default Web Site"];
    ApplicationDefaults defaultVals = defaultSite.ApplicationDefaults;

    // Set the application defaults.
    defaultVals.ApplicationPoolName = "CommunitySites";
    defaultVals.EnabledProtocols = "http";

    // Create a new application.
    defaultSite.Applications.Add(
        "/discussion", @"C:\inetpub\wwwroot\forums");
    manager.CommitChanges();

    // Read the application's values.
    Application discussion = defaultSite.Applications["/discussion"];
    Console.WriteLine("Site: {0}", defaultSite.Name);
    Console.WriteLine("  |--Default Application Pool:  {0}", 
        discussion.ApplicationPoolName);
    Console.WriteLine("  +--Default Protocols Enabled: {0}\r\n", 
        discussion.EnabledProtocols);
}


...


    }
}


Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ