Raising an Exception Intentionally in VB.net

By: Steven Holzner Emailed: 1700 times Printed: 2205 times    

Latest comments
By: rohit kumar - how this program is work
By: Kirti - Hi..thx for the hadoop in
By: Spijker - I have altered the code a
By: ali mohammed - why we use the java in ne
By: ali mohammed - why we use the java in ne
By: mizhelle - when I exported the data
By: raul - no output as well, i'm ge
By: Rajesh - thanx very much...
By: Suindu De - Suppose we are executing

There are cases in programs where you might want to create an exception because, although no Visual Basic trappable exception has occurred, some situation may have occurred that's incompatible with your program's logic. You can create an exception intentionally, called raising an exception, with the Visual Basic Err object's Raise method, which is declared this way internally in VB .NET:

Raise(ByVal Number As Integer, Optional ByVal Source As Object = Nothing,
Optional ByVal Description As Object = Nothing, Optional ByVal HelpFile As
Object = Nothing, Optional ByVal HelpContext As Object = Nothing)

Here are the arguments for the Raise method:

  • Number—Long integer that identifies the nature of the exception.

  • Source—String expression naming the object or application that generated the exception; use the form project.class. (If source is not specified, the name of the current Visual Basic project is used.)

  • Description—String expression describing the exception.

  • Helpfile—The path to the Help file in which help on this exception can be found.

  • Helpcontext—A context ID identifying a topic within helpfile that provides help for the exception.

When setting the exception number for a custom exception, note that Visual Basic reserves a certain range of exceptions for itself. To make sure your custom exception doesn't conflict with that range, add the value vbObjectError to your exception number, then subtract it when you handle the exception to recover your original exception number. Let's see an example. Here, I'll generate our own exception, exception number 51:

Module Module1
    Sub Main()
        On Error Goto Handler
        Err.Raise(vbObjectError + 51)
        System.Console.WriteLine("Program completed...")
Handler:
        System.Console.WriteLine("Error number {0} occurred: {1}", _
            Err.Number - vbObjectError, Err.Description)
    End Sub
End Module

You can handle these custom exceptions in the way that makes sense for your application. Here's what you see when you run this console application:

Error number 51 occurred: Application-defined or object-defined error.
Tip 

You can also use the Visual Basic Error statement to raise an error like this: Error errnumber. However, the Error function is considered obsolete now, replaced by the Raise method of the Err object.


VB.net Home | All VB.net Tutorials | Latest VB.net Tutorials

Sponsored Links

If this tutorial doesn't answer your question, or you have a specific question, just ask an expert here. Post your question to get a direct answer.



Bookmark and Share

Comments(0)


Be the first one to add a comment

Your name (required):


Your email(required, will not be shown to the public):


Your sites URL (optional):


Your comments:



More Tutorials by Steven Holzner
Changes in Controls from VB6 to VB.net
Throwing a Custom Exception in VB.net
Throwing an Exception in VB.net
Using Finally in VB.net
Using Multiple Catch Statements in VB.net
Exception Filtering in the Catch Block in VB.net
Raising an Exception Intentionally in VB.net
Getting an Exception's Number and Description in VB.net
Using On Error GoTo 0 in VB.net
Using Resume Next and Resume Line in VB.net
Understanding Scope in VB.net
Properties in VB.net
Procedure Delegates in VB.net
Preserving a Variable's Values between Procedure Calls in VB.net
Specifying Optional Arguments with default values in Procedures in VB.net

More Tutorials in VB.net
Scope in VB.net
Unstructured Exception Handling in VB.net
Structured Exception Handling in VB.net
Creating Sub Procedures in VB.net
Creating Functions in VB.net
Passing a Variable Number of Arguments to Procedures in VB.net
Specifying Optional Arguments with default values in Procedures in VB.net
Preserving a Variable's Values between Procedure Calls in VB.net
Procedure Delegates in VB.net
Properties in VB.net
Understanding Scope in VB.net
Using Resume Next and Resume Line in VB.net
Using On Error GoTo 0 in VB.net
Getting an Exception's Number and Description in VB.net
Raising an Exception Intentionally in VB.net

More Latest News
Most Viewed Articles (in VB.net )
How to export from DataGridView to excel using VB.net
XML and VB.net
Structured Exception Handling in VB.net
Nested If and Single line if statement
The For Loop in VB.net
Handling Strings in VB.net
Operators in VB.net
Sub Procedures and Functions in VB.net
How To Connect To A MySql Database in VB.net
Read Data from Excel using OLEDB in VB.NET 2005
Insert cell data in an Excel file using OLEDB in VB.net
How to export from database to excel using VB.net
Your first VB.NET Crystal Reports - A step by step guide
Server Socket Program sample in VB.net
Client Socket Program sample in VB.net
Most Emailed Articles (in VB.net)
Chat Server in VB.net
Procedure Delegates in VB.net
File operations in VB.net
Excel 2007 Data Validation Input Message using VB.net
Multi threaded Socket Programming in VB.net
XML and VB.net
How to create an XML file in VB.net
A tutorial on Chat Server and Chat Client in VB.net
Creating a Web Service in VB.net
“Using If with And” and Comparing two integers using If
Nested If and Single line if statement
The Select Case statement in VB.net
The For Loop in VB.net
What's New in VB .NET? A comparison of VB vs VB.net
What is .NET Framework and the Common Language Runtime?