_AppDomain.RelativeSearchPath プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

_AppDomain.RelativeSearchPath プロパティ

COM オブジェクトに、AppDomain.RelativeSearchPath プロパティへのバージョンに依存しないアクセスが用意されています。

このプロパティは、CLS に準拠していません。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

ReadOnly Property RelativeSearchPath As
 String

Visual Basic (使用法)

Dim instance As _AppDomain
Dim value As String

value = instance.RelativeSearchPath

string RelativeSearchPath { get; }

C++

property String^ RelativeSearchPath {
    String^ get ();
}

/** @property */
String get_RelativeSearchPath ()

JScript

function get RelativeSearchPath () : String

解説

詳細については、AppDomain.RelativeSearchPath プロパティのトピックを参照してください。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

AppDomain.RelativeSearchPath プロパティ

アセンブリリゾルバがプライベートアセンブリを探す場所を示す、ベースディレクトリを基準とした相対パスを取得します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 RelativeSearchPath As String

Visual Basic (使用法)

Dim instance As AppDomain
Dim value As String

value = instance.RelativeSearchPath

public string RelativeSearchPath { get;
 }

C++

public:
virtual property String^ RelativeSearchPath {
    String^ get () sealed;
}

/** @property */
public final String get_RelativeSearchPath ()

JScript

public final function get
 RelativeSearchPath () : String

プロパティ値
アセンブリリゾルバがプライベートアセンブリを調べる場所を示す、ベースディレクトリを基準とした相対パス。

例外

例外の種類	条件
AppDomainUnloadedException	操作が、アンロードされたアプリケーションドメインで試行されています。

解説

プライベートアセンブリは、アプリケーションと同じディレクトリ構造に配置されます。

使用例

Visual Basic

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

Class ADProperties
    
    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()
        Console.WriteLine("ShadowCopyFiles turned on: "
 & domain.ShadowCopyFiles)
        
        ' 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 'ADProperties

using System;
using System.Security.Policy;  //for evidence object
namespace AppDomainSnippets
{
    class ADProperties
    {
        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();
            Console.WriteLine("ShadowCopyFiles turned on: " + domain.ShadowCopyFiles);

            // 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 namespace System;
using namespace System::Security::Policy;

//for evidence object
int main()
{
   AppDomainSetup^ setup = gcnew 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: {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( "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( String::Concat( domain->BaseDirectory, "Assemblies"
 ) );
   
   // Turn shadow copying on.
   domain->SetShadowCopyFiles();
   Console::WriteLine( "ShadowCopyFiles turned on: {0}", domain->ShadowCopyFiles
 );
   
   // 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 );
}