C-Sharp Round Example – Code Sample Syntax
C-Sharp Round Example – Code Sample Syntax
Purpose: – Illustrates using C-Sharp Round Code Example.
Purpose:
takes a decimal or double as input parameter1
and returns the number rounded to the specified number
of fractional decimals. If parameter 2 is not used,
result is rounded to whole number. Parameter3 specifies
rounding mode
Syntax:
1. Round(decimal)
2. Round(decimal, int32)
3. Round(decimal, mode)
4. Round(decimal, int32, mode)
5. Round(double)
6. Round(double, int32)
7. Round(double, mode)
8. Round(double, int32, mode)
1. Round(decimal)
2. Round(decimal, int32)
3. Round(decimal, mode)
4. Round(decimal, int32, mode)
5. Round(double)
6. Round(double, int32)
7. Round(double, mode)
8. Round(double, int32, mode)
Parameters | Description | decimal | Any valid System.Decimal data type number double – any valid System.Double data type. Parameter1 specifies the number to be rounded |
---|---|
int32 or mode | 1. int32 specifies the number of fractional digits to be returned in the result. If there is no parameter2 or if it is mode, the result is rounded to a whole number. 2. mode – The mode parameter controls how value is rounded if the first decimal digit in value is 5 |
mode | The mode parameter controls how value is rounded if the first decimal digit in value is 5 There are two possible modes: 1. MidpointRounding.ToEven. If the one’s digit is odd, it is changed to an even digit. Otherwise, it is left unchanged. This is often called rounding to nearest, or banker’s rounding. It minimizes rounding errors that result from consistently rounding a midpoint value in a single direction. 2. MidpointRounding.AwayFromZero. The one’s digit is always rounded up to the next digit. This is the most popular rounding method. |
Result Data Type | Description | decimal or double | depends on data type of parameter1. It is decimal, if parameter1 is decimal. If parameter1 is double, result is double. |
---|
Quick Example | Round(3.5) // Returns 4 |
---|
Step 1: Click cs to Cut-n-paste code into clsRound.cs
using System; public class clsRound { public void Main() { //******************************************************************************** // Purpose: takes a decimal or double as input parameter1 // and returns the number rounded to the specified number // of fractional decimals. If parameter 2 is not used, // result is rounded to whole number. Parameter3 specifies // rounding mode // // Syntax: 1. Round(decimal) // 2. Round(decimal, int32) // 3. Round(decimal, mode) // 4. Round(decimal, int32, mode) // 5. Round(double) // 6. Round(double, int32) // 7. Round(double, mode) // 8. Round(double, int32, mode) // // Parameter1: decimal - Any valid System.Decimal data type number // double - any valid System.Double data type. // Parameter1 specifies the number to be rounded // // Parameter2: int32 or mode - 1. int32 specifies the number of fractional // digits to be returned in the result. If // there is no parameter2 or if it is mode, // the result is rounded to a whole number. // 2. mode - The mode parameter controls how // value is rounded if the first decimal // digit in value is 5 // // Parameter3: mode - The mode parameter controls how value // is rounded if the first decimal digit in value is 5 // There are two possible modes: // 1. MidpointRounding.ToEven. If the one's digit // is odd, it is changed to an even digit. // Otherwise, it is left unchanged. This is // often called rounding to nearest, or banker's // rounding. It minimizes rounding errors that // result from consistently rounding a midpoint // value in a single direction. // 2. MidpointRounding.AwayFromZero. The // one's digit is always rounded up to the // next digit. This is the most popular // rounding method. // // Result: decimal or double - depends on data type // of parameter1. It is decimal, if parameter1 is // decimal. If parameter1 is double, result is double. // // Quick Example: Round(3.5) // Returns 4 // //******************************************************************************** // This example is from http://idealprogrammer.com Console.WriteLine("Example #1: Round(decimal)"); Console.WriteLine("Round(3.5) = {0}", Math.Round(3.5)); // Returns 4 //write blank line to make output easier to read Console.WriteLine(); Console.WriteLine("Example #2: Round(double, mode)"); double myDouble = 6.5; Console.WriteLine("Round(myDouble, MidpointRounding.ToEven) = {0}", Math.Round(myDouble, MidpointRounding.ToEven)); // Returns 6 //write blank line to make output easier to read Console.WriteLine(); Console.WriteLine("Example #3: Round(double, mode)"); Console.WriteLine("Round(myDouble, MidpointRounding.AwayFromZero) = {0}", Math.Round(myDouble, MidpointRounding.AwayFromZero)); // Returns 7 //Prevent console from closing before you press enter Console.ReadLine(); } } |
Step 2: Click cs to Cut-n-paste code into Module1.cs
Module Module1 Sub Main() Dim myclsRound As New clsRound myclsRound.Main() End Sub End Module |
Prerequistes:
- Install C-Sharp (Express or Standard Edition)
- Install SQL Server Express
- Download Northwind and pubs Database
- Attach Northwind Database to Databases in Sql Express
- Attach pubs Database to Databases in Sql Express
Notes:
- Console Application is used to simplify things, but Windows Forms or Web Forms could also be used
- You can build a library of syntax examples by using same project over and over and just commenting out what you do not want to execute in Module1.cs
Instructions:
- Use C-Sharp 2010 Express or Standard Edition
- Create new project;
- Click File/New Project
- Select Console Application Template
- Select C-Sharp for Language
- name of project could be C-Sharp_Syntax.
- Add New folder named “Functions”
- Right-click project name in solution explorer;
- add new folder;
- name of folder could be: Functions
- Add New subfolder named “MathFunctions”
- Right-click Functions folder in solution explorer;
- add new folder;
- name of folder could be: MathFunctions
- Add Class Named clsRound to MathFunctions folder
- Right-click MathFunctions folder;
- add new item;
- Select class
- Class name could be clsRound
- Click on cs in code in step 1 above to copy code into clsRound.cs
- Click on cs in code in step 2 above to copy code into Module1.cs
- Click green arrow or press F5 to run program