Export (0) Print
Expand All

ApplicationCollection Class

IIS 7.0

Represents a collection of Application objects for a Site object.

Namespace:  Microsoft.Web.Administration
Assembly:  Microsoft.Web.Administration (in Microsoft.Web.Administration.dll)

public sealed class ApplicationCollection : ConfigurationElementCollectionBase<Application>

The ApplicationCollection type exposes the following members.

  NameDescription
Public propertyAllowsAddGets a value indicating whether an add element name is defined in the current collection schema. (Inherited from ConfigurationElementCollectionBase<(Of <(<'T>)>)>.)
Public propertyAllowsClearGets a value indicating whether a clear element name is defined in the current collection schema. (Inherited from ConfigurationElementCollectionBase<(Of <(<'T>)>)>.)
Public propertyAllowsRemoveGets a value indicating whether a remove element name is defined in the current collection schema. (Inherited from ConfigurationElementCollectionBase<(Of <(<'T>)>)>.)
Public propertyAttributesGets a configuration attribute collection that contains the list of attributes for this element. (Inherited from ConfigurationElement.)
Public propertyChildElementsGets all the child elements of the current element. (Inherited from ConfigurationElement.)
Public propertyCountGets the number of items in the collection. (Inherited from ConfigurationElementCollectionBase<(Of <(<'T>)>)>.)
Public propertyElementTagNameGets the XML tag name of the current element. (Inherited from ConfigurationElement.)
Public propertyIsLocallyStoredGets a value indicating whether the configuration element is stored in a particular configuration file. (Inherited from ConfigurationElement.)
Public propertyItem[([(String])])Gets an application with the specified path in the collection.
Public propertyItem[([(Int32])])Gets a configuration element at the specified index. (Inherited from ConfigurationElementCollectionBase<(Of <(<'T>)>)>.)
Public propertyMethodsGets a collection of methods for the configuration element. (Inherited from ConfigurationElement.)
Public propertyRawAttributesGets the raw attribute names and values for the current configuration element. (Inherited from ConfigurationElement.)
Public propertySchemaGets the schema that describes the configuration element collection. (Inherited from ConfigurationElementCollectionBase<(Of <(<'T>)>)>.)
Top

  NameDescription
Public methodAdd(T)Adds a configuration element to the end of the current collection. (Inherited from ConfigurationElementCollectionBase<(Of <(<'T>)>)>.)
Public methodAdd(String, String)Creates a new application by using the specified parameters and adds it to the application collection.
Public methodAddAtAdds a configuration element to the current collection at the specified index. (Inherited from ConfigurationElementCollectionBase<(Of <(<'T>)>)>.)
Public methodClearClears all configuration elements from the current collection. (Inherited from ConfigurationElementCollectionBase<(Of <(<'T>)>)>.)
Public methodCreateElement()()()()Creates a new child element for the current collection. (Inherited from ConfigurationElementCollectionBase<(Of <(<'T>)>)>.)
Public methodCreateElement(String)Creates a new child element by using the specified name. (Inherited from ConfigurationElementCollectionBase<(Of <(<'T>)>)>.)
Protected methodCreateNewElementCreates a new element by using the specified element name. (Inherited from ConfigurationElementCollectionBase<(Of <(<'T>)>)>.)
Public methodDelete (Inherited from ConfigurationElement.)
Public methodEquals (Inherited from Object.)
Protected methodFinalize (Inherited from Object.)
Public methodGetAttributeReturns a ConfigurationAttribute object that represents the requested attribute. (Inherited from ConfigurationElement.)
Public methodGetAttributeValueReturns the value of the specified attribute. (Inherited from ConfigurationElement.)
Public methodGetChildElement(String)Returns a child element that is under the current configuration element and has the specified name. (Inherited from ConfigurationElement.)
Public methodGetChildElement(String, Type)Returns a child element that is under the current configuration element and has the specified name and type. (Inherited from ConfigurationElement.)
Public methodGetCollection()()()()Returns the default collection for the current configuration element. (Inherited from ConfigurationElement.)
Public methodGetCollection(String)Returns all configuration elements that belong to the current configuration element. (Inherited from ConfigurationElement.)
Public methodGetCollection(Type)Returns the configuration element that has the specified type and is under the current configuration element. (Inherited from ConfigurationElement.)
Public methodGetCollection(String, Type)Returns the configuration element that has the specified name and type and is under the current configuration element. (Inherited from ConfigurationElement.)
Public methodGetEnumeratorReturns an enumerator that iterates through a collection. (Inherited from ConfigurationElementCollectionBase<(Of <(<'T>)>)>.)
Public methodGetHashCode (Inherited from Object.)
Public methodGetMetadataReturns metadata values from the element schema. (Inherited from ConfigurationElement.)
Public methodGetType (Inherited from Object.)
Public methodIndexOfDetermines the index of an element in the collection. (Inherited from ConfigurationElementCollectionBase<(Of <(<'T>)>)>.)
Public methodStatic memberInvalidApplicationPathCharactersRetrieves an array of characters that cannot be used in the path of an application.
Protected methodMemberwiseClone (Inherited from Object.)
Public methodRemoveRemoves the first occurrence of an element from the collection. (Inherited from ConfigurationElementCollectionBase<(Of <(<'T>)>)>.)
Public methodRemoveAtRemoves the element at the specified index of the collection. (Inherited from ConfigurationElementCollectionBase<(Of <(<'T>)>)>.)
Public methodSetAttributeValueSets the value of the specified attribute. (Inherited from ConfigurationElement.)
Public methodSetMetadataSets metadata values from the element schema. (Inherited from ConfigurationElement.)
Public methodToString (Inherited from Object.)
Top

  NameDescription
Explicit interface implemetationPrivate methodICollection..::..CopyToCopies the elements of the collection to an array, starting at a particular array index. (Inherited from ConfigurationElementCollectionBase<(Of <(<'T>)>)>.)
Explicit interface implemetationPrivate propertyICollection..::..CountGets the number of elements in the collection. (Inherited from ConfigurationElementCollectionBase<(Of <(<'T>)>)>.)
Explicit interface implemetationPrivate methodIEnumerable..::..GetEnumeratorReturns an enumerator that iterates through the collection. (Inherited from ConfigurationElementCollectionBase<(Of <(<'T>)>)>.)
Explicit interface implemetationPrivate propertyICollection..::..IsSynchronizedGets a value indicating whether access to the collection is synchronized (thread safe). (Inherited from ConfigurationElementCollectionBase<(Of <(<'T>)>)>.)
Explicit interface implemetationPrivate propertyICollection..::..SyncRootGets an object that is used to synchronize access to the collection. (Inherited from ConfigurationElementCollectionBase<(Of <(<'T>)>)>.)
Top

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

ApplicationCollection implements the IEnumerable<(Of <(<'T>)>)> interface. Use the Add method to create new applications. In addition, you can use indexers to obtain a reference to an item in the collection by position or application name.

The following example displays all applications in the ApplicationCollection object for the default Web site.

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

namespace AdministrationSnippets
{
    public class AdministrationApplicationCollection
    {


...


// Displays all Applications under the "Default Web Site"
public void GetApplications()
{
    ServerManager manager = new ServerManager();
    Site defaultSite = manager.Sites["Default Web Site"];

    foreach (Application app in defaultSite.Applications)
    {
        Console.WriteLine("Found an application: {0}", app.Path);
    }
}


...


    }
}


Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Community Additions

ADD
Show:
© 2014 Microsoft