Assembly.LoadFrom メソッド

public:
 static System::Reflection::Assembly ^ LoadFrom(System::String ^ assemblyFile, System::Security::Policy::Evidence ^ securityEvidence, cli::array <System::Byte> ^ hashValue, System::Configuration::Assemblies::AssemblyHashAlgorithm hashAlgorithm);

public static System.Reflection.Assembly LoadFrom (string assemblyFile, System.Security.Policy.Evidence securityEvidence, byte[] hashValue, System.Configuration.Assemblies.AssemblyHashAlgorithm hashAlgorithm);

[System.Obsolete("This method is obsolete and will be removed in a future release of the .NET Framework. Please use an overload of LoadFrom which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public static System.Reflection.Assembly LoadFrom (string assemblyFile, System.Security.Policy.Evidence securityEvidence, byte[] hashValue, System.Configuration.Assemblies.AssemblyHashAlgorithm hashAlgorithm);

static member LoadFrom : string * System.Security.Policy.Evidence * byte[] * System.Configuration.Assemblies.AssemblyHashAlgorithm -> System.Reflection.Assembly

[<System.Obsolete("This method is obsolete and will be removed in a future release of the .NET Framework. Please use an overload of LoadFrom which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")>]
static member LoadFrom : string * System.Security.Policy.Evidence * byte[] * System.Configuration.Assemblies.AssemblyHashAlgorithm -> System.Reflection.Assembly

Public Shared Function LoadFrom (assemblyFile As String, securityEvidence As Evidence, hashValue As Byte(), hashAlgorithm As AssemblyHashAlgorithm) As Assembly

パラメーター

戻り値

読み込まれるアセンブリ。

属性

ObsoleteAttribute

例外

注釈

パラメーターは assemblyFile 、エスケープ文字のない URI を参照する必要があります。 このメソッドは、URI 内のすべての無効な文字のエスケープ文字を提供します。

assemblyFile は、現在のディレクトリに対して絶対または相対にすることができます。

アセンブリは、次の 3 つのコンテキストのいずれかに読み込むことができます。または、コンテキストなしで読み込むことができます。

• 読み込みコンテキストには、プローブによって検出されたアセンブリが含まれます。GAC 内、ランタイムがホストされている場合はホスト アセンブリ ストア、またはアプリケーション ドメインの と PrivateBinPath にApplicationBase格納されます。 Load メソッドのほとんどのオーバーロードは、このコンテキストにアセンブリを読み込みます。

• 読み込み元コンテキストには、ユーザーがプローブによって検索されたディレクトリに含まれていないパスを指定したアセンブリが含まれています。 LoadFrom、CreateInstanceFrom、ExecuteAssembly は、パスを使用して読み込むメソッドの例です。

  リモートの場所からアセンブリを読み込む方法については、「」を参照してください <loadFromRemoteSources> 。

• リフレクションのみのコンテキストには、 メソッドと ReflectionOnlyLoadFrom メソッドが読み込まれたアセンブリがReflectionOnlyLoad含まれています。これらのコンテキスト内のコードは実行できません。

• ユーザーがアセンブリを生成または見つけた場合、そのアセンブリはコンテキスト内にありません。 これは、アセンブリを含むバイト配列を指定する メソッドのオーバーロードを Load 使用して読み込まれたアセンブリ、およびリフレクション出力で作成され、ディスクに保存されない一時的な動的アセンブリに適用されます。

読み込み元コンテキストを使用すると、プローブに含まれていないパスからアセンブリを読み込むことができますが、パス情報はコンテキストによって維持されるため、そのパスに対する依存関係を見つけて読み込むことができます。

この LoadFrom 方法には、次の欠点があります。 代わりに Load を使用することを検討してください。

• 同じ ID を持つアセンブリが既に読み込まれている場合、LoadFrom は、別のパスが指定されている場合であっても、読み込み済みのアセンブリを返します。

• LoadFrom を使用してアセンブリを読み込んだ後、同じアセンブリを、読み込みコンテキストにあるアセンブリが表示名で読み込もうとすると、読み込みが失敗します。 この問題は、アセンブリが逆シリアル化されるときに発生します。

• アセンブリが でLoadFrom読み込まれ、プローブ パスに同じ ID を持つアセンブリが含まれているが、場所が異なる場合、、MissingMethodException、またはその他のInvalidCastException予期しない動作が発生する可能性があります。

• LoadFrom には、指定したパスに対する FileIOPermissionAccess.Read および FileIOPermissionAccess.PathDiscovery、または WebPermission が必要です。

• のネイティブ イメージが存在する assemblyFile場合は使用されません。 アセンブリをドメインニュートラルとして読み込むことができません。

アセンブリに対して特定のアクセス許可を付与するかどうかは、証拠に基づいて決定されます。 アセンブリとセキュリティ証拠のマージの規則は次のとおりです。

• パラメーターを指定しないEvidenceメソッドをLoadFrom使用すると、ローダーが提供する証拠がアセンブリに読み込まれます。

• パラメーターを指定して メソッドをLoadFromEvidence使用すると、証拠の一部がマージされます。 メソッドの引数として指定された証拠の部分は、 LoadFrom ローダーによって提供される証拠の一部よりも優先されます。

• 同じアセンブリでこのメソッドを複数回呼び出したが、異なる証拠が指定されている場合、異なる証拠指定の等価性と整合性を特定できないため、共通言語ランタイムは をスロー FileLoadException しません。 最初に成功する証拠は、使用される証拠です。

• パラメーターを指定してメソッドをLoadFromByte[]使用して共通オブジェクト ファイル形式 (COFF) イメージを読み込むと、証拠が結合されます。 Zoneは UrlSite呼び出し元のアセンブリから継承され、StrongNameHash COFF アセンブリから取得されます。

• パラメーターを指定して メソッドをLoadFromByte[]使用しEvidence、COFF イメージを読み込む場合は、指定された証拠のみが使用されます。 呼び出し元アセンブリの証拠と COFF イメージの証拠は無視されます。

ソース:

Assembly.cs

ソース:

Assembly.cs

ソース:

Assembly.cs

public:
 static System::Reflection::Assembly ^ LoadFrom(System::String ^ assemblyFile, cli::array <System::Byte> ^ hashValue, System::Configuration::Assemblies::AssemblyHashAlgorithm hashAlgorithm);

public static System.Reflection.Assembly LoadFrom (string assemblyFile, byte[]? hashValue, System.Configuration.Assemblies.AssemblyHashAlgorithm hashAlgorithm);

public static System.Reflection.Assembly LoadFrom (string assemblyFile, byte[] hashValue, System.Configuration.Assemblies.AssemblyHashAlgorithm hashAlgorithm);

static member LoadFrom : string * byte[] * System.Configuration.Assemblies.AssemblyHashAlgorithm -> System.Reflection.Assembly

Public Shared Function LoadFrom (assemblyFile As String, hashValue As Byte(), hashAlgorithm As AssemblyHashAlgorithm) As Assembly

パラメーター

戻り値

読み込まれるアセンブリ。

例外

注釈

.NET Core および .NET 5 以降では、このメソッドは呼び出されたときに をスローします NotSupportedException 。 代わりに、LoadFrom(String) を使用してください。

パラメーターは assemblyFile 、エスケープ文字のない URI を参照する必要があります。 このメソッドは、URI 内のすべての無効な文字のエスケープ文字を提供します。

assemblyFile は、現在のディレクトリに対して絶対または相対にすることができます。

アセンブリは、次の 3 つのコンテキストのいずれかに読み込むことができます。または、コンテキストなしで読み込むことができます。

• 読み込みコンテキストには、グローバル アセンブリ キャッシュ内、ランタイムがホストされている場合はホスト アセンブリ ストア内、またはアプリケーション ドメインの と PrivateBinPath のプローブによってApplicationBase検出されたアセンブリが含まれます。 Load メソッドのほとんどのオーバーロードは、このコンテキストにアセンブリを読み込みます。

• 読み込み元コンテキストには、ユーザーがプローブに含まれていないパスを指定したアセンブリが含まれています。 LoadFrom、CreateInstanceFrom、ExecuteAssembly は、パスを使用して読み込むメソッドの例です。

  リモートの場所からアセンブリを読み込む方法については、「」を参照してください <loadFromRemoteSources> 。

• リフレクションのみのコンテキストには、 メソッドと ReflectionOnlyLoadFrom メソッドが読み込まれたアセンブリがReflectionOnlyLoad含まれています。これらのコンテキスト内のコードは実行できません。

• ユーザーがアセンブリを生成または見つけた場合、そのアセンブリはコンテキスト内にありません。 これは、アセンブリを含むバイト配列を指定する メソッドのオーバーロードを Load 使用して読み込まれたアセンブリ、およびリフレクション出力で作成され、ディスクに保存されない一時的な動的アセンブリに適用されます。

load-from コンテキストを使用すると、プローブに含まれていないパスからアセンブリを読み込むことができますが、パス情報はコンテキストによって維持されるため、そのパスへの依存関係を見つけて読み込むことができます。

メソッド LoadFrom には、次の欠点があります。 代わりに Load を使用することを検討してください。

• 同じ ID を持つアセンブリが既に読み込まれている場合、LoadFrom は、別のパスが指定されている場合であっても、読み込み済みのアセンブリを返します。

• LoadFrom を使用してアセンブリを読み込んだ後、同じアセンブリを、読み込みコンテキストにあるアセンブリが表示名で読み込もうとすると、読み込みが失敗します。 この問題は、アセンブリが逆シリアル化されるときに発生します。

• アセンブリが でLoadFrom読み込まれ、プローブ パスに同じ ID を持つアセンブリが含まれているが、場所が異なる場合、、InvalidCastExceptionMissingMethodException、またはその他の予期しない動作が発生する可能性があります。

• LoadFrom には、指定したパスに対する FileIOPermissionAccess.Read および FileIOPermissionAccess.PathDiscovery、または WebPermission が必要です。

• のネイティブ イメージが存在する assemblyFile場合は、使用されません。 アセンブリをドメイン中立として読み込むことはできません。

アセンブリには、ローダーが提供する証拠が読み込まれます。

ソース:

Assembly.cs

ソース:

Assembly.cs

ソース:

Assembly.cs

public:
 static System::Reflection::Assembly ^ LoadFrom(System::String ^ assemblyFile);

public static System.Reflection.Assembly LoadFrom (string assemblyFile);

static member LoadFrom : string -> System.Reflection.Assembly

Public Shared Function LoadFrom (assemblyFile As String) As Assembly

パラメーター

戻り値

読み込まれるアセンブリ。

例外

例

次の例では、ファイル名またはパスを指定してアセンブリを読み込みます。

Assembly^ SampleAssembly;
SampleAssembly = Assembly::LoadFrom( "c:\\Sample.Assembly.dll" );
// Obtain a reference to a method known to exist in assembly.
MethodInfo^ Method = SampleAssembly->GetTypes()[ 0 ]->GetMethod( "Method1" );
// Obtain a reference to the parameters collection of the MethodInfo instance.
array<ParameterInfo^>^ Params = Method->GetParameters();
// Display information about method parameters.
// Param = sParam1
//   Type = System::String
//   Position = 0
//   Optional=False
for each ( ParameterInfo^ Param in Params )
{
   Console::WriteLine( "Param= {0}", Param->Name );
   Console::WriteLine( "  Type= {0}", Param->ParameterType );
   Console::WriteLine( "  Position= {0}", Param->Position );
   Console::WriteLine( "  Optional= {0}", Param->IsOptional );
}

Assembly SampleAssembly;
SampleAssembly = Assembly.LoadFrom("c:\\Sample.Assembly.dll");
// Obtain a reference to a method known to exist in assembly.
MethodInfo Method = SampleAssembly.GetTypes()[0].GetMethod("Method1");
// Obtain a reference to the parameters collection of the MethodInfo instance.
ParameterInfo[] Params = Method.GetParameters();
// Display information about method parameters.
// Param = sParam1
//   Type = System.String
//   Position = 0
//   Optional=False
foreach (ParameterInfo Param in Params)
{
    Console.WriteLine("Param=" + Param.Name.ToString());
    Console.WriteLine("  Type=" + Param.ParameterType.ToString());
    Console.WriteLine("  Position=" + Param.Position.ToString());
    Console.WriteLine("  Optional=" + Param.IsOptional.ToString());
}

Dim SampleAssembly As [Assembly]
SampleAssembly = [Assembly].LoadFrom("c:\Sample.Assembly.dll")
' Obtain a reference to a method known to exist in assembly.
Dim Method As MethodInfo = SampleAssembly.GetTypes()(0).GetMethod("Method1")
' Obtain a reference to the parameters collection of the MethodInfo instance.
Dim Params As ParameterInfo() = Method.GetParameters()
' Display information about method parameters.
' Param = sParam1
'   Type = System.String
'   Position = 0
'   Optional=False
For Each Param As ParameterInfo In Params
    Console.WriteLine(("Param=" + Param.Name.ToString()))
    Console.WriteLine(("  Type=" + Param.ParameterType.ToString()))
    Console.WriteLine(("  Position=" + Param.Position.ToString()))
    Console.WriteLine(("  Optional=" + Param.IsOptional.ToString()))
Next

注釈

パラメーターは assemblyFile 、エスケープ文字のない URI を参照する必要があります。 このメソッドは、URI 内のすべての無効な文字のエスケープ文字を提供します。

assemblyFile は、絶対または現在のディレクトリに対する相対値である可能性があります。

.NET Framework のみ: アセンブリは、次の 3 つのコンテキストのいずれかに読み込むことができます。または、コンテキストなしで読み込むことができます。

• 読み込みコンテキストには、プローブによって検出されたアセンブリが含まれます。GAC 内、ランタイムがホストされている場合はホスト アセンブリ ストア、またはアプリケーション ドメインの と PrivateBinPath にApplicationBase格納されます。 Load メソッドのほとんどのオーバーロードは、このコンテキストにアセンブリを読み込みます。

• 読み込み元コンテキストには、ユーザーがプローブによって検索されるディレクトリに含まれていないパスを指定したアセンブリが含まれています。 また、パス情報はコンテキストによって維持されるため、そのパスへの依存関係を見つけて読み込むこともできます。 LoadFrom、CreateInstanceFrom、ExecuteAssembly は、パスを使用して読み込むメソッドの例です。

  リモートの場所からアセンブリを読み込む方法については、「」を参照してください <loadFromRemoteSources> 。

• リフレクションのみのコンテキストには、 メソッドと ReflectionOnlyLoadFrom メソッドがReflectionOnlyLoad読み込まれたアセンブリが含まれています。これらのコンテキストのコードは実行できません。

• ユーザーがアセンブリを生成または見つけた場合は、どのコンテキストにも含まれません。 これは、アセンブリを含むバイト配列を指定する メソッドの Load オーバーロードを使用して読み込まれたアセンブリと、リフレクション出力で作成され、ディスクに保存されない一時的な動的アセンブリに適用されます。

メソッド LoadFrom には、次の欠点があります。 代わりに Load を使用することを検討してください。

• 同じ ID を持つアセンブリが既に読み込み元コンテキストに読み込まれている場合、LoadFrom では、別のパスが指定されている場合でも、読み込み済みのアセンブリを返します。

• 同じ ID を持つアセンブリが読み込みコンテキストに存在する場合でも、アセンブリを読み込み元コンテキストに読み込むことができます。 2 つのアセンブリ間の相互運用性は機能せず、その他の予期しない動作などのInvalidCastExceptionMissingMethodExceptionエラーが発生します。

• プローブ パス内の場所で を呼び出すと LoadFrom 、読み込み元コンテキストではなく、読み込みコンテキストでアセンブリが読み込まれます。

• バインド リダイレクト ポリシーによって ID が goverened されたアセンブリ ファイルが に LoadFrom渡されると、ポリシーが適用され、読み込みコンテキストのプローブ パスからアセンブリが読み込まれます。

• アセンブリが読み込み元コンテキストで読み込まれ、その後、読み込みコンテキスト内のアセンブリが同じアセンブリを表示名で読み込もうとすると、読み込み試行は失敗します。 この問題は、アセンブリが逆シリアル化されるときに発生します。

• LoadFrom には、指定したパスに対する FileIOPermissionAccess.Read および FileIOPermissionAccess.PathDiscovery、または WebPermission が必要です。

• のネイティブ イメージが存在する assemblyFile場合は、使用されません。 アセンブリをドメインニュートラルとして読み込むことができません。

public:
 static System::Reflection::Assembly ^ LoadFrom(System::String ^ assemblyFile, System::Security::Policy::Evidence ^ securityEvidence);

public static System.Reflection.Assembly LoadFrom (string assemblyFile, System.Security.Policy.Evidence securityEvidence);

[System.Obsolete("This method is obsolete and will be removed in a future release of the .NET Framework. Please use an overload of LoadFrom which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public static System.Reflection.Assembly LoadFrom (string assemblyFile, System.Security.Policy.Evidence securityEvidence);

static member LoadFrom : string * System.Security.Policy.Evidence -> System.Reflection.Assembly

[<System.Obsolete("This method is obsolete and will be removed in a future release of the .NET Framework. Please use an overload of LoadFrom which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")>]
static member LoadFrom : string * System.Security.Policy.Evidence -> System.Reflection.Assembly

Public Shared Function LoadFrom (assemblyFile As String, securityEvidence As Evidence) As Assembly

パラメーター

戻り値

読み込まれるアセンブリ。

属性

ObsoleteAttribute

例外

注釈

パラメーターは assemblyFile 、エスケープ文字のない URI を参照する必要があります。 このメソッドは、URI 内のすべての無効な文字のエスケープ文字を提供します。

assemblyFile は、絶対または現在のディレクトリを基準にして指定できます。

アセンブリは、次の 3 つのコンテキストのいずれかに読み込むことができます。または、コンテキストなしで読み込むことができます。

• 読み込みコンテキストには、プローブによって検出されたアセンブリが含まれます。GAC 内、ランタイムがホストされている場合はホスト アセンブリ ストア、またはアプリケーション ドメインの と PrivateBinPath にApplicationBase格納されます。 Load メソッドのほとんどのオーバーロードは、このコンテキストにアセンブリを読み込みます。

• 読み込み元コンテキストには、ユーザーがプローブによって検索されるディレクトリに含まれていないパスを指定したアセンブリが含まれています。 LoadFrom、CreateInstanceFrom、ExecuteAssembly は、パスを使用して読み込むメソッドの例です。

  リモートの場所からアセンブリを読み込む方法については、「」を参照してください <loadFromRemoteSources> 。

• リフレクションのみのコンテキストには、 メソッドと ReflectionOnlyLoadFrom メソッドがReflectionOnlyLoad読み込まれたアセンブリが含まれています。これらのコンテキストのコードは実行できません。

• ユーザーがアセンブリを生成または見つけた場合は、どのコンテキストにも含まれません。 これは、アセンブリを含むバイト配列を指定する メソッドの Load オーバーロードを使用して読み込まれたアセンブリと、リフレクション出力で作成され、ディスクに保存されない一時的な動的アセンブリに適用されます。

load-from コンテキストを使用すると、プローブに含まれていないパスからアセンブリを読み込むことができますが、パス情報はコンテキストによって維持されるため、そのパスへの依存関係を見つけて読み込むことができます。

メソッド LoadFrom には、次の欠点があります。 代わりに Load を使用することを検討してください。

• 同じ ID を持つアセンブリが既に読み込まれている場合、LoadFrom は、別のパスが指定されている場合であっても、読み込み済みのアセンブリを返します。

• LoadFrom を使用してアセンブリを読み込んだ後、同じアセンブリを、読み込みコンテキストにあるアセンブリが表示名で読み込もうとすると、読み込みが失敗します。 この問題は、アセンブリが逆シリアル化されるときに発生します。

• アセンブリが でLoadFrom読み込まれ、プローブ パスに同じ ID を持つアセンブリが含まれているが、場所が異なる場合、、InvalidCastExceptionMissingMethodException、またはその他の予期しない動作が発生する可能性があります。

• LoadFrom には、指定したパスに対する FileIOPermissionAccess.Read および FileIOPermissionAccess.PathDiscovery、または WebPermission が必要です。

• のネイティブ イメージが存在する assemblyFile場合は、使用されません。 アセンブリをドメインニュートラルとして読み込むことができません。

アセンブリに対して特定のアクセス許可を付与するかどうかは、証拠に基づいて決定されます。 アセンブリとセキュリティ証拠のマージの規則は次のとおりです。

• パラメーターを指定しないEvidenceメソッドをLoadFrom使用すると、ローダーが提供する証拠がアセンブリに読み込まれます。

• パラメーターを指定して メソッドをLoadFromEvidence使用すると、証拠の一部がマージされます。 メソッドの引数として提供される証拠の一部は、 LoadFrom ローダーによって提供される証拠の一部よりも優先されます。

• 同じアセンブリでこのメソッドを複数回呼び出しても、異なる証拠が指定されている場合、異なる証拠仕様の等価性と整合性を判断できないため、共通言語ランタイムは をスロー FileLoadException しません。 最初に成功する証拠は、使用される証拠です。

• パラメーターを指定してメソッドをLoadFromByte[]使用して共通オブジェクト ファイル形式 (COFF) イメージを読み込むと、証拠が結合されます。 Zoneは UrlSite呼び出し元のアセンブリから継承され、StrongNameHash COFF アセンブリから取得されます。

• パラメーターを指定して メソッドをLoadFromByte[]使用しEvidence、COFF イメージを読み込む場合は、指定された証拠のみが使用されます。 呼び出し元アセンブリの証拠と COFF イメージの証拠は無視されます。

こちらもご覧ください

• Evidence