AppDomain.ClearPrivatePath Method

NOTE: This API is now obsolete. The non-obsolete alternative is PrivateBinPath.

Resets the path that specifies the location of private assemblies to the empty string ("").

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

'Declaration
<ObsoleteAttribute("AppDomain.ClearPrivatePath has been deprecated. Please investigate the use of AppDomainSetup.PrivateBinPath instead. http://go.microsoft.com/fwlink/?linkid=14202")> _
<SecurityPermissionAttribute(SecurityAction.LinkDemand, ControlAppDomain := True)> _
Public Sub ClearPrivatePath
'Usage
Dim instance As AppDomain

instance.ClearPrivatePath()

Implements

_AppDomain.ClearPrivatePath

ExceptionCondition
AppDomainUnloadedException

The operation is attempted on an unloaded application domain.

The private path is a path relative to the base directory that the common language runtime searches to locate private assemblies.

For more information, see AppDomainSetup.PrivateBinPath.

The following code example demonstrates how to use the ClearPrivatePath method to remove all entries from the list of private paths to search when assemblies are loaded.

This method is now obsolete, and should not be used for new development.

Imports System
Imports System.Reflection
Imports System.Security.Policy 'for evidence object

Class ADAppendPrivatePath

   Public Shared Sub Main()
      'Create evidence for new appdomain. 
      Dim adevidence As Evidence = AppDomain.CurrentDomain.Evidence

      'Create the new application domain. 
      Dim domain As AppDomain = AppDomain.CreateDomain("MyDomain", adevidence)

      'Display the current relative search path.
      Console.WriteLine("Relative search path is: " & domain.RelativeSearchPath)

      'Append the relative path. 
      Dim Newpath As [String] = "www.code.microsoft.com"
      domain.AppendPrivatePath(Newpath)

      'Display the new relative search path.
      Console.WriteLine("Relative search path is: " & domain.RelativeSearchPath)

      'Clear the private search path.
      domain.ClearPrivatePath()

      'Display the new relative search path.
      Console.WriteLine("Relative search path is now: " & domain.RelativeSearchPath)


      AppDomain.Unload(domain)
   End Sub 'Main
End Class 'ADAppendPrivatePath

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

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

.NET Framework

Supported in: 1.1, 1.0
Obsolete (compiler warning) in 3.5
Obsolete (compiler warning) in 3.5 SP1
Obsolete (compiler warning) in 3.0
Obsolete (compiler warning) in 3.0 SP1
Obsolete (compiler warning) in 3.0 SP2
Obsolete (compiler warning) in 2.0
Obsolete (compiler warning) in 2.0 SP1
Obsolete (compiler warning) in 2.0 SP2
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft