System.Web.UI.WebControls Namespace   FormView Class

.NET Framework version 2.0

Returns a FormViewRow object that represents the pager row displayed at the top of the FormView control.

The property is read only with no default value.

When paging is enabled ( when the AllowPaging property is set to true ), an additional row called the pager row is automatically displayed in the FormView control.

The pager row contains controls that allow the user to navigate to other records, and can be displayed at the top, the bottom, or both the top and bottom of the control. Use the TopPagerRow property to programmatically access the FormViewRow object that represents the top pager row in the FormView control.

NOTE: The TopPagerRow property is available only after the FormView control creates the top pager row in the ItemCreated event.

This property is commonly used when you need to programmatically manipulate the top pager row, for example when adding custom content. Any modification to the TopPagerRow property must be performed after the FormViewRow object that represents the top pager row has been created; otherwise, the FormView control overwrites any changes.

The following example demonstrates how to programmatically set the style properties of the TopPagerRow in the FormView control at run time.

void chgSelectedProps ( Object src, EventArgs e ) {
   if ( myFormView.TopPagerRow != null ) {
      myFormView.TopPagerRow.BackColor = System.Drawing.Color.Khaki;
      myFormView.TopPagerRow.ForeColor = System.Drawing.Color.Maroon;
      myFormView.TopPagerRow.Font-Bold = true;
   }
}

Sub chgSelectedProps ( src As Object, e As EventArgs )
   If Not ( myFormView.TopPagerRow Is Nothing ) Then
      myFormView.TopPagerRow.BackColor = System.Drawing.Color.Khaki
      myFormView.TopPagerRow.ForeColor = System.Drawing.Color.Maroon
      myFormView.TopPagerRow.Font-Bold = True
   End If
End Sub

FormViewRow   BottomPagerRow   FooterRow   HeaderRow   Row   Specifying Paging Behavior in a FormView Control