FileLoadException Classe

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Origem:

FileLoadException.cs

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

type FileLoadException = class
    inherit IOException

Public Class FileLoadException
Inherits IOException

Herança

Object

Exception

SystemException

IOException

FileLoadException

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

Confira também

• Exception
• Tratando e gerando exceções no .NET
• E/S de arquivo e de fluxo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo