Win32Exception Класс

Ссылка

Определение

Пространство имен:: System.ComponentModel

Сборки:: Microsoft.Win32.Primitives.dll, System.dll

Сборка:: Microsoft.Win32.Primitives.dll

Сборка:: System.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

public ref class Win32Exception : Exception

public ref class Win32Exception : System::Runtime::InteropServices::ExternalException

public class Win32Exception : Exception

public class Win32Exception : System.Runtime.InteropServices.ExternalException

[System.Serializable]
public class Win32Exception : System.Runtime.InteropServices.ExternalException

type Win32Exception = class
    inherit Exception

type Win32Exception = class
    inherit ExternalException
    interface ISerializable

[<System.Serializable>]
type Win32Exception = class
    inherit ExternalException
    interface ISerializable

Public Class Win32Exception
Inherits Exception

Public Class Win32Exception
Inherits ExternalException

Наследование: Object

Exception
Win32Exception

Наследование: Object

Exception

SystemException

ExternalException
Win32Exception

Производный: System.Net.HttpListenerException

System.Net.NetworkInformation.NetworkInformationException

System.Net.Sockets.SocketException

System.Net.WebSockets.WebSocketException

Атрибуты: SerializableAttribute

Реализации: ISerializable

Примеры

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

try
{
   System::Diagnostics::Process^ myProc = gcnew System::Diagnostics::Process;
   //Attempting to start a non-existing executable
   myProc->StartInfo->FileName = "c:\nonexist.exe";
   //Start the application and assign it to the process component.
   myProc->Start();
}
catch ( Win32Exception^ w ) 
{
   Console::WriteLine( w->Message );
   Console::WriteLine( w->ErrorCode );
   Console::WriteLine( w->NativeErrorCode );
   Console::WriteLine( w->StackTrace );
   Console::WriteLine( w->Source );
   Exception^ e = w->GetBaseException();
   Console::WriteLine( e->Message );
}

try {
System.Diagnostics.Process myProc = new System.Diagnostics.Process();
myProc.StartInfo.FileName = "c:\nonexist.exe";  //Attempting to start a non-existing executable
myProc.Start();    //Start the application and assign it to the process component.    
}
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);
}

Try
    Dim myProc As New System.Diagnostics.Process()
    myProc.StartInfo.FileName = "c:\nonexist.exe"  'Attempting to start a non-existing executable
    myProc.Start()    'Start the application and assign it to the process component.    

Catch w As System.ComponentModel.Win32Exception
    Console.WriteLine(w.Message)
    Console.WriteLine(w.ErrorCode.ToString())
    Console.WriteLine(w.NativeErrorCode.ToString())
    Console.WriteLine(w.StackTrace)
    Console.WriteLine(w.Source)
    Dim e As New Exception()
    e = w.GetBaseException()
    Console.WriteLine(e.Message)
End Try

Коды ошибок типа 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)

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