This documentation is archived and is not being maintained.

ContextInformation Class

Encapsulates the context information that is associated with a ConfigurationElement object. This class cannot be inherited.


Namespace:  System.Configuration
Assembly:  System.Configuration (in System.Configuration.dll)

Public NotInheritable Class ContextInformation

The ContextInformation type exposes the following members.

Public propertyHostingContextGets the context of the environment where the configuration property is being evaluated.
Public propertyIsMachineLevelGets a value specifying whether the configuration property is being evaluated at the machine configuration level.

Public methodEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodGetSectionProvides an object containing configuration-section information based on the specified section name.
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)

The ContextInformation object provides environment details related to an element of the configuration. For instance, you can use the IsMachineLevel property to determine whether a ConfigurationElement was set in Machine.config, or you can determine which hierarchy a ConfigurationElement belongs to by using the HostingContext property.

The following code example demonstrates how to use the ContextInformation type.

Imports System
Imports System.Collections
Imports System.Collections.Generic
Imports System.Text
Imports System.Configuration
Imports System.Web
Imports System.Web.Configuration

Namespace Samples.Aspnet.ConfigurationSample
  Class UsingContextInformation
    Public Shared Sub Main()
        ' Set the path of the config file.
        Dim configPath As String = ""

        ' Get the Web application configuration object.
        Dim config As Configuration = _

        ' Get the section related object.
        Dim configSection As _
          System.Web.Configuration.HealthMonitoringSection = _
          CType(config.GetSection("system.web/healthMonitoring"), _

        ' Display title and info.
        Console.WriteLine("ASP.NET Configuration Info")

        ' Display Config details.
        Console.WriteLine("File Path: {0}", _
        Console.WriteLine("Section Path: {0}", _

        ' IsMachineLevel property.
        Console.WriteLine("IsMachineLevel: {0}", _

        ' Create an object based on HostingContext.
        Dim myWC As WebContext = _
        ' Use the WebContext object to determine
        ' the ApplicationLevel.
        Console.WriteLine("ApplicationLevel: {0}", _

      Catch e As System.Exception
        ' Error.
      End Try
      ' Display and wait.
    End Sub
  End Class
End Namespace

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

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