NumericPagerField.ButtonType Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define o tipo de botão a exibir no campo do pager.
public:
property System::Web::UI::WebControls::ButtonType ButtonType { System::Web::UI::WebControls::ButtonType get(); void set(System::Web::UI::WebControls::ButtonType value); };public System.Web.UI.WebControls.ButtonType ButtonType { get; set; }member this.ButtonType : System.Web.UI.WebControls.ButtonType with get, setPublic Property ButtonType As ButtonTypeValor da propriedade
Um dos valores de ButtonType. O padrão é Link.
Exceções
O valor da propriedade ButtonType não é um dos valores ButtonType.
Exemplos
O exemplo a NumericPagerField seguir mostra como usar a ButtonType propriedade para especificar que os botões de imagem são exibidos no objeto de um DataPager controle.
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>NumericPagerField Example</title>
<style type="text/css">
.header { background-color:#8FBC8F; }
table { border: solid 1px #000000; }
</style>
</head>
<body>
<form id="form1" runat="server">
<h3>NumericPagerField Example</h3>
<asp:ListView ID="VendorsListView"
DataSourceID="VendorsDataSource"
runat="server">
<LayoutTemplate>
<table cellpadding="2" width="640px" runat="server" id="tblVendor">
<tr align="center" class="header" runat="server">
<td runat="server">ID</td>
<td runat="server">Vendor Name</td>
<td runat="server">Active</td>
</tr>
<tr id="itemPlaceholder" runat="server">
</tr>
</table>
</LayoutTemplate>
<ItemTemplate>
<tr runat="server">
<td>
<asp:Label ID="VendorIDLabel" runat="server" Text='<%#Eval("VendorID") %>' />
</td>
<td>
<asp:Label ID="NameLabel" runat="server" Text='<%#Eval("Name") %>' />
</td>
<td align="center">
<asp:CheckBox ID="ActiveFlagCheck" runat="server"
Checked='<%#Eval("ActiveFlag") %>'
Enabled="false" />
</td>
</tr>
</ItemTemplate>
</asp:ListView>
<asp:DataPager runat="server" ID="ContactsDataPager"
PagedControlID="VendorsListView"
PageSize="10">
<Fields>
<asp:NumericPagerField
NextPageImageUrl="~/images/next.gif"
PreviousPageImageUrl="~/images/previous.gif"
ButtonType="Image" />
</Fields>
</asp:DataPager>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the AdventureWorks sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:SqlDataSource ID="VendorsDataSource" runat="server"
ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
SelectCommand="SELECT [VendorID], [Name], [ActiveFlag] FROM Purchasing.Vendor">
</asp:SqlDataSource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>NumericPagerField Example</title>
<style type="text/css">
.header { background-color:#8FBC8F; }
table { border: solid 1px #000000; }
</style>
</head>
<body>
<form id="form1" runat="server">
<h3>NumericPagerField Example</h3>
<asp:ListView ID="VendorsListView"
DataSourceID="VendorsDataSource"
runat="server">
<LayoutTemplate>
<table cellpadding="2" width="640px" runat="server" id="tblVendor">
<tr align="center" class="header" runat="server">
<td runat="server">ID</td>
<td runat="server">Vendor Name</td>
<td runat="server">Active</td>
</tr>
<tr id="itemPlaceholder" runat="server">
</tr>
</table>
</LayoutTemplate>
<ItemTemplate>
<tr runat="server">
<td>
<asp:Label ID="VendorIDLabel" runat="server" Text='<%#Eval("VendorID") %>' />
</td>
<td>
<asp:Label ID="NameLabel" runat="server" Text='<%#Eval("Name") %>' />
</td>
<td align="center">
<asp:CheckBox ID="ActiveFlagCheck" runat="server"
Checked='<%#Eval("ActiveFlag") %>'
Enabled="false" />
</td>
</tr>
</ItemTemplate>
</asp:ListView>
<asp:DataPager runat="server" ID="ContactsDataPager"
PagedControlID="VendorsListView"
PageSize="10">
<Fields>
<asp:NumericPagerField
NextPageImageUrl="~/images/next.gif"
PreviousPageImageUrl="~/images/previous.gif"
ButtonType="Image" />
</Fields>
</asp:DataPager>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the AdventureWorks sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:SqlDataSource ID="VendorsDataSource" runat="server"
ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
SelectCommand="SELECT [VendorID], [Name], [ActiveFlag] FROM Purchasing.Vendor">
</asp:SqlDataSource>
</form>
</body>
</html>
Comentários
A tabela a seguir lista os tipos de botão disponíveis.
| Valor do tipo de botão | Descrição |
|---|---|
| ButtonType.Button | Um controle Button. |
| ButtonType.Image | Um controle ImageButton. |
| ButtonType.Link | Um controle LinkButton. |
Quando a ButtonType propriedade estiver definida como ButtonType.Image, você deverá fornecer a URL de uma imagem para os botões da página anterior e da próxima página. Para fazer isso, você pode usar as propriedades e PreviousPageImageUrl as NextPageImageUrl propriedades. A propriedade de texto correspondente é usada como o texto alternativo para a imagem. Por exemplo, o texto especificado pela NextPageImageUrl propriedade é exibido como o texto alternativo para o botão de imagem da próxima página. Em navegadores que dão suporte a dicas de ferramenta, esse texto também é exibido como uma dica de ferramenta para o botão correspondente.
O valor da ButtonType propriedade é armazenado no estado de exibição.
Se a DataPager.QueryStringField propriedade não for uma cadeia de caracteres vazia ou null, o NumericPagerField objeto ignorará o valor da ButtonCount propriedade. Nesse caso, o HyperLink controle é usado para criar os botões.