Partilhar via


FileLoadException Classe

Definição

A exceção que é gerada quando um assembly gerenciado é encontrado, mas não pode ser carregado.

public ref class FileLoadException : System::IO::IOException
public class FileLoadException : System.IO.IOException
[System.Serializable]
public class FileLoadException : System.IO.IOException
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class FileLoadException : System.IO.IOException
type FileLoadException = class
    inherit IOException
[<System.Serializable>]
type FileLoadException = class
    inherit IOException
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type FileLoadException = class
    inherit IOException
Public Class FileLoadException
Inherits IOException
Herança
FileLoadException
Herança
Atributos

Comentários

Representa o erro que ocorre quando um Assembly arquivo é encontrado, mas não pode ser carregado.

A FileNotFoundException exceção é gerada quando o arquivo falha ao carregar porque não pode ser localizado. Se o arquivo estiver localizado, mas não puder ser carregado devido a permissões insuficientes, um SecurityException será gerado.

FileLoadException tem o HRESULT padrão de COR_E_FILELOAD, que tem o valor 0x80131621, mas esse não é o único HRESULT possível.

O tempo exato de quando as referências de assembly estático são carregadas não é especificado. Essa exceção pode ser gerada antes que o método que referencia estaticamente o assembly que falhou ao carregar comece a ser executado.

Observação

Essa exceção não está incluída no .NET para aplicativos da Windows Store ou na Biblioteca de Classes Portátil, mas é gerada por alguns membros que estão. Para capturar a exceção nesse caso, escreva uma catch instrução para IOException em vez disso.

Dicas relacionadas

Verifique se o arquivo é um assembly .NET válido. Essa exceção será gerada se o arquivo não for um assembly .NET válido. Para obter mais informações, consulte Assembly.

{1>Verifique se um assembly ou módulo não foi carregado duas vezes com duas evidências diferentes.<1} Evidência é o conjunto de informações que constitui a entrada para decisões de política de segurança, como quais permissões podem ser concedidas ao código. Para obter mais informações, consulte GacRemove e Evidence.

Se estiver usando os RegisterAssembly métodos ou UnRegisterAssembly , marcar para garantir que o nome do assembly não seja maior do que o comprimento máximo definido pelo sistema. O comprimento do nome do assembly não pode exceder o máximo definido pelo sistema. Para obter mais informações, consulte PathTooLongException.

{1>Se estiver carregando um assembly satélite, verifique se o CultureInfo especificado corresponde ao CultureInfo do arquivo.<1} Os assemblies satélites contêm os recursos localizados que contêm o código executável não localizável e os recursos para uma única cultura que serve como o padrão ou cultura neutra. Para obter mais informações, consulte GetSatelliteAssembly.

Construtores

FileLoadException()

Inicializa uma nova instância da FileLoadException classe , definindo a Message propriedade da nova instância como uma mensagem fornecida pelo sistema que descreve o erro, como "Não foi possível carregar o arquivo especificado". Essa mensagem leva em conta a cultura atual do sistema.

FileLoadException(SerializationInfo, StreamingContext)
Obsoleto.

Inicializa uma nova instância da classe FileLoadException com dados serializados.

FileLoadException(String)

Inicializa uma nova instância da classe FileLoadException com a mensagem de erro especificada.

FileLoadException(String, Exception)

Inicializa uma nova instância da classe FileLoadException com uma mensagem de erro especificada e uma referência à exceção interna que é a causa da exceção.

FileLoadException(String, String)

Inicializa uma nova instância da classe FileLoadException com uma mensagem de erro especificada e o nome do arquivo que não pôde ser carregado.

FileLoadException(String, String, Exception)

Inicializa uma nova instância da classe FileLoadException com uma mensagem de erro especificada, o nome do arquivo que não pôde ser carregado e uma referência à exceção interna que é a causa da exceção.

Propriedades

Data

Obtém uma coleção de pares de chave/valor que fornecem informações definidas pelo usuário adicionais sobre a exceção.

(Herdado de Exception)
FileName

Obtém o nome do parâmetro que causa essa exceção.

FusionLog

Obtém o arquivo de log que descreve por que um carregamento de assembly falhou.

HelpLink

Obtém ou define um link para o arquivo de ajuda associado a essa exceção.

(Herdado de Exception)
HResult

Obtém ou define HRESULT, um valor numérico codificado que é atribuído a uma exceção específica.

(Herdado de Exception)
InnerException

Obtém a instância Exception que causou a exceção atual.

(Herdado de Exception)
Message

Obtém a mensagem de erro e o nome do arquivo que provocou essa exceção.

Source

Obtém ou define o nome do aplicativo ou objeto que causa o erro.

(Herdado de Exception)
StackTrace

Obtém uma representação de cadeia de caracteres de quadros imediatos na pilha de chamadas.

(Herdado de Exception)
TargetSite

Obtém o método que gerou a exceção atual.

(Herdado de Exception)

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetBaseException()

Quando substituído em uma classe derivada, retorna a Exception que é a causa raiz de uma ou mais exceções subsequentes.

(Herdado de Exception)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetObjectData(SerializationInfo, StreamingContext)
Obsoleto.

Define o SerializationInfo com o nome do arquivo e informações adicionais de exceção.

GetObjectData(SerializationInfo, StreamingContext)
Obsoleto.

Quando substituído em uma classe derivada, define o SerializationInfo com informações sobre a exceção.

(Herdado de Exception)
GetType()

Obtém o tipo de runtime da instância atual.

(Herdado de Exception)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna o nome totalmente qualificado da exceção atual e, possivelmente, a mensagem de erro, o nome da exceção interna e o rastreamento de pilha.

Eventos

SerializeObjectState
Obsoleto.

Ocorre quando uma exceção é serializada para criar um objeto de estado de exceção que contém dados serializados sobre a exceção.

(Herdado de Exception)

Aplica-se a

Confira também