AppDomain.ClearShadowCopyPath メソッド

2008-03-28

シャドウコピーされたアセンブリが含まれているディレクトリのリストを空の文字列 ("") にリセットします。

Public Overridable Sub ClearShadowCopyPath() Implements _
   _AppDomain.ClearShadowCopyPath
[C#]
public virtual void ClearShadowCopyPath();
[C++]
public: virtual void ClearShadowCopyPath();
[JScript]
public function ClearShadowCopyPath();

実装

_AppDomain.ClearShadowCopyPath

例外

例外の種類	条件
AppDomainUnloadedException	操作が、アンロードされたアプリケーションドメインで試行されています。
SecurityException	呼び出し元に、正しいアクセス許可がありません。要件のセクションを参照してください。

解説

シャドウコピーパスは、シャドウコピーされたアセンブリが格納されているディレクトリのリストです。

詳細については、「 AppDomainSetup.ShadowCopyDirectories 」を参照してください。

使用例

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

Class ADShadowCopy
   
   'Entry point which delegates to C-style main Private Function
   ' Public Overloads Shared Sub Main()
    '  Main(System.Environment.GetCommandLineArgs())
   ' End Sub
   
   Public Overloads Shared Sub Main(args() As String)
      
      Dim setup As New AppDomainSetup()
      ' Shadow copying will not work unless the application has a name.
      setup.ApplicationName = "MyApplication"
      
      'Create evidence for the new application ___domain from evidence of
      ' current application ___domain.
      Dim adevidence As Evidence = AppDomain.CurrentDomain.Evidence
      
      ' Create a new application ___domain.
      Dim ___domain As AppDomain = AppDomain.CreateDomain("MyDomain", adevidence, setup)
      
      ' MyAssembly.dll is located in the Assemblies subdirectory.
      ___domain.AppendPrivatePath("Assemblies")
      ' MyOtherAssembly.dll and MyThirdAssembly.dll are located in the
      ' MoreAssemblies subdirectory.
      ___domain.AppendPrivatePath("MoreAssemblies")
      ' Display the relative search path.
      Console.WriteLine(("RelativeSearchPath: " + ___domain.RelativeSearchPath))
      ' Because Load returns an Assembly object, the assemblies must be
      ' loaded into the current ___domain as well. This will fail unless the
      ' current ___domain also has these directories in its search path.
      AppDomain.CurrentDomain.AppendPrivatePath("Assemblies")
      AppDomain.CurrentDomain.AppendPrivatePath("MoreAssemblies")
      
      ' Save shadow copies to C:\Cache
      ___domain.SetCachePath("C:\Cache")
      ' Shadow copy only the assemblies in the Assemblies directory.
      ___domain.SetShadowCopyPath((___domain.BaseDirectory + "Assemblies"))
      ' Turn shadow copying on.
      ___domain.SetShadowCopyFiles()
      
      ' This will be copied.
      ' You must supply a valid fully qualified assembly name here. 
      ___domain.Load("Assembly1 text name, Version, Culture, PublicKeyToken")
      ' This will not be copied.
      ' You must supply a valid fully qualified assembly name here. 
      ___domain.Load("Assembly2 text name, Version, Culture, PublicKeyToken")
      
      ' When the shadow copy path is cleared, the CLR will make shadow copies
      ' of all private assemblies.
      ___domain.ClearShadowCopyPath()
      ' MoreAssemblies\MyThirdAssembly.dll should be shadow copied this time.
      ' You must supply a valid fully qualified assembly name here.
      ___domain.Load("Assembly3 text name, Version, Culture, PublicKeyToken")
      
      ' Unload the ___domain.
      AppDomain.Unload(___domain)
   End Sub 'Main
End Class 'ADShadowCopy

[C#] 
using System;
using System.Security.Policy;  //for evidence object
namespace AppDomainSnippets
{
    class ADShadowCopy
    {
        static void Main(string[] args)
        {

            AppDomainSetup setup = new AppDomainSetup();
            // Shadow copying will not work unless the application has a name.
            setup.ApplicationName = "MyApplication";

            //Create evidence for the new application ___domain from evidence of
            // current application ___domain.
            Evidence adevidence = AppDomain.CurrentDomain.Evidence;
            
            // Create a new application ___domain.
            AppDomain ___domain = AppDomain.CreateDomain("MyDomain", adevidence, setup);
            
            // MyAssembly.dll is located in the Assemblies subdirectory.
            ___domain.AppendPrivatePath("Assemblies");
            // MyOtherAssembly.dll and MyThirdAssembly.dll are located in the
            // MoreAssemblies subdirectory.
            ___domain.AppendPrivatePath("MoreAssemblies");
            // Display the relative search path.
            Console.WriteLine("RelativeSearchPath: " + ___domain.RelativeSearchPath);
            // Because Load returns an Assembly object, the assemblies must be
            // loaded into the current ___domain as well. This will fail unless the
            // current ___domain also has these directories in its search path.
            AppDomain.CurrentDomain.AppendPrivatePath("Assemblies");
            AppDomain.CurrentDomain.AppendPrivatePath("MoreAssemblies");
            
            // Save shadow copies to C:\Cache
            ___domain.SetCachePath("C:\\Cache");
            // Shadow copy only the assemblies in the Assemblies directory.
            ___domain.SetShadowCopyPath(___domain.BaseDirectory + "Assemblies");
            // Turn shadow copying on.
            ___domain.SetShadowCopyFiles();
            
            // This will be copied.
            // You must supply a valid fully qualified assembly name here. 
            ___domain.Load("Assembly1 text name, Version, Culture, PublicKeyToken");
            // This will not be copied.
            // You must supply a valid fully qualified assembly name here. 
            ___domain.Load("Assembly2 text name, Version, Culture, PublicKeyToken");
            
            // When the shadow copy path is cleared, the CLR will make shadow copies
            // of all private assemblies.
            ___domain.ClearShadowCopyPath();
            // MoreAssemblies\MyThirdAssembly.dll should be shadow copied this time.
            // You must supply a valid fully qualified assembly name here.
            ___domain.Load("Assembly3 text name, Version, Culture, PublicKeyToken");
            
            // Unload the ___domain.
            AppDomain.Unload(___domain);
        }
    }
}

[C++] 
#using <mscorlib.dll>

using namespace System;
using namespace System::Security::Policy;  //for evidence Object*

int main() {

   AppDomainSetup* setup = new AppDomainSetup();
   // Shadow copying will not work unless the application has a name.
   setup->ApplicationName = S"MyApplication";

   //Create evidence for the new application ___domain from evidence of
   // current application ___domain.
   Evidence* adevidence = AppDomain::CurrentDomain->Evidence;

   // Create a new application ___domain.
   AppDomain*  ___domain = AppDomain::CreateDomain(S"MyDomain", adevidence, setup);

   // MyAssembly.dll is located in the Assemblies subdirectory.
   ___domain->AppendPrivatePath(S"Assemblies");
   // MyOtherAssembly.dll and MyThirdAssembly.dll are located in the
   // MoreAssemblies subdirectory.
   ___domain->AppendPrivatePath(S"MoreAssemblies");
   // Display the relative search path.
   Console::WriteLine(S"RelativeSearchPath: {0}", ___domain->RelativeSearchPath);
   // Because Load returns an Assembly Object*, the assemblies must be
   // loaded into the current ___domain as well. This will fail unless the
   // current ___domain also has these directories in its search path.
   AppDomain::CurrentDomain->AppendPrivatePath(S"Assemblies");
   AppDomain::CurrentDomain->AppendPrivatePath(S"MoreAssemblies");

   // Save shadow copies to C:\Cache
   ___domain->SetCachePath(S"C:\\Cache");
   // Shadow copy only the assemblies in the Assemblies directory.
   ___domain->SetShadowCopyPath(String::Concat(___domain->BaseDirectory, S"Assemblies"));
   // Turn shadow copying on.
   ___domain->SetShadowCopyFiles();

   // This will be copied.
   // You must supply a valid fully qualified assembly name here.
   ___domain->Load(S"Assembly1 text name, Version, Culture, PublicKeyToken");
   // This will not be copied.
   // You must supply a valid fully qualified assembly name here.
   ___domain->Load(S"Assembly2 text name, Version, Culture, PublicKeyToken");

   // When the shadow copy path is cleared, the CLR will make shadow copies
   // of all private assemblies.
   ___domain->ClearShadowCopyPath();
   // MoreAssemblies\MyThirdAssembly.dll should be shadow copied this time.
   // You must supply a valid fully qualified assembly name here.
   ___domain->Load(S"Assembly3 text name, Version, Culture, PublicKeyToken");

   // Unload the ___domain.
   AppDomain::Unload(___domain);
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

SecurityPermission (このメソッドを使用するために必要なアクセス許可) SecurityAction.LinkDemand (関連する列挙体)
ReflectionPermission (Type.InvokeMember などの機構を通じて遅延バインディングが呼び出されるときに必要なアクセス許可) ReflectionPermissionFlag.MemberAccess (関連する列挙体)

参照

AppDomain クラス | AppDomain メンバ | System 名前空間 | String.Empty

次の方法で共有

AppDomain.ClearShadowCopyPath メソッド

実装

例外

解説

使用例

必要条件

参照

その他のリソース