Getting Started

28 Aug 20178 minutes to read

Create your first Editor in ASP.NET

The Essential ASP.NET Web Forms Editors control includes Numeric, Percentage, Currency and MaskEdit textbox controls. You can learn how to useASP.NET Textboxes controls in the Electricity bill calculator Application from the following documentation. This guides you to use the wide range of Textbox functionalities to complete this application.

Create Textboxes Controls

You can create a Web Forms Project and add necessary Dll’s and Scripts with the help of the given Web Forms-Getting Started Documentation.

Add necessary Textbox control and initialize the corresponding Textboxes control

  • HTML
  •   <div class="editors">
    
            </div>
    
            <div class="element-txt" style="">Electricity Bill Calculator</div>
    
            <br />
    
            <table class="editors">
    
                <tbody>
    
                    <tr>
    
                        <td>
    
                            <label>Unit meters</label>
    
                        </td>
    
                        <td>
    
                            <ej:NumericTextBox ID="NumericTextBox" runat="server"WatermarkText="Units">
    
                            </ej:NumericTextBox>
    
                        </td>
    
                    </tr>
    
                    <tr>
    
                        <td>
    
                            <label>Service Tax</label>
    
                        </td>
    
                        <td>
    
                            <ej:PercentageTextBox ID="PercentageTextBox" runat="server"WatermarkText="Tax">
    
                            </ej:PercentageTextBox>
    
                        </td>
    
                    </tr>
    
                    <tr>
    
                        <td>
    
                            <label>Fare</label>
    
                        </td>
    
                        <td>
    
                            <ej:CurrencyTextBox ID="CurrencyTextBox" runat="server"WatermarkText="Amount perunit">
    
                            </ej:CurrencyTextBox>
    
                        </td>
    
                    </tr>
    
                    <tr>
    
                        <td>
    
                            <label>Mobile No</label>
    
                        </td>
    
                        <td>
    
                     <ej:MaskEdit ID="MaskEdit" runat="server" WatermarkText="Phone number"></ej:MaskEdit>
    
                        </td>
    
                    </tr>
    
                </tbody>
    
            </table>
    
            <div class="pay-bill">
    
               <ej:Button ID="Button" runat="server" Text="Calculate" Type="Button"Size="Small">
    
                </ej:Button>
    
            </div>
    
        </div>

    The following styles are added to arrange the Textboxes.

  • CSS
  • .element-txt
    
    {
    
        display: inline-block;
    
        font-size: 20px;
    
        font-weight: bolder;
    
        height: 50px;
    
        position: relative;
    
        text-align: center;
    
        top: -20px;
    
    }
    
    .editors
    
    {
    
        max-width: 400px;
    
        border: 2px solid #DDDDDD;
    
        margin:100px 0 0 100px;
    
    }
    
            .editors td
    
    {
    
        padding-bottom:5px;
    
    }
    
    
    
    .editors table
    
    {
    
        border: 0px;
    
        padding-left: 50px;
    
    }
    
    .pay-bill
    
    {
    
        margin: 18px 0px 10px 244px;
    
    }
    
    table.editors
    
    {
    
        margin:0 0 0 61px;
    
    }
    
    .editors label
    
    {
    
        display: block;
    
        width: 130px;
    
    }

    Execute the code example to render a Textboxes control as follows

    Set the MinValue, MaxValue and value in Textboxes

    In the above mentioned use case scenario, you can set the MinValue, MaxValue and Value in Numeric, Percentage and Currency text boxes for maintaining the range in Textboxes controls. You can also enter the values between the ranges that are set as default. You can get the phone number from the user in the MaskEdit control by using the MaskFormat property. You can get the decimal values for CurrencyTextBox control by using DecimalPlaces property. The following code example illustrates how to achieve this scenario.

  • HTML
  •    <div class="editors">
    
            </div>
    
            <div class="element-txt" style="">Electricity Bill Calculator</div>
    
            <br />
    
            <table class="editors">
    
                <tbody>
    
                    <tr>
    
                        <td>
    
                            <label>Unit meters</label>
    
                        </td>
    
                        <td>
    
                            <ej:NumericTextBox ID="NumericTextBox" runat="server"WatermarkText="Units" MinValue="1" MaxValue="10000" Value="70">
    
                            </ej:NumericTextBox>
    
                        </td>
    
                    </tr>
    
                    <tr><td><label>Service Tax</label>
    
                        </td>
    
                        <td>
    
                            <ej:PercentageTextBox ID="PercentageTextBox" runat="server"WatermarkText="Tax" MinValue="5" MaxValue="100" Value="3">
    
                            </ej:PercentageTextBox>
    
                        </td>
    
                    </tr>
    
                    <tr>
    
                        <td>
    
                            <label>Fare</label>
    
                        </td>
    
                        <td>
    
                            <ej:CurrencyTextBox ID="CurrencyTextBox" runat="server"WatermarkText="Amount per unit" DecimalPlaces="2" MinValue="0.00"MaxValue="100000.00" Value="350.00">
    
                            </ej:CurrencyTextBox>
    
                        </td>
    
                    </tr>
    
                    <tr>
    
                        <td>
    
                            <label>Mobile No</label>
    
                        </td>
    
                        <td>
    
                            <ej:MaskEdit ID="MaskEdit" runat="server"WatermarkText="Phone number" MaskFormat="99-999-99999" Value="9090909090">
    
                            </ej:MaskEdit>
    
                        </td>
    
                    </tr>
    
                </tbody>
    
            </table>
    
            <div class="pay-bill">
    
                <ej:Button ID="Button" runat="server" Text="Calculate" Type="Button"Size="Small">
    
                </ej:Button>
    
            </div>
    
        </div>

    Execute the above code example to render the resultant output of the above steps.

    Set the Strict Mode Option

    You can set the “EnableStrictMode” option to restrict entering values defined outside the range. The following code example illustrates how to set strict mode option.

  • HTML
  •    <div class="editors">
    
            <div class="element-icon">
    
            </div>
    
            <div class="element-txt" style="">Electricity Bill Calculator</div>
    
            <br />
    
            <table class="editors">
    
                <tbody>
    
                    <tr>
    
                        <td>
    
                            <label>Unit meters</label>
    
                        </td>
    
                        <td>
    
                            <ej:NumericTextBox ID="NumericTextBox" runat="server"WatermarkText="Units" MinValue="1" MaxValue="10000" Value="70"EnableStrictMode="true">
    
                            </ej:NumericTextBox>
    
                        </td>
    
                    </tr>
    
                    <tr>
    
                        <td>
    
                            <label>Service Tax</label>
    
                        </td>
    
                        <td>
    
                            <ej:PercentageTextBox ID="PercentageTextBox" runat="server"WatermarkText="Tax" MinValue="5" MaxValue="100" Value="3">
    
                            </ej:PercentageTextBox>
    
                        </td>
    
                    </tr>
    
                    <tr>
    
                        <td>
    
                            <label>Fare</label>
    
                        </td>
    
                        <td>
    
                            <ej:CurrencyTextBox ID="CurrencyTextBox" runat="server"WatermarkText="Amount per unit" DecimalPlaces="2" MinValue="0.00"MaxValue="100000.00" Value="350.00">
    
                            </ej:CurrencyTextBox>
    
                        </td>
    
                    </tr>
    
                    <tr>
    
                        <td>
    
                            <label>Mobile No</label>
    
                        </td>
    
                        <td>
    
                            <ej:MaskEdit ID="MaskEdit" runat="server"WatermarkText="Phone number" MaskFormat="99-999-99999" Value="9090909090">
    
                            </ej:MaskEdit>
    
                        </td>
    
                    </tr>
    
                </tbody>
    
            </table>
    
            <div class="pay-bill">
    
                <ej:Button ID="Button" runat="server" Text="Calculate" Type="Button"Size="Small">
    
                </ej:Button>
    
            </div>
    
        </div>

    Execute the above code example and you can see that it restricts entering a value exceeding the MinValue and MaxValue range mentioned in the Numeric textbox.

    Set Calculation process with Textboxes Controls

    You can use events to calculate the total amount and display the value. This is achieved by using the Click event in the button control. The calculation steps are written in the call back function of Click event button.

    To customize the button,you can set the ContentType as TextAndImage to include the icon before the text and add the ClientSideOnClick event.

  • HTML
  •   <div class="editors">
    
            // Please refer the table format for textboxes customization
    
            <div class="pay-bill">
    
                <ej:Button ID="Button" runat="server" Text="Calculate" Type="Button"Size="Small" ClientSideOnClick="calculateBill">
    
                </ej:Button>
    
            </div>
    
      </div>
  • JS
  • function calculateBill() {
    
                 // Declares Necessary variable creation
    
            var unitMeter, serviceTax, amountPerKm;
    
            unitMeter = $("#NumericTextBox").data("ejNumericTextbox");// Object of Numeric
    
            serviceTax = $("#PercentageTextBox").data("ejPercentageTextbox");// Object of Percentage
    
            amountPerKm = $("#CurrencyTextBox").data("ejCurrencyTextbox"); // Object of Currency
    
            mobileNumber = $("#MaskEdit").data("ejMaskEdit"); // Object of MaskEdit       
    
             // This is used to calculate the Net amount
    
            var netAmount = unitMeter.model.value * amountPerKm.model.value;
    
            // This is used to calculate the service tax amount
    
            var sTax = (netAmount * serviceTax.model.value) / 100;
    
            // This shows the calculated amount for the units
    
            alert("The amount $" + (netAmount + sTax) + " has been sent as message to " + mobileNumber.model.value + ".");
    
        } 

    Execute the above code to render the Textboxes control. Fill the required Textbox fields and click the Calculate button. The values are displayed and an alert message is displayed. The following screenshot illustrates the final output of the Electricity bill calculator.