This documentation is archived and is not being maintained.

Forest.GetForest Method

Gets a Forest object for the specified context.

Namespace: System.DirectoryServices.ActiveDirectory
Assembly: System.DirectoryServices (in system.directoryservices.dll)

public static Forest GetForest (
	DirectoryContext context
public static Forest GetForest (
	DirectoryContext context
public static function GetForest (
	context : DirectoryContext
) : Forest
Not applicable.



A DirectoryContext object that contains the target and credentials to use to retrieve the object.

Return Value

A Forest object that represents the forest that was retrieved by this method.

Exception typeCondition


A connection to the target that is specified in context could not be made.


A call to the underlying directory service resulted in an error.


context is not valid.


context is a null reference (Nothing in Visual Basic).

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0