FileLoadException Класс

Определение

Исключение, которое создается в случае, когда управляемая сборка найдена, но не может быть загружена.The exception that is thrown when a managed assembly is found but cannot be loaded.

public ref class FileLoadException : System::IO::IOException
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class FileLoadException : System.IO.IOException
type FileLoadException = class
    inherit IOException
Public Class FileLoadException
Inherits IOException
Наследование
Атрибуты

Комментарии

Представляет ошибку, которая возникает, когда файл Assembly найден, но не может быть загружен.Represents the error that occurs when a Assembly file is found but cannot be loaded.

Исключение FileNotFoundException возникает, когда не удается загрузить файл, так как он не может быть найден.The FileNotFoundException exception is thrown when the file fails to load because it cannot be located. Если файл расположен, но не может быть загружен из-за недостаточных разрешений, создается SecurityException.If the file is located, but cannot be loaded due to insufficient permissions, a SecurityException is thrown.

FileLoadException имеет значение HRESULT по умолчанию COR_E_FILELOAD со значением 0x80131621, но это не единственный возможный HRESULT.FileLoadException has the default HRESULT of COR_E_FILELOAD, which has the value 0x80131621, but this is not the only possible HRESULT.

Если код не имеет PathDiscovery разрешений, сообщение об ошибке для этого исключения может содержать только имена файлов или каталогов вместо полных путей.If your code does not have PathDiscovery permission, the error message for this exception may only contain file or directory names instead of fully qualified paths.

Примечание

Это исключение не включено в .NET для приложений Магазина Windows или в переносимую библиотеку классов, но вызывается некоторыми членами.This exception is not included in the .NET for Windows Store apps or the Portable Class Library, but it is thrown by some members that are. Чтобы перехватить исключение в этом случае, напишите оператор catch для IOException.To catch the exception in that case, write a catch statement for IOException instead.

Связанные советыAssociated Tips

Убедитесь, что файл является допустимой .NET Framework сборкой.Make sure that the file is a valid .NET Framework assembly.
Это исключение вызывается, если файл не является допустимой сборкой .NET Framework.This exception is thrown if the file is not a valid .NET Framework assembly. Для получения дополнительной информации см. Assembly.For more information, see Assembly.

Убедитесь, что сборка или модуль не были загружены дважды с двумя разными свидетельствами.Check to make sure an assembly or module was not loaded twice with two different evidences.
Свидетельство — это набор сведений, используемых для принятия решений политики безопасности, например, сведений о разрешениях, которые могут быть предоставлены коду.Evidence is the set of information that constitutes input to security policy decisions, such as what permissions can be granted to code. Дополнительные сведения см. в разделах GacRemove и Evidence.For more information, see GacRemove and Evidence

При использовании методов RegisterAssembly или UnRegisterAssembly убедитесь, что имя сборки не длиннее, чем максимальная длина, определенная системой.If using the RegisterAssembly or UnRegisterAssembly methods, check to make sure the assembly name is not longer than the system-defined maximum length.
Длина имени сборки не может превышать максимальное значение, заданное в системе.The assembly name's length cannot exceed the system-defined maximum. Для получения дополнительной информации см. PathTooLongException.For more information, see PathTooLongException.

При загрузке вспомогательной сборки убедитесь, что указанный объект CultureInfo соответствует CultureInfo файла.If loading a satellite assembly, make sure the specified CultureInfo matches the file's CultureInfo.
Вспомогательные сборки содержат локализованные ресурсы, содержащие не локализуемый исполняемый код и ресурсы для одного языка и региональных параметров, которые используются по умолчанию или при нейтральном языке и региональных параметрах.Satellite assemblies contain localized resources which contain non-localizable executable code and resources for a single culture that serve as the default or neutral culture. Для получения дополнительной информации см. GetSatelliteAssembly.For more information, see GetSatelliteAssembly.

Конструкторы

FileLoadException()

Выполняет инициализацию нового экземпляра класса FileLoadException и устанавливает свойство Message нового экземпляра на получение системного сообщения, описывающего ошибку, такого как "Заданный файл не найден".Initializes a new instance of the FileLoadException class, setting the Message property of the new instance to a system-supplied message that describes the error, such as "Could not load the specified file." Это сообщение учитывает текущую культуру системы.This message takes into account the current system culture.

FileLoadException(SerializationInfo, StreamingContext)

Инициализирует новый экземпляр класса FileLoadException с сериализованными данными.Initializes a new instance of the FileLoadException class with serialized data.

FileLoadException(String)

Инициализирует новый экземпляр класса FileLoadException указанным сообщением об ошибке.Initializes a new instance of the FileLoadException class with the specified error message.

FileLoadException(String, Exception)

Инициализирует новый экземпляр класса FileLoadException указанным сообщением об ошибке и ссылкой на внутреннее исключение, вызвавшее данное исключение.Initializes a new instance of the FileLoadException class with a specified error message and a reference to the inner exception that is the cause of this exception.

FileLoadException(String, String)

Выполняет инициализацию нового экземпляра класса FileLoadException с заданным сообщением об ошибке и именем файла, который не может быть загружен.Initializes a new instance of the FileLoadException class with a specified error message and the name of the file that could not be loaded.

FileLoadException(String, String, Exception)

Выполняет инициализацию нового экземпляра класса FileLoadException с заданным сообщением об ошибке, именем файла, который не может быть загружен, и ссылкой на внутреннее исключение, являющееся причиной данного исключения.Initializes a new instance of the FileLoadException class with a specified error message, the name of the file that could not be loaded, and a reference to the inner exception that is the cause of this exception.

Свойства

Data

Возвращает коллекцию пар ключ/значение, предоставляющие дополнительные сведения об исключении, определяемые пользователем.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Унаследовано от Exception)
FileName

Возвращает имя файла, вызвавшего данное исключение.Gets the name of the file that causes this exception.

FusionLog

Возвращает имя журнала, в котором описано, почему загрузка сборки не выполнена.Gets the log file that describes why an assembly load failed.

HelpLink

Получает или задает ссылку на файл справки, связанный с этим исключением.Gets or sets a link to the help file associated with this exception.

(Унаследовано от Exception)
HResult

Возвращает или задает HRESULT — кодированное числовое значение, присвоенное определенному исключению.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Унаследовано от Exception)
InnerException

Возвращает экземпляр класса Exception, который вызвал текущее исключение.Gets the Exception instance that caused the current exception.

(Унаследовано от Exception)
Message

Получает сообщение об ошибке и имя файла, вызвавшего данное исключение.Gets the error message and the name of the file that caused this exception.

Source

Возвращает или задает имя приложения или объекта, вызывавшего ошибку.Gets or sets the name of the application or the object that causes the error.

(Унаследовано от Exception)
StackTrace

Получает строковое представление непосредственных кадров в стеке вызова.Gets a string representation of the immediate frames on the call stack.

(Унаследовано от Exception)
TargetSite

Возвращает метод, создавший текущее исключение.Gets the method that throws the current exception.

(Унаследовано от Exception)

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetBaseException()

При переопределении в производном классе возвращает исключение Exception, которое является первопричиной одного или нескольких последующих исключений.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Унаследовано от Exception)
GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetObjectData(SerializationInfo, StreamingContext)

Устанавливает SerializationInfo с именем файла и дополнительными сведениями об исключении.Sets the SerializationInfo with the file name and additional exception information.

GetType()

Возвращает тип среды выполнения текущего экземпляра.Gets the runtime type of the current instance.

(Унаследовано от Exception)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает полное имя текущего исключения и, возможно, сообщение об ошибке, имя внутреннего исключения и трассировку стека.Returns the fully qualified name of the current exception, and possibly the error message, the name of the inner exception, and the stack trace.

События

SerializeObjectState

Возникает, когда исключение сериализовано для создания объекта состояния исключения, содержащего сериализованные данные об исключении.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Унаследовано от Exception)

Применяется к

Дополнительно