Guides (SDK /API) | Technical Reference | BBDN | How-to Documentation

Add Required Field Validation

Code sample project: Custom Pledge Form

1. Add a validation summary to the top of the form.

   <asp:ValidationSummary ID="ValidationSummaryTop" runat="server" />

2. Add first name required validation after LabelFirst.

   <asp:RequiredFieldValidator ID="RequiredFieldValidatorFirstName" ControlToValidate="TextBoxFirst" 
   runat="server" ErrorMessage="First name required">*</asp:RequiredFieldValidator>

3. Add last name required validation after LabelLast.

   <asp:RequiredFieldValidator ID="RequiredFieldValidatorLastName" ControlToValidate="TextBoxLast"
    runat="server" ErrorMessage="Last name required">*</asp:RequiredFieldValidator>

4. Add amount required validation after LabelAmount.

   <asp:RequiredFieldValidator ID="RequiredFieldValidatorAmount" ControlToValidate="TextBoxAmount"
    runat="server" ErrorMessage="Amount required">*</asp:RequiredFieldValidator>

5. Add a check for a validated page to the Pledge button click Sub procedure.

       Protected Sub ButtonPledge_Click(ByVal sender As Object, ByVal e As EventArgs) Handles ButtonPledge.Click
           Try
               If Page.IsValid Then
                   If MyContent.OnlyWriteToCustomPledgeRecord Then
                       AddCustomPledgeRecord()
                   ElseIf API.Users.CurrentUser.IsAnonymous Then
                       AddCustomPledgeRecord()
                   Else
                       If API.Users.CurrentUser.BackOfficeGuid = System.Guid.Empty Then
                           AddCustomPledgeRecord()
                       Else
                           AddRevenuePledgeRecord()
                       End If
                   End If
               End If
           Catch ex As Blackbaud.AppFx.WebAPI.AppFxWebServiceException When ex.DataFormErrorInfo IsNot Nothing AndAlso ex.DataFormErrorInfo.ErrorCode = Blackbaud.AppFx.WebAPI.ServiceProxy.DataFormErrorCode.RecordNotFound
           End Try
       End Sub

<%@ assembly Name="PartsProjectExample"%>
<%@ Control Language="vb" AutoEventWireup="false" CodeBehind="CustomPledgeFormDisplay.ascx.vb" Inherits="PartsProjectExample.CustomPledgeFormDisplay" %>
<%@ import Namespace="PartsProjectExample"%>
<style type="text/css">
    .style1
    {
        width: 91px;
    }
</style>
<asp:Label ID="lblError" runat="server" Font-Bold="true" ForeColor="red" />
<asp:ValidationSummary ID="ValidationSummaryTop" runat="server" />
<p>
    &nbsp;</p>
<asp:Panel ID="PanelPledgeForm" runat="server" Height="311px" Width="300px">
    <asp:Label ID="LabelPledgeForm" runat="server" 
    Text="Make a pledge"></asp:Label>
    <br />
    <table style="width:100%;">
        <tr>
            <td class="style1">
                <asp:Label ID="LabelFirst" runat="server" Text="First"></asp:Label>
                <asp:RequiredFieldValidator ID="RequiredFieldValidatorFirstName" ControlToValidate="TextBoxFirst" runat="server" ErrorMessage="First name required">*</asp:RequiredFieldValidator>
            </td>
            <td>
                <asp:TextBox ID="TextBoxFirst" runat="server" Width="195px"></asp:TextBox>
            </td>
        </tr>
        <tr>
            <td class="style1">

                <asp:Label ID="LabelMiddle" runat="server" Text="Middle"></asp:Label>
            </td>
            <td>
                <asp:TextBox ID="TextBoxMiddle" runat="server" Width="195px"></asp:TextBox>
            </td>
        </tr>
        <tr>
            <td class="style1">
                <asp:Label ID="LabelLast" runat="server" Text="Last"></asp:Label>
                <asp:RequiredFieldValidator ID="RequiredFieldValidatorLastName" ControlToValidate="TextBoxLast" runat="server" ErrorMessage="Last name required">*</asp:RequiredFieldValidator>
            </td>
            <td>
                <asp:TextBox ID="TextBoxLast" runat="server" Width="195px"></asp:TextBox>
            </td>
        </tr>
    </table>
    <br />
    <asp:Label ID="LabelEmail" runat="server" Text="Email address"></asp:Label>
    <br />
    <asp:TextBox ID="TextBoxEmail" runat="server" Width="200px"></asp:TextBox>
    <br />
    <br />
    <asp:Label ID="Amount" runat="server" Text="Amount"></asp:Label>
    <asp:RequiredFieldValidator ID="RequiredFieldValidatorAmount" ControlToValidate="TextBoxAmount" runat="server" ErrorMessage="Amount required">*</asp:RequiredFieldValidator>
    <br />
    <asp:TextBox ID="TextBoxAmount" runat="server" Width="200px"></asp:TextBox>
    <br />
    <br />
    <asp:Button ID="ButtonPledge" runat="server" Text="Pledge" />
</asp:Panel>