Прочитать на английском

Поделиться через


Win32Exception Класс

Определение

Создает исключение для кода ошибки Win32.

public class Win32Exception : Exception
public class Win32Exception : System.Runtime.InteropServices.ExternalException
[System.Serializable]
public class Win32Exception : System.Runtime.InteropServices.ExternalException
Наследование
Win32Exception
Наследование
Производный
Атрибуты
Реализации

Примеры

В следующем примере кода показано, как перехватывать исключение Win32 и интерпретировать его содержимое. В примере выполняется попытка запустить несуществующий исполняемый файл, что приводит к возникновению исключения Win32. После перехвата исключения в примере извлекается соответствующее сообщение об ошибке, код и источник исключения.

try
{
    System.Diagnostics.Process myProc = new();
    myProc.StartInfo.FileName = @"c:\nonexist.exe"; // Attempt to start a non-existent executable
    myProc.Start();
}
catch (Win32Exception w)
{
    Console.WriteLine(w.Message);
    Console.WriteLine(w.ErrorCode.ToString());
    Console.WriteLine(w.NativeErrorCode.ToString());
    Console.WriteLine(w.StackTrace);
    Console.WriteLine(w.Source);
    Exception e = w.GetBaseException();
    Console.WriteLine(e.Message);
}

Комментарии

Коды ошибок типа Win32 при отображении преобразуются из их числового представления в системное сообщение. Используйте NativeErrorCode для доступа к числовым представлениям кода ошибки, связанного с этим исключением. Дополнительные сведения о кодах ошибок см. в разделе Коды ошибок Win32.

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

Win32Exception()

Инициализирует новый экземпляр класса Win32Exception, используя последнюю возникшую ошибку Win32.

Win32Exception(Int32)

Инициализирует новый экземпляр класса Win32Exception, используя указанную ошибку.

Win32Exception(Int32, String)

Инициализирует новый экземпляр класса Win32Exception, используя заданную ошибку и заданное подробное описание.

Win32Exception(SerializationInfo, StreamingContext)
Устаревшие..

Инициализирует новый экземпляр класса Win32Exception, используя заданный контекст и сведения о сериализации.

Win32Exception(String)

Инициализирует новый экземпляр класса Win32Exception, используя заданное подробное описание.

Win32Exception(String, Exception)

Инициализирует новый экземпляр класса Win32Exception с указанным подробным описанием и указанным исключением.

Свойства

Data

Возвращает коллекцию пар «ключ-значение», предоставляющую дополнительные сведения об исключении.

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

Возвращает HRESULT ошибки.

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

Получает или задает ссылку на файл справки, связанный с этим исключением.

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

Возвращает или задает HRESULT — кодированное числовое значение, присвоенное определенному исключению.

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

Возвращает экземпляр класса Exception, который вызвал текущее исключение.

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

Возвращает сообщение, описывающее текущее исключение.

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

Возвращает код ошибки Win32, связанной с этим исключением.

Source

Возвращает или задает имя приложения или объекта, вызывавшего ошибку.

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

Получает строковое представление непосредственных кадров в стеке вызова.

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

Возвращает метод, создавший текущее исключение.

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

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

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

При переопределении в производном классе возвращает исключение Exception, которое является первопричиной одного или нескольких последующих исключений.

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

Служит хэш-функцией по умолчанию.

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

Задает объект SerializationInfoс именем файла и номером строки, в которых возникло исключение Win32Exception.

GetObjectData(SerializationInfo, StreamingContext)
Устаревшие..

При переопределении в производном классе задает объект SerializationInfo со сведениями об исключении.

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

Возвращает тип среды выполнения текущего экземпляра.

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

Создает неполную копию текущего объекта Object.

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

Возвращает строку, которая содержит NativeErrorCode, HResult или и то и другое.

ToString()

Создает и возвращает строковое представление текущего исключения.

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

Возвращает строку, содержащую значение HRESULT ошибки.

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

События

SerializeObjectState
Устаревшие..

Возникает, когда исключение сериализовано для создания объекта состояния исключения, содержащего сериализованные данные об исключении.

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

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

Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0