Assembly.LoadFrom Método

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

Parâmetros

Devoluções

O conjunto carregado.

Atributos

ObsoleteAttribute

Exceções

Observações

O assemblyFile parâmetro deve referir-se a um URI sem caracteres de escape. Este método fornece caracteres de escape para todos os caracteres inválidos no URI.

assemblyFile pode ser absoluto ou relativo ao diretório atual.

Os assemblies podem ser carregados num de três contextos, ou podem ser carregados sem contexto:

• O contexto de carregamento contém assemblies encontrados por sondagem: no GAC, numa loja de montagem host se o runtime estiver alojado, ou no ApplicationBase domínio e PrivateBinPath do domínio da aplicação. A maioria das sobrecargas do método Load carrega conjuntos de programas nesse contexto.

• O contexto load-from contém assemblies para os quais o utilizador forneceu um caminho não incluído nos diretórios pesquisados por sondagem. LoadFrom, CreateInstanceFrome ExecuteAssembly são exemplos de métodos que carregam por caminho.

  Veja <loadFromRemoteSources> para carregar conjuntos a partir de locais remotos.

• O contexto apenas de reflexão contém assemblies carregadas com os ReflectionOnlyLoad métodos e; ReflectionOnlyLoadFrom o código nestes contextos não pode ser executado.

• Se o utilizador gerou ou encontrou a montagem, não está em nenhum contexto. Isto aplica-se a assemblies carregados usando sobrecargas do Load método que especificam um array de bytes contendo um assembly, e a assemblies dinâmicos transitórios criados com reflection emit e não guardados em disco.

O contexto load-from permite que um assembly seja carregado a partir de um caminho não incluído na sondagem, e ainda assim permite que dependências desse caminho sejam encontradas e carregadas porque a informação do caminho é mantida pelo contexto.

O LoadFrom método apresenta as seguintes desvantagens. Em vez disso, considere usar Load.

• Se uma montagem com a mesma identidade já estiver carregada, LoadFrom devolve a montagem carregada mesmo que tenha sido especificado um caminho diferente.

• Se um assembly for carregado com LoadFrom, e mais tarde um assembly no contexto de carga tentar carregar o mesmo assembly por nome de visualização, a tentativa de carregamento falha. Isso pode ocorrer quando um assembly é desserializado.

• Se um conjunto estiver carregado com LoadFrom, e o caminho de sondagem incluir um conjunto com a mesma identidade mas com uma localização diferente, pode ocorrer um InvalidCastException, MissingMethodException, ou outro comportamento inesperado.

• LoadFrom exige FileIOPermissionAccess.Read e FileIOPermissionAccess.PathDiscovery, ou WebPermission, no caminho especificado.

• Se existir uma imagem nativa para assemblyFile, ela não é utilizada. O assembly não pode ser carregado como neutro de domínio.

Se certas permissões são concedidas ou não a uma assembleia é baseado em evidências. As regras para a fusão de provas de reunião e segurança são as seguintes:

• Quando se usa um LoadFrom método sem parâmetro Evidence , o conjunto é carregado com a evidência que o carregador fornece.

• Quando se usa um LoadFrom método com um Evidence parâmetro, partes de evidência são fundidas. As provas fornecidas como argumento para o LoadFrom método sobrepõem-se às provas fornecidas pelo carregador.

• Se chamar este método mais do que uma vez na mesma montagem mas com uma evidência diferente especificada, o runtime da linguagem comum não lança a FileLoadException porque a igualdade e integridade das diferentes especificações de evidência não podem ser determinadas. A evidência que primeiro tem sucesso é a evidência utilizada.

• Quando se usa um LoadFrom método com um Byte[] parâmetro para carregar uma imagem em formato de ficheiro de objeto comum (COFF), a evidência é combinada. Zone, Url e Site são herdados da assembleia de chamada, e Hash e são StrongName retirados da assembleia COFF.

• Quando se usa um LoadFrom método com um Byte[] parâmetro e Evidence se carrega uma imagem COFF, apenas a evidência fornecida é utilizada. A evidência da assembleia de chamada e a evidência da imagem COFF são ignoradas.

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);

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

Parâmetros

Devoluções

O conjunto carregado.

Exceções

Observações

Esta API não é suportada no .NET Core/.NET 5+. Este método lança NotSupportedException quando é chamado. Utilize LoadFrom(String) em substituição.

O assemblyFile parâmetro deve referir-se a um URI sem caracteres de escape. Este método fornece caracteres de escape para todos os caracteres inválidos no URI.

assemblyFile pode ser absoluto ou relativo ao diretório atual.

Os assemblies podem ser carregados num de três contextos, ou podem ser carregados sem contexto:

• O contexto de carregamento contém assemblies encontrados por sondagem: na cache assembly global, numa loja assembly host se o runtime estiver alojado, ou no ApplicationBase domínio e PrivateBinPath do domínio de aplicação. A maioria das sobrecargas do método Load carrega conjuntos de programas nesse contexto.

• O contexto load-from contém assemblies para os quais o utilizador forneceu um caminho que não está incluído na sondagem. LoadFrom, CreateInstanceFrome ExecuteAssembly são exemplos de métodos que carregam por caminho.

  Veja <loadFromRemoteSources> para carregar conjuntos a partir de locais remotos.

• O contexto apenas de reflexão contém assemblies carregadas com os ReflectionOnlyLoad métodos e; ReflectionOnlyLoadFrom o código nestes contextos não pode ser executado.

• Se o utilizador gerou ou encontrou a montagem, não está em nenhum contexto. Isto aplica-se a assemblies carregados usando sobrecargas do Load método que especificam um array de bytes contendo um assembly, e a assemblies dinâmicos transitórios criados com reflection emit e não guardados em disco.

O contexto load-from permite que um assembly seja carregado a partir de um caminho que não está incluído na sondagem, e ainda assim permite que dependências desse caminho sejam encontradas e carregadas porque a informação do caminho é mantida pelo contexto.

O LoadFrom método apresenta as seguintes desvantagens. Em vez disso, considere usar Load.

• Se uma montagem com a mesma identidade já estiver carregada, LoadFrom devolve a montagem carregada mesmo que tenha sido especificado um caminho diferente.

• Se um assembly for carregado com LoadFrom, e mais tarde um assembly no contexto de carga tentar carregar o mesmo assembly por nome de visualização, a tentativa de carregamento falha. Isso pode ocorrer quando um assembly é desserializado.

• Se um conjunto estiver carregado com LoadFrom, e o caminho de sondagem incluir um conjunto com a mesma identidade mas com uma localização diferente, pode ocorrer um InvalidCastException, MissingMethodException, ou outro comportamento inesperado.

• LoadFrom exige FileIOPermissionAccess.Read e FileIOPermissionAccess.PathDiscovery, ou WebPermission, no caminho especificado.

• Se existir uma imagem nativa para assemblyFile, ela não é utilizada. O conjunto não pode ser carregado como neutro ao domínio.

O conjunto está carregado com as provas que o carregador fornece.

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

Parâmetros

Devoluções

O conjunto carregado.

Exceções

Exemplos

O exemplo seguinte carrega um assembly dado o seu nome de ficheiro ou caminho.

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

Observações

Esta API está presente no .NET Core para compatibilidade, mas recomenda-se usar sobrecargas AssemblyLoadContext em vez disso.

O assembly é carregado no AssemblyLoadContext predefinido. Para mais informações sobre carregamento de montagem, consulte Algoritmo de carregamento de montagem gerido.

O assemblyFile parâmetro deve referir-se a um URI sem caracteres de escape. Este método fornece caracteres de escape para todos os caracteres inválidos no URI.

assemblyFile pode ser absoluto ou relativo ao diretório atual.

.NET Framework apenas: Assemblies podem ser carregados num de três contextos, ou podem ser carregados sem contexto:

• O contexto de carregamento contém assemblies encontrados por sondagem: no GAC, numa loja de montagem host se o runtime estiver alojado, ou no ApplicationBase domínio e PrivateBinPath do domínio da aplicação. A maioria das sobrecargas do método Load carrega conjuntos de programas nesse contexto.

• O contexto load-from contém assemblies para os quais o utilizador forneceu um caminho não incluído nos diretórios pesquisados por sondagem. Também permite encontrar e carregar dependências nesse caminho porque a informação do caminho é mantida pelo contexto. LoadFrom, CreateInstanceFrome ExecuteAssembly são exemplos de métodos que carregam por caminho.

  Veja <loadFromRemoteSources> para carregar conjuntos a partir de locais remotos.

• O contexto apenas de reflexão contém assemblies carregadas com os ReflectionOnlyLoad métodos e; ReflectionOnlyLoadFrom o código nestes contextos não pode ser executado.

• Se o utilizador gerou ou encontrou a montagem, não está em nenhum contexto. Isto aplica-se a assemblies carregados usando sobrecargas do Load método que especificam um array de bytes contendo um assembly, e a assemblies dinâmicos transitórios criados com reflection emit e não guardados em disco.

O LoadFrom método apresenta as seguintes desvantagens. Em vez disso, considere usar Load.

• Se um assembly com a mesma identidade já estiver carregado no contexto load-from, LoadFrom retornará o assembly carregado mesmo que um caminho diferente tenha sido especificado.

• Um assembly pode ser carregado no contexto load-from mesmo que exista um assembly com a mesma identidade no contexto de carga. A interoperabilidade entre os dois assemblies não funciona, levando a erros como InvalidCastException, MissingMethodException, ou outros comportamentos inesperados.

• Chamar LoadFrom com uma localização que está no caminho de sondagem carrega o conjunto no contexto de carga e não no contexto load-from.

• Se um ficheiro de montagem cuja identidade é governada por uma política de redirecionamento de ligação for passado para LoadFrom, a política será aplicada e o assembly será carregado a partir do caminho de sondagem no contexto de carga.

• Se um assembly for carregado no contexto load-from, e mais tarde um assembly no contexto de load tentar carregar o mesmo assembly pelo nome de visualização, a tentativa de carregamento falha. Isso pode ocorrer quando um assembly é desserializado.

• LoadFrom exige FileIOPermissionAccess.Read e FileIOPermissionAccess.PathDiscovery, ou WebPermission, no caminho especificado.

• Se existir uma imagem nativa para assemblyFile, ela não é utilizada. O assembly não pode ser carregado como neutro de domínio.

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

Parâmetros

Devoluções

O conjunto carregado.

Atributos

ObsoleteAttribute

Exceções

Observações

O assemblyFile parâmetro deve referir-se a um URI sem caracteres de escape. Este método fornece caracteres de escape para todos os caracteres inválidos no URI.

assemblyFile pode ser absoluto ou relativo ao diretório atual.

Os assemblies podem ser carregados num de três contextos, ou podem ser carregados sem contexto:

• O contexto de carregamento contém assemblies encontrados por sondagem: no GAC, numa loja de montagem host se o runtime estiver alojado, ou no ApplicationBase domínio e PrivateBinPath do domínio da aplicação. A maioria das sobrecargas do método Load carrega conjuntos de programas nesse contexto.

• O contexto load-from contém assemblies para os quais o utilizador forneceu um caminho não incluído nos diretórios pesquisados por sondagem. LoadFrom, CreateInstanceFrome ExecuteAssembly são exemplos de métodos que carregam por caminho.

  Veja <loadFromRemoteSources> para carregar conjuntos a partir de locais remotos.

• O contexto apenas de reflexão contém assemblies carregadas com os ReflectionOnlyLoad métodos e; ReflectionOnlyLoadFrom o código nestes contextos não pode ser executado.

• Se o utilizador gerou ou encontrou a montagem, não está em nenhum contexto. Isto aplica-se a assemblies carregados usando sobrecargas do Load método que especificam um array de bytes contendo um assembly, e a assemblies dinâmicos transitórios criados com reflection emit e não guardados em disco.

O contexto load-from permite que um assembly seja carregado a partir de um caminho não incluído na sondagem, e ainda assim permite que dependências desse caminho sejam encontradas e carregadas porque a informação do caminho é mantida pelo contexto.

O LoadFrom método apresenta as seguintes desvantagens. Em vez disso, considere usar Load.

• Se uma montagem com a mesma identidade já estiver carregada, LoadFrom devolve a montagem carregada mesmo que tenha sido especificado um caminho diferente.

• Se um assembly for carregado com LoadFrom, e mais tarde um assembly no contexto de carga tentar carregar o mesmo assembly por nome de visualização, a tentativa de carregamento falha. Isso pode ocorrer quando um assembly é desserializado.

• Se um conjunto estiver carregado com LoadFrom, e o caminho de sondagem incluir um conjunto com a mesma identidade mas com uma localização diferente, pode ocorrer um InvalidCastException, MissingMethodException, ou outro comportamento inesperado.

• LoadFrom exige FileIOPermissionAccess.Read e FileIOPermissionAccess.PathDiscovery, ou WebPermission, no caminho especificado.

• Se existir uma imagem nativa para assemblyFile, ela não é utilizada. O assembly não pode ser carregado como neutro de domínio.

Se certas permissões são concedidas ou não a uma assembleia é baseado em evidências. As regras para a fusão de provas de reunião e segurança são as seguintes:

• Quando se usa um LoadFrom método sem parâmetro Evidence , o conjunto é carregado com a evidência que o carregador fornece.

• Quando se usa um LoadFrom método com um Evidence parâmetro, partes de evidência são fundidas. As provas fornecidas como argumento para o LoadFrom método sobrepõem-se às provas fornecidas pelo carregador.

• Se chamar este método mais do que uma vez na mesma montagem mas com uma evidência diferente especificada, o runtime da linguagem comum não lança a FileLoadException porque a igualdade e integridade das diferentes especificações de evidência não podem ser determinadas. A evidência que primeiro tem sucesso é a evidência utilizada.

• Quando se usa um LoadFrom método com um Byte[] parâmetro para carregar uma imagem em formato de ficheiro de objeto comum (COFF), a evidência é combinada. Zone, Url e Site são herdados da assembleia de chamada, e Hash e são StrongName retirados da assembleia COFF.

• Quando se usa um LoadFrom método com um Byte[] parâmetro e Evidence se carrega uma imagem COFF, apenas a evidência fornecida é utilizada. A evidência da assembleia de chamada e a evidência da imagem COFF são ignoradas.

Ver também

• Evidence