Export (0) Print
Expand All

PagerSettings.Visible Property

Note: This property is new in the .NET Framework version 2.0.

Gets or sets a value indicating whether the paging controls are displayed in a control that supports pagination.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

Visual Basic (Declaration)

Public Property Visible As Boolean

Visual Basic (Usage)

Dim instance As PagerSettings
Dim value As Boolean

value = instance.Visible

instance.Visible = value

C#

public bool Visible { get; set; }

C++

public:
property bool Visible {
	bool get ();
	void set (bool value);
}

J#

/** @property */
public boolean get_Visible ()

/** @property */
public void set_Visible (boolean value)

JScript

public function get Visible () : boolean

public function set Visible (value : boolean)

Property Value

true to display the pager; otherwise, false. The default is true.

Remarks

Use the Visible property to specify whether the paging controls are displayed in a control that supports pagination. To hide the paging controls, set the Visible property to false.

The value of this property is stored in view state.

Example

The following code example demonstrates how to use the Visible property to hide the pager row when a GridView control is in edit mode.

Visual Basic

<%@ Page language="VB" %>

<script runat="server">

  Sub CustomerGridView_RowEditing(ByVal sender As Object, ByVal e As GridViewEditEventArgs) Handles CustomerGridView.RowEditing

    ' Hide the pager row.
    CustomerGridView.PagerSettings.Visible = False
    
  End Sub

  Sub CustomerGridView_RowCommand(ByVal sender As Object, ByVal e As GridViewCommandEventArgs) Handles CustomerGridView.RowCommand
  
    If e.CommandName = "Cancel" Or e.CommandName = "Update" Then
    
      ' Show the pager row.
      CustomerGridView.PagerSettings.Visible = True
      
    End If
      
  End Sub
  
</script>

<html>
  <body>
    <form runat="server">
        
      <h3>PagerSetting Example</h3>
                       
        <asp:gridview id="CustomerGridView"
          datasourceid="CustomerDataSource"
          autogeneratecolumns="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          autogenerateeditbutton="true" 
          runat="server">
          
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"   
            position="Bottom"/> 
            
        </asp:gridview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the Web.config file.                            -->
        <asp:sqldatasource id="CustomerDataSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
          updatecommand="Update [Customers] Set [CompanyName]=@CompanyName, [Address]=@Address, [City]=@City, [PostalCode]=@PostalCode, [Country]=@Country Where [CustomerID]=@CustomerID" 
          connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </form>
  </body>
</html>

C#

<%@ Page language="C#" %>

<script runat="server">

  void CustomerGridView_RowEditing(Object sender, GridViewEditEventArgs e)
  {
    // Hide the pager row.
    CustomerGridView.PagerSettings.Visible = false;
  }

  void CustomerGridView_RowCommand(Object sender, GridViewCommandEventArgs e)
  {
    if (e.CommandName == "Cancel" || e.CommandName == "Update")
    {
      // Show the pager row.
      CustomerGridView.PagerSettings.Visible = true;
    }
  }
  
</script>

<html>
  <body>
    <form runat="server">
        
      <h3>PagerSetting Example</h3>
                       
        <asp:gridview id="CustomerGridView"
          datasourceid="CustomerDataSource"
          autogeneratecolumns="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          autogenerateeditbutton="true"
          onrowediting="CustomerGridView_RowEditing"
          onrowcommand="CustomerGridView_RowCommand"   
          runat="server">
          
          <pagersettings mode="NextPreviousFirstLast"
            firstpagetext="First"
            lastpagetext="Last"
            nextpagetext="Next"
            previouspagetext="Prev"   
            position="Bottom"/> 
            
        </asp:gridview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- This example uses Microsoft SQL Server and connects  -->
        <!-- to the Northwind sample database. Use an ASP.NET     -->
        <!-- expression to retrieve the connection string value   -->
        <!-- from the Web.config file.                            -->
        <asp:sqldatasource id="CustomerDataSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
          updatecommand="Update [Customers] Set [CompanyName]=@CompanyName, [Address]=@Address, [City]=@City, [PostalCode]=@PostalCode, [Country]=@Country Where [CustomerID]=@CustomerID" 
          connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </form>
  </body>
</html>

Platforms

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

Version Information

.NET Framework

Supported in: 2.0

See Also

Community Additions

ADD
Show:
© 2014 Microsoft