FileLoadException Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
A exceção que é lançada quando um assembly gerido é encontrado mas não pode ser carregado.
public ref class FileLoadException : System::IO::IOExceptionpublic 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.IOExceptiontype FileLoadException = class
inherit IOException[<System.Serializable>]
type FileLoadException = class
inherit IOException[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type FileLoadException = class
inherit IOExceptionPublic Class FileLoadException
Inherits IOException- Herança
- Herança
- Atributos
Observações
Representa o erro que ocorre quando um Assembly ficheiro é encontrado mas não pode ser carregado.
A FileNotFoundException exceção é lançada quando o ficheiro não carrega porque não pode ser localizado. Se o ficheiro for localizado, mas não puder ser carregado devido a permissões insuficientes, a SecurityException é lançado.
FileLoadException tem o HRESULT por defeito de COR_E_FILELOAD, que tem o valor 0x80131621, mas este não é o único HRESULT possível.
O momento exato de quando as referências estáticas de montagem são carregadas não é especificado. Esta exceção pode ser lançada antes de o método que referencia estaticamente a assembly que falhou ao carregamento começar a ser executado.
Note
Esta exceção não está incluída no .NET para aplicações Windows Store nem na Portable Class Library, mas é lançada por alguns membros que são. Para apanhar a exceção nesse caso, escreva uma catch instrução para IOException em vez disso.
Dicas Associadas
Certifica-te de que o ficheiro é um assembly .NET válido. Esta exceção é lançada se o ficheiro não for um assembly .NET válido. Para obter mais informações, veja Assembly.
Verifique se um conjunto ou módulo não foi carregado duas vezes com duas provas diferentes. A evidência é o conjunto de informação que constitui influência nas decisões de política de segurança, como as permissões que podem ser concedidas ao código. Para mais informações, veja GacRemove e Evidence
Se usar os RegisterAssembly métodos ou, UnRegisterAssembly verifique se o nome da montagem não é superior ao comprimento máximo definido pelo sistema. O comprimento do nome da assembleia não pode exceder o máximo definido pelo sistema. Para obter mais informações, veja PathTooLongException.
Ao carregar uma montagem de satélite, certifique-se de que o CultureInfo especificado corresponde ao CultureInfo do ficheiro. Assemblies satélite contêm recursos localizados que contêm código executável não localizável e recursos para uma única cultura que servem como cultura padrão ou neutra. Para obter mais informações, veja GetSatelliteAssembly.
Construtores
| Name | Description |
|---|---|
| FileLoadException() |
Inicializa uma nova instância da FileLoadException classe, definindo a Message propriedade da nova instância para uma mensagem fornecida pelo sistema que descreve o erro, como "Não foi possível carregar o ficheiro especificado." Esta mensagem tem em conta a cultura atual do sistema. |
| FileLoadException(SerializationInfo, StreamingContext) |
Inicializa uma nova instância da FileLoadException classe com dados serializados. |
| FileLoadException(String, Exception) |
Inicializa uma nova instância da FileLoadException classe com uma mensagem de erro especificada e uma referência à exceção interna que é a causa dessa exceção. |
| FileLoadException(String, String, Exception) |
Inicializa uma nova instância da FileLoadException classe com uma mensagem de erro especificada, o nome do ficheiro que não pôde ser carregado e uma referência à exceção interna que é a causa dessa exceção. |
| FileLoadException(String, String) |
Inicializa uma nova instância da FileLoadException classe com uma mensagem de erro especificada e o nome do ficheiro que não pôde ser carregado. |
| FileLoadException(String) |
Inicializa uma nova instância da FileLoadException classe com a mensagem de erro especificada. |
Propriedades
| Name | Description |
|---|---|
| Data |
Obtém uma coleção de pares chave/valor que fornecem informação adicional definida pelo utilizador sobre a exceção. (Herdado de Exception) |
| FileName |
Obtém o nome do ficheiro que causa esta exceção. |
| FusionLog |
Recebe o ficheiro de registo que explica porque é que uma carga de montagem falhou. |
| HelpLink |
Obtém ou define um link para o ficheiro de ajuda associado a esta exceção. (Herdado de Exception) |
| HResult |
Recebe ou define HRESULT, um valor numérico codificado atribuído a uma exceção específica. (Herdado de Exception) |
| InnerException |
Obtém a Exception instância que causou a exceção atual. (Herdado de Exception) |
| Message |
Recebe a mensagem de erro e o nome do ficheiro que causou esta exceção. |
| Source |
Obtém ou define o nome do aplicativo ou o objeto que causa o erro. (Herdado de Exception) |
| StackTrace |
Obtém uma representação string dos frames imediatos na stack de chamadas. (Herdado de Exception) |
| TargetSite |
Obtém o método que lança a exceção atual. (Herdado de Exception) |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetBaseException() |
Quando sobrescrito numa classe derivada, devolve o Exception que é a causa raiz de uma ou mais exceções subsequentes. (Herdado de Exception) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
Define o SerializationInfo com o nome do ficheiro e informações adicionais de exceção. |
| GetType() |
Obtém o tipo de execução da instância atual. (Herdado de Exception) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToString() |
Devolve o nome totalmente qualificado da exceção atual, e possivelmente a mensagem de erro, o nome da exceção interna e o rastreio da pilha. |
evento
| Name | Description |
|---|---|
| SerializeObjectState |
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) |