ExternalException Класс

Определение

Базовый тип исключений для всех исключений COM-взаимодействия и исключений структурированной обработки исключений (SEH).The base exception type for all COM interop exceptions and structured exception handling (SEH) exceptions.

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

Комментарии

Чтобы улучшить взаимодействие между устаревшими системами и средой CLR, ErrorCode свойство сохраняет целочисленное значение (HRESULT), определяющее ошибку.To enhance interoperability between legacy systems and the common language runtime, the ErrorCode property stores an integer value (HRESULT) that identifies the error. Пользовательские исключения никогда не должны наследоваться ExternalExceptionот, ExternalException и никогда не должно вызываться пользовательским кодом.User defined exceptions should never derive from ExternalException, and an ExternalException should never be thrown by user code. Используйте конкретные исключения, производные от ExternalException .Use the specific exceptions that derive from ExternalException instead.

ExternalExceptionиспользует HRESULT E_FAIL, имеющий значение 0x80004005.ExternalException uses the HRESULT E_FAIL which has the value 0x80004005.

ExternalExceptionиспользует реализацию по Equals умолчанию, которая поддерживает равенство ссылок.ExternalException uses the default Equals implementation, which supports reference equality.

Список начальных значений для экземпляра ExternalExceptionсм. в ExternalException разделе конструкторы.For a list of initial values for an instance of ExternalException, see the ExternalException constructors.

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

ExternalException()

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

ExternalException(SerializationInfo, StreamingContext)

Инициализирует новый экземпляр класса ExternalException, используя данные сериализации.Initializes a new instance of the ExternalException class from serialization data.

ExternalException(String)

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

ExternalException(String, Exception)

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

ExternalException(String, Int32)

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

Свойства

Data

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

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

Возвращает HRESULT ошибки.Gets the HRESULT of the error.

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 a message that describes the current exception.

(Унаследовано от 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.When overridden in a derived class, sets the SerializationInfo with information about the exception.

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

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

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

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

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

Возвращает строку, содержащую значение HRESULT ошибки.Returns a string that contains the HRESULT of the error.

События

SerializeObjectState

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

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

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

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