Exception.HResult Property
Assembly: mscorlib (in mscorlib.dll)
'Declaration Protected Property HResult As Integer 'Usage Dim value As Integer value = Me.HResult Me.HResult = value
/** @property */ protected int get_HResult () /** @property */ protected void set_HResult (int value)
protected function get HResult () : int protected function set HResult (value : int)
Not applicable.
Property Value
The HRESULT value.HRESULT is a 32-bit value, divided into three different fields: a severity code, a facility code, and an error code. The severity code indicates whether the return value represents information, warning, or error. The facility code identifies the area of the system responsible for the error. The error code is a unique number that is assigned to represent the exception. Each exception is mapped to a distinct HRESULT. When managed code throws an exception, the runtime passes the HRESULT to the COM client. When unmanaged code returns an error, the HRESULT is converted to an exception, which is then thrown by the runtime.
The following code example defines a derived Exception class that sets the HResult property in its constructor.
' Example for the Exception.HResult property. Imports System Imports Microsoft.VisualBasic Namespace NDP_UE_VB ' Create the derived exception class. Class SecondLevelException Inherits Exception Private Const SecondLevelHResult As Integer = &H81234567 ' Set HResult for this exception, and include it in ' the exception message. Public Sub New(message As String, inner As Exception) MyBase.New( String.Format( "(HRESULT:0x{1:X8}) {0}", _ message, SecondLevelHResult ), inner ) HResult = SecondLevelHResult End Sub ' New End Class ' SecondLevelException Module HResultDemo Sub Main() Console.WriteLine( _ "This example of Exception.HResult " & _ "generates the following output." & vbCrLf ) ' This function forces a division by 0 and throws ' a second exception. Try Try Dim zero As Integer = 0 Dim ecks As Integer = 1 \ zero Catch ex As Exception Throw New SecondLevelException( _ "Forced a division by 0 and threw " & _ "a second exception.", ex ) End Try Catch ex As Exception Console.WriteLine( ex.ToString( ) ) End Try End Sub ' Main End Module ' HResultDemo End Namespace ' NDP_UE_VB ' This example of Exception.HResult generates the following output. ' ' NDP_UE_VB.SecondLevelException: (HRESULT:0x81234567) Forced a division by 0 a ' nd threw a second exception. ---> System.DivideByZeroException: Attempted to ' divide by zero. ' at NDP_UE_VB.HResultDemo.Main() ' --- End of inner exception stack trace --- ' at NDP_UE_VB.HResultDemo.Main()
// Example for the Exception.HResult property.
package NDP_UE_JSL ;
import System.* ;
// Create the derived exception class.
class SecondLevelException extends System.Exception
{
private int SecondLevelHResult = (int)(0x81234567);
// Set HResult for this exception, and include it in
// the exception message.
public SecondLevelException(String message, System.Exception inner)
{
super(String.Format("(HRESULT:0x{1:X8}) {0}", message,
((System.Int32)(int)(0x81234567)).ToString("X8")), inner);
set_HResult(SecondLevelHResult);
} //SecondLevelException
} //SecondLevelException
class HResultDemo
{
public static void main(String[] args)
{
Console.WriteLine(("This example of Exception.HResult "
+ "generates the following output.\n"));
// This function forces a division by 0 and throws
// a second exception.
try {
try {
int zero = 0;
int ecks = 1 / zero;
}
catch (System.Exception ex) {
throw new SecondLevelException("Forced a division by 0 and "
+ "threw a second exception.", ex);
}
}
catch (System.Exception ex) {
Console.WriteLine(ex.toString());
}
} //main
} //HResultDemo
/*
This example of Exception.HResult generates the following output.
NDP_UE_JSL.SecondLevelException: (HRESULT:0x81234567) Forced a division by 0
and threw a second exception. ---> System.DivideByZeroException: Attempted to
divi de by zero.
at NDP_UE_JSL.HResultDemo.Main()
--- End of inner exception stack trace ---
at NDP_UE_JSL.HResultDemo.Main()
*/
Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.