今天增强了一下AspNetPager控件
在分页设置的时候发现http://www.webdiyer.com/ 写的分页控件实在是好用,而且是开源的,真是佩服呀,一直没有机会感谢一下,使用了很久,这次客户提了一些需求正好安排一天时间改进了一下,也是很不错的。
说明:增强的了内容是在4.3.3的版本基本上进行修改的。只是简单的测试版,我只发了几个小时的时间修改的。还没有经过严格的测试,如果大家发现有什么问题,请回复,谢谢
1//AspNetPager分页控件源代码:
2//版权所有:陕西省吴旗县 Webdiyer(yhaili@21cn.com)(Web site: www.webdiyer.com);
3//此源代码仅供学习参考,不得用作任何商业用途;
4//若需修改并重新编译该控件,请保留完整的源代码的版权信息!
5//有关控件升级及新控件发布信息,请留意 www.webdiyer.com 。
6//版本4.3.3
7//增强版 (修改自4.3.3版本)
8//描述:增加了可自定义每页的记录数。
9//modify by liubiqu(liubiqu@sina.com) [http://www.cnblogs.com/liubiqu]
10//DateTime: 2005-06-10
11
12using System;
13using System.Collections;
14using System.Collections.Specialized;
15using System.ComponentModel;
16using System.IO;
17using System.Text;
18using System.Web.UI;
19using System.Web.UI.Design.WebControls;
20using System.Web.UI.WebControls;
21
22namespace EOffice.Components
23{
24 #region AspNetPager Server Control
25
26 #region 控件说明及示例
27 /// <summary>
28 /// 用于ASP.NET Web应用程序中对数据进行分页的的服务器控件。
29 /// </summary>
30 /// <remarks>不同于DataGrid控件,AspNetPager分页控件本身并不显示任何数据,而只显示页导航元素,数据在页面上的显示方式与该控件无关。该控件可以为DataGrid、DataList、Repeater以及自定义控件进行分页,配合Sql存储过程,分页性能较使用DataGrid分页有明显提升,尤其是当数据量大时性能可提升数倍!
31 /// <p>AspNetPager 2.0 中新增了通过Url来分页的功能,这使得访问者可以直接输入相应的Url来访问任何页面,并且搜索引擎也可以直接检索每个页面,若使用DataGrid的分页功能,这是无法实现的。</p>
32 /// <p>要使用 AspNetPager 分页控件,必须最少指定它的 <see cref="RecordCount"/> 属性,指定并编写 <see cref="PageChanged"/> 事件的处理程序。
33 /// <see cref="RecordCount"/> 属性指定要分页的所有数据的总项数,若未指定该值或该值小于等于 <see cref="PageSize"/> ,则AspNetPager控件不会显示任何内容。
34 /// 若未指定并编写 <see cref="PageChanged"/> 事件处理程序,则当用户点击页导航元素或在页索引文本框中手式输入页索引并提交时AspNetPager不会跳转到指定的页。
35 /// AspNetPager控件的分页方法和DataGrid基本相同,即在它的 <see cref="PageChanged"/> 事件处理程序中将传递事件数据的 <see cref="PageChangedEventArgs"/> 的 <see cref="PageChangedEventArgs.NewPageIndex"/>值赋给 AspNetPager的 <see cref="CurrentPageIndex"/>属性,然后重新将新的数据与数据显示控件绑定。 </p></remarks>
36 /// <example>以下示例说明如何用AspNetPager对DataGrid进行分页。
37 /// <code><![CDATA[
38 ///<%@ Page Language="C#"%>
39 ///<%@ Import Namespace="System.Data"%>
40 ///<%@Import Namespace="System.Data.SqlClient"%>
41 ///<%@Import Namespace="System.Configuration"%>
42 ///<%@Register TagPrefix="Webdiyer" Namespace="Wuqi.Webdiyer" Assembly="aspnetpager"%>
43 ///<HTML>
44 ///<HEAD>
45 ///<TITLE>Welcome to Webdiyer.com </TITLE>
46 /// <script runat="server">
47 /// SqlConnection conn;
48 /// SqlCommand cmd;
49 /// void Page_Load(object src,EventArgs e)
50 /// {
51 /// conn=new SqlConnection(ConfigurationSettings.AppSettings["ConnStr"]);
52 /// if(!Page.IsPostBack)
53 /// {
54 /// cmd=new SqlCommand("GetNews",conn);
55 /// cmd.CommandType=CommandType.StoredProcedure;
56 /// cmd.Parameters.Add("@pageindex",1);
57 /// cmd.Parameters.Add("@pagesize",1);
58 /// cmd.Parameters.Add("@docount",true);
59 /// conn.Open();
60 /// pager.RecordCount=(int)cmd.ExecuteScalar();
61 /// conn.Close();
62 /// BindData();
63 /// }
64 /// }
65 ///
66 /// void BindData()
67 /// {
68 /// cmd=new SqlCommand("GetNews",conn);
69 /// cmd.CommandType=CommandType.StoredProcedure;
70 /// cmd.Parameters.Add("@pageindex",pager.CurrentPageIndex);
71 /// cmd.Parameters.Add("@pagesize",pager.PageSize);
72 /// cmd.Parameters.Add("@docount",false);
73 /// conn.Open();
74 /// dataGrid1.DataSource=cmd.ExecuteReader();
75 /// dataGrid1.DataBind();
76 /// conn.Close();
77 /// pager.CustomInfoText="记录总数:<font color=\"blue\"><b>"+pager.RecordCount.ToString()+"</b></font>";
78 /// pager.CustomInfoText+=" 总页数:<font color=\"blue\"><b>"+pager.PageCount.ToString()+"</b></font>";
79 /// pager.CustomInfoText+=" 当前页:<font color=\"red\"><b>"+pager.CurrentPageIndex.ToString()+"</b></font>";
80 /// }
81 /// void ChangePage(object src,PageChangedEventArgs e)
82 /// {
83 /// pager.CurrentPageIndex=e.NewPageIndex;
84 /// BindData();
85 /// }
86 /// </script>
87 /// <meta http-equiv="Content-Language" content="zh-cn">
88 /// <meta http-equiv="content-type" content="text/html;charset=gb2312">
89 /// <META NAME="Generator" CONTENT="EditPlus">
90 /// <META NAME="Author" CONTENT="Webdiyer(yhaili@21cn.com)">
91 /// </HEAD>
92 /// <body>
93 /// <form runat="server" ID="Form1">
94 /// <asp:DataGrid id="dataGrid1" runat="server" />
95 ///
96 /// <Webdiyer:AspNetPager id="pager"
97 /// runat="server"
98 /// PageSize="8"
99 /// NumericButtonCount="8"
100 /// ShowCustomInfoSection="left"
101 /// PagingButtonSpacing="0"
102 /// ShowInputBox="always"
103 /// CssClass="mypager"
104 /// HorizontalAlign="right"
105 /// OnPageChanged="ChangePage"
106 /// SubmitButtonText="转到"
107 /// NumericButtonTextFormatString="[{0}]"/>
108 ///
109 /// </form>
110 /// </body>
111 ///</HTML>
112 /// ]]>
113 /// </code>
114 /// <p>下面是该示例所用的Sql Server存储过程:</p>
115 /// <code>
116 /// <![CDATA[
117 ///CREATE procedure GetNews
118 /// (@pagesize int,
119 /// @pageindex int,
120 /// @docount bit)
121 /// as
122 /// set nocount on
123 /// if(@docount=1)
124 /// select count(id) from news
125 /// else
126 /// begin
127 /// declare @indextable table(id int identity(1,1),nid int)
128 /// declare @PageLowerBound int
129 /// declare @PageUpperBound int
130 /// set @PageLowerBound=(@pageindex-1)*@pagesize
131 /// set @PageUpperBound=@PageLowerBound+@pagesize
132 /// set rowcount @PageUpperBound
133 /// insert into @indextable(nid) select id from news order by addtime desc
134 /// select O.id,O.source,O.title,O.addtime from news O,@indextable t where O.id=t.nid
135 /// and t.id>@PageLowerBound and t.id<=@PageUpperBound order by t.id
136 /// end
137 /// set nocount off
138 ///GO
139 /// ]]>
140 /// </code></example>
141 #endregion
142
143 [DefaultProperty("PageSize")]
144 [DefaultEvent("PageChanged")]
145 [ParseChildren(false)]
146 [PersistChildren(false)]
147 [Description("专用于ASP.Net Web应用程序的分页控件")]
148 [Designer(typeof(PagerDesigner))]
149 [ToolboxData("<{0}:AspNetPager runat=server></{0}:AspNetPager>")]
150 public class AspNetPager:Panel,INamingContainer,IPostBackEventHandler,IPostBackDataHandler
151 {
152 private string cssClassName;
153 private string urlPageIndexName="page";
154 private string urlPageSize = "pagesize";//TODO:var urlPageSize add by liubiqu 2005-6-10
155 private bool urlPaging=false;
156 private string inputPageIndex;
157 private string selectPageSize; //TODO:var selectPageSize add by liubiqu 2005-6-10
158 private string currentUrl=null;
159 private NameValueCollection urlParams=null;
160
161 #region Properties
162
163 #region Navigation Buttons
164
165 /// <summary>
166 /// 获取或设置一个值,该值批示当鼠标指针悬停在导航按钮上时是否显示工具提示。
167 /// </summary>
168 [Browsable(true),
169 Category("导航按钮"),
170 DefaultValue(true),
171 Description("指定当鼠标停留在导航按钮上时,是否显示工具提示")]
172 public bool ShowNavigationToolTip
173 {
174 get
175 {
176 object obj=ViewState["ShowNavigationToolTip"];
177 return (obj==null)?true:(bool)obj;
178 }
179 set
180 {
181 ViewState["ShowNavigationToolTip"]=value;
182 }
183 }
184
185 /// <summary>
186 /// 获取或设置导航按钮工具提示文本的格式。
187 /// </summary>
188 [Browsable(true),
189 Category("导航按钮"),
190 DefaultValue("转到第{0}页"),
191 Description("页导航按钮工具提示文本的格式")]
192 public string NavigationToolTipTextFormatString
193 {
194 get
195 {
196 object obj=ViewState["NavigationToolTipTextFormatString"];
197 return (obj==null)?"转到第{0}页":(string)obj;
198 }
199 set
200 {
201 string tip=value;
202 if(tip.Trim().Length<1&&tip.IndexOf("{0}")<0)
203 tip="{0}";
204 ViewState["NavigationToolTipTextFormatString"]=tip;
205 }
206 }
207
208 /// <summary>
209 /// 获取或设置一个值,该值指示是否将页索引按钮用中文数字代替。
210 /// </summary>
211 /// <remarks>
212 /// 将该值设为true并且未使用图片按钮时,页索引按钮中的数值1、2、3等将会被中文字符一、二、三等代替。
213 /// </remarks>
214 [Browsable(true),
215 Category("导航按钮"),
216 DefaultValue(false),
217 Description("是否将页索引数值按钮用中文数字一、二、三等代替")]
218 public bool ChinesePageIndex
219 {
220 get
221 {
222 object obj=ViewState["ChinesePageIndex"];
223 return (obj==null)?false:(bool)obj;
224 }
225 set
226 {
227 ViewState["ChinesePageIndex"]=value;
228 }
229 }
230
231 /// <summary>
232 /// 获取或设置页索引数值导航按钮上文字的显示格式。
233 /// </summary>
234 /// <value>
235 /// 字符串,指定页索引数值按钮上文字的显示格式,默认值为<see cref="String.Empty"/>,即未设置该属性。</value>
236 /// <remarks>
237 /// 使用NumericButtonTextFormatString属性指定页索引数值按钮的显示格式,如未设置该值时索引按钮文本将会是:1 2 3 ,设置该值将改变索引按钮文本的显示格式,
238 /// 如将该值设为“[{0}]”则索引文本会显示为:[1] [2] [3] ,将该值设为“-{0}-”则会使索引文本变为:-1- -2- -3- 。
239 /// </remarks>
240 [Browsable(true),
241 DefaultValue(""),
242 Category("导航按钮"),
243 Description("页索引数值按钮上文字的显示格式")]
244 public string NumericButtonTextFormatString
245 {
246 get
247 {
248 object obj=ViewState["NumericButtonTextFormatString"];
249 return (obj==null)?String.Empty:(string)obj;
250 }
251 set
252 {
253 ViewState["NumericButtonTextFormatString"]=value;
254 }
255 }
256
257 /// <summary>
258 /// 获取或设置分页导航按钮的类型,即使用文字还是图片。
259 /// </summary>
260 /// <remarks>
261 /// 要使用图片按钮,您需要准备以下图片:从0到9的十个数值图片(当ShowPageIndex设为true时),第一页、上一页、下一页、最后一页及更多页()五个按钮图片(当ShowFirstLast及ShowPrevNext都设为true时),
262 /// 若需要使当前页索引的数值按钮不同于别的页索引数值按钮,则还需准备当前页索引的按钮图片;
263 /// 若需要使已禁用的第一页、上一页、下一页及最后一页按钮图片不同于正常的按钮图片,则还需准备这四个按钮在禁用状态下的图片;
264 /// <p><b>图片文件的命名规则如下:</b></p>
265 /// <p>从0到9十张数值按钮图片必须命名为“数值+ButtonImageNameExtension+ButtonImageExtension”,其中的ButtonImageNameExtension可以不用设置,
266 /// ButtonImageExtension是图片文件的后缀名,如 .gif或 .jpg等可以在浏览器中显示的任何图片文件类型。如页索引“1”的图片文件可命名为“1.gif”或“1.jpg”,
267 /// 当您有两套或更多套图片文件时,可以通过指定ButtonImageNameExtension属性值来区分不同套的图片,如第一套图片可以不用设ButtonImageNameExtension,则图片文件名类似于“1.gif”、“2.gif”等等,而第二套图片则设置ButtonImageNameExtension为“f”,图片文件名类似于“1f.gif”,“2f.gif”等等。</p>
268 /// <p>第一页按钮的图片文件名以“first”开头,上一页按钮图片名以“prev”开头,下一页按钮图片名以“next”开头,最后一页按钮图片名以“last”开头,更多页按钮图片名以“more”开头,是否使用ButtonImageNameExtension取决于数值按钮的设置及是否有更多套图片。</p>
269 /// </remarks>
270 /// <example>
271 /// 以下代码片段示例如果使用图片按钮:
272 /// <p>
273 /// <code><![CDATA[
274 /// <Webdiyer:AspNetPager runat="server"
275 /// id="pager1"
276 /// OnPageChanged="ChangePage"
277 /// PagingButtonType="image"
278 /// ImagePath="images"
279 /// ButtonImageNameExtension="n"
280 /// DisabledButtonImageNameExtension="g"
281 /// ButtonImageExtension="gif"
282 /// CpiButtonImageNameExtension="r"
283 /// PagingButtonSpacing=5/>
284 /// ]]>
285 /// </code>
286 /// </p>
287 /// </example>
288 [Browsable(true),
289 DefaultValue(PagingButtonType.Text),
290 Category("导航按钮"),
291 Description("分页导航按钮的类型,是使用文字还是图片")]
292 public PagingButtonType PagingButtonType
293 {
294 get
295 {
296 object obj=ViewState["PagingButtonType"];
297 return (obj==null)?PagingButtonType.Text:(PagingButtonType)obj;
298 }
299 set
300 {
301 ViewState["PagingButtonType"]=value;
302 }
303 }
304
305 /// <summary>
306 /// 获取或设置页导航数值按钮的类型,该值仅当PagingButtonType设为Image时才有效。
307 /// </summary>
308 /// <remarks>
309 /// 当您将PagingButtonType设为Image当又不想让页索引数值按钮使用图片时,可以将该值设为Text,这会使页索引数据按钮使用文本而不是图片按钮。
310 /// </remarks>
311 [Browsable(true),
312 DefaultValue(PagingButtonType.Text),
313 Category("导航按钮"),
314 Description("页导航数值按钮的类型")]
315 public PagingButtonType NumericButtonType
316 {
317 get
318 {
319 object obj=ViewState["NumericButtonType"];
320 return (obj==null)?PagingButtonType:(PagingButtonType)obj;
321 }
322 set
323 {
324 ViewState["NumericButtonType"]=value;
325 }
326 }
327
328 /// <summary>
329 /// 获取或设置第一页、上一页、下一页和最后一页按钮的类型,该值仅当PagingButtonType设为Image时才有效。
330 /// </summary>
331 /// <remarks>
332 /// 当您将PagingButtonType设为Image但又不想让第一页、下一页、下一页和最后一页按钮使用图片,则可以将该值设为Text,这会使前面的四个按钮使用文本而不是图片按钮。
333 /// </remarks>
334 [Browsable(true),
335 Category("导航按钮"),
336 DefaultValue(PagingButtonType.Text),
337 Description("第一页、上一页、下一页和最后一页按钮的类型")]
338 public PagingButtonType NavigationButtonType
339 {
340 get
341 {
342 object obj=ViewState["NavigationButtonType"];
343 return (obj==null)?PagingButtonType:(PagingButtonType)obj;
344 }
345 set
346 {
347 ViewState["NavigationButtonType"]=value;
348 }
349 }
350
351 /// <summary>
352 /// 获取或设置“更多页”()按钮的类型,该值仅当PagingButtonType设为Image时才有效。
353 /// </summary>
354 /// <remarks>
355 /// 当您将PagingButtonType设为Image但又不想让更多页()按钮使用图片时,可以将此值设为Text,这会使更多页按钮使用文本而不是图片按钮。
356 /// </remarks>
357 [Browsable(true),
358 Category("导航按钮"),
359 DefaultValue(PagingButtonType.Text),
360 Description("“更多页”()按钮的类型")]
361 public PagingButtonType MoreButtonType
362 {
363 get
364 {
365 object obj=ViewState["MoreButtonType"];
366 return (obj==null)?PagingButtonType:(PagingButtonType)obj;
367 }
368 set
369 {
370 ViewState["MoreButtonType"]=value;
371 }
372 }
373
374 /// <summary>
375 /// 获取或设置分页导航按钮之间的间距。
376 /// </summary>
377 [Browsable(true),
378 Category("导航按钮"),
379 DefaultValue(typeof(Unit),"5px"),
380 Description("分页导航按钮之间的间距")]
381 public Unit PagingButtonSpacing
382 {
383 get
384 {
385 object obj=ViewState["PagingButtonSpacing"];
386 return (obj==null)?Unit.Pixel(5):(Unit.Parse(obj.ToString()));
387 }
388 set
389 {
390 ViewState["PagingButtonSpacing"]=value;
391 }
392 }
393
394 /// <summary>
395 /// 获取或设置一个值,该值指示是否在页导航元素中显示第一页和最后一页按钮。
396 /// </summary>
397 [Browsable(true),
398 Description("是否在页导航元素中显示第一页和最后一页按钮"),
399 Category("导航按钮"),
400 DefaultValue(true)]
401 public bool ShowFirstLast
402 {
403 get
404 {
405 object obj=ViewState["ShowFirstLast"];
406 return (obj==null)?true:(bool)obj;
407 }
408 set{ViewState["ShowFirstLast"]=value;}
409 }
410
411 /// <summary>
412 /// 获取或设置一个值,该值指示是否在页导航元素中显示上一页和下一页按钮。
413 /// </summary>
414 [Browsable(true),
415 Description("是否在页导航元素中显示上一页和下一页按钮"),
416 Category("导航按钮"),
417 DefaultValue(true)]
418 public bool ShowPrevNext
419 {
420 get
421 {
422 object obj=ViewState["ShowPrevNext"];
423 return (obj==null)?true:(bool)obj;
424 }
425 set{ViewState["ShowPrevNext"]=value;}
426 }
427
428 /// <summary>
429 /// 获取或设置一个值,该值指示是否在页导航元素中显示页索引数值按钮。
430 /// </summary>
431 [Browsable(true),
432 Description("是否在页导航元素中显示数值按钮"),
433 Category("导航按钮"),
434 DefaultValue(true)]
435 public bool ShowPageIndex
436 {
437 get
438 {
439 object obj=ViewState["ShowPageIndex"];
440 return (obj==null)?true:(bool)obj;
441 }
442 set{ViewState["ShowPageIndex"]=value;}
443 }
444
445 /// <summary>
446 /// 获取或设置为第一页按钮显示的文本。
447 /// </summary>
448 [Browsable(true),
449 Description("第一页按钮上显示的文本"),
450 Category("导航按钮"),
451 DefaultValue("<font face=\"webdings\">9</font>")]
452 public string FirstPageText
453 {
454 get
455 {
456 object obj=ViewState["FirstPageText"];
457 return (obj==null)?"<font face=\"webdings\">9</font>":(string)obj;
458 }
459 set{ViewState["FirstPageText"]=value;}
460 }
461
462 /// <summary>
463 /// 获取或设置为上一页按钮显示的文本。
464 /// </summary>
465 [Browsable(true),
466 Description("上一页按钮上显示的文本"),
467 Category("导航按钮"),
468 DefaultValue("<font face=\"webdings\">3</font>")]
469 public string PrevPageText
470 {
471 get
472 {
473 object obj=ViewState["PrevPageText"];
474 return (obj==null)?"<font face=\"webdings\">3</font>":(string)obj;
475 }
476 set{ViewState["PrevPageText"]=value;}
477 }
478
479 /// <summary>
480 /// 获取或设置为下一页按钮显示的文本。
481 /// </summary>
482 [Browsable(true),
483 Description("下一页按钮上显示的文本"),
484 Category("导航按钮"),
485 DefaultValue("<font face=\"webdings\">4</font>")]
486 public string NextPageText
487 {
488 get
489 {
490 object obj=ViewState["NextPageText"];
491 return (obj==null)?"<font face=\"webdings\">4</font>":(string)obj;
492 }
493 set{ViewState["NextPageText"]=value;}
494 }
495
496 /// <summary>
497 /// 获取或设置为最后一页按钮显示的文本。
498 /// </summary>
499 [Browsable(true),
500 Description("最后一页按钮上显示的文本"),
501 Category("导航按钮"),
502 DefaultValue("<font face=\"webdings\">:</font>")]
503 public string LastPageText
504 {
505 get
506 {
507 object obj=ViewState["LastPageText"];
508 return (obj==null)?"<font face=\"webdings\">:</font>":(string)obj;
509 }
510 set{ViewState["LastPageText"]=value;}
511 }
512
513 /// <summary>
514 /// 获取或设置在 <see cref="AspNetPager"/> 控件的页导航元素中同时显示的数值按钮的数目。
515 /// </summary>
516 [Browsable(true),
517 Description("要显示的页索引数值按钮的数目"),
518 Category("导航按钮"),
519 DefaultValue(10)]
520 public int NumericButtonCount
521 {
522 get
523 {
524 object obj=ViewState["NumericButtonCount"];
525 return (obj==null)?10:(int)obj;
526 }
527 set{ViewState["NumericButtonCount"]=value;}
528 }
529
530 /// <summary>
531 /// 获取或设置一个值,该值指定是否显示已禁用的按钮。
532 /// </summary>
533 /// <remarks>
534 /// 该值用来指定是否显示已禁用的分页导航按钮,当当前页为第一页时,第一页和上一页按钮将被禁用,当当前页为最后一页时,下一页和最后一页按钮将被禁用,被禁用的按钮没有链接,在按钮上点击也不会有任何作用。
535 /// </remarks>
536 [Browsable(true),
537 Category("导航按钮"),
538 Description("是否显示已禁用的按钮"),
539 DefaultValue(true)]
540 public bool ShowDisabledButtons
541 {
542 get
543 {
544 object obj=ViewState["ShowDisabledButtons"];
545 return (obj==null)?true:(bool)obj;
546 }
547 set
548 {
549 ViewState["ShowDisabledButtons"]=value;
550 }
551 }
552
553 #endregion
554
555 #region Image Buttons
556
557 /// <summary>
558 /// 获取或设置当使用图片按钮时,图片文件的路径。
559 /// </summary>
560 [Browsable(true),
561 Category("图片按钮"),
562 Description("当使用图片按钮时,指定图片文件的路径"),
563 DefaultValue(null)]
564 public string ImagePath
565 {
566 get
567 {
568 string imgPath=(string)ViewState["ImagePath"];
569 if(imgPath!=null)
570 imgPath=this.ResolveUrl(imgPath);
571 return imgPath;
572 }
573 set
574 {
575 string imgPath=value.Trim().Replace("\\","/");
576 ViewState["ImagePath"]=(imgPath.EndsWith("/"))?imgPath:imgPath+"/";
577 }
578 }
579
580 /// <summary>
581 /// 获取或设置当使用图片按钮时,图片的类型,如gif或jpg,该值即图片文件的后缀名。
582 /// </summary>
583 [Browsable(true),
584 Category("图片按钮"),
585 DefaultValue(".gif"),
586 Description("当使用图片按钮时,图片的类型,如gif或jpg,该值即图片文件的后缀名")]
587 public string ButtonImageExtension
588 {
589 get
590 {
591 object obj=ViewState["ButtonImageExtension"];
592 return (obj==null)?".gif":(string)obj;
593 }
594 set
595 {
596 string ext=value.Trim();
597 ViewState["ButtonImageExtension"]=(ext.StartsWith("."))?ext:("."+ext);
598 }
599 }
600
601 /// <summary>
602 /// 获取或设置自定义图片文件名的后缀字符串,以区分不同类型的按钮图片。
603 /// </summary>
604 /// <remarks><note>注意:</note>该值不是文件后缀名,而是为区分不同的图片文件而在图片名中加入的字符串,如:
605 /// 当前有两套按钮图片,其中一套中的“1”的图片名可为“1f.gif”,另一套中的“1”的图片名可起为“1n.gif”,其中的f和n即为ButtonImageNameExtension。</remarks>
606 [Browsable(true),
607 DefaultValue(null),
608 Category("图片按钮"),
609 Description("自定义图片文件名的后缀字符串(非文件后缀名),如图片“1f.gif”的ButtonImageNameExtension即为“f”")]
610 public string ButtonImageNameExtension
611 {
612 get
613 {
614 return (string)ViewState["ButtonImageNameExtension"];
615 }
616 set
617 {
618 ViewState["ButtonImageNameExtension"]=value;
619 }
620 }
621
622 /// <summary>
623 /// 获取或设置当前页索引按钮的图片名后缀。
624 /// </summary>
625 /// <remarks>
626 /// 当 <see cref="PagingButtonType"/> 设为 Image 时,该属性允许您设置当前页索引数值按钮使用的图片名后缀字符,因此可以使当前页索引按钮与其它页索引按钮使用不同的图片,若未设置该值,则默认值为<see cref="ButtonImageNameExtension"/>,即当前页索引按钮与其它页索引按钮使用相同的图片。
627 /// </remarks>
628 [Browsable(true),
629 DefaultValue(null),
630 Category("图片按钮"),
631 Description("当前页索引按钮的图片名后缀字符串")]
632 public string CpiButtonImageNameExtension
633 {
634 get
635 {
636 object obj=ViewState["CpiButtonImageNameExtension"];
637 return (obj==null)?ButtonImageNameExtension:(string)obj;
638 }
639 set
640 {
641 ViewState["CpiButtonImageNameExtension"]=value;
642 }
643 }
644
645 /// <summary>
646 /// 获取或设置已禁用的页导航按钮图片名后缀字符串。
647 /// </summary>
648 /// <remarks>
649 /// 当 <see cref="PagingButtonType"/> 设为 Image 时, 该值允许您设置已禁用(即没有链接,因而点击后无反应)的页导航按钮(包括第一页、上一页、下一页、最后一页四个按钮)的图片文件名后缀字符串,因此可以使已禁用的页导航按钮不同于正常的页导航按钮。若未设置该值,则默认值为<see cref="ButtonImageNameExtension"/>,即已禁用的页导航按钮与正常的页导航按钮使用相同的图片。
650 /// </remarks>
651 [Browsable(true),
652 DefaultValue(null),
653 Category("图片按钮"),
654 Description("已禁用的页导航按钮的图片名后缀字符串")]
655 public string DisabledButtonImageNameExtension
656 {
657 get
658 {
659 object obj=ViewState["DisabledButtonImageNameExtension"];
660 return (obj==null)?ButtonImageNameExtension:(string)obj;
661 }
662 set
663 {
664 ViewState["DisabledButtonImageNameExtension"]=value;
665 }
666 }
667 /// <summary>
668 /// 指定当使用图片按钮时,图片的对齐方式。
669 /// </summary>
670
671 [Browsable(true),
672 Description("指定当使用图片按钮时,图片的对齐方式"),
673 DefaultValue(ImageAlign.Baseline),
674 Category("图片按钮")]
675 public ImageAlign ButtonImageAlign
676 {
677 get
678 {
679 object obj=ViewState["ButtonImageAlign"];
680 return (obj==null)?ImageAlign.Baseline:(ImageAlign)obj;
681 }
682 set{ViewState["ButtonImageAlign"]=value;}
683 }
684
685
686 #endregion
687
688 #region Paging
689
690 /// <summary>
691 /// 获取或设置是否启用url来传递分页信息。
692 /// </summary>
693 /// <remarks>
694 /// 启用Url分页方式是将用户欲访问的页索引通过Url来传递,由于该分页方式不使用页面向自身回发来传递数据,
695 /// 所以每次分页时所有的数据都恢复为初始值或需要重新获取。使用Url分页方式不支持动态改变分页控件的属性值,
696 /// 因暂时无法将新的属性值通过Url来传递给下一页。
697 /// </remarks>
698 /// <example>以下示例说明如何用AspNetPager的Url分页方式对DataGrid进行分页(使用Access数据库):
699 /// <code><![CDATA[
700 ///<%@Register TagPrefix="Webdiyer" Namespace="Wuqi.Webdiyer" Assembly="aspnetpager"%>
701 ///<%@Import Namespace="System.Data.OleDb"%>
702 ///<%@ Import Namespace="System.Data"%>
703 ///<%@ Page Language="C#" debug=true%>
704 ///<HTML>
705 /// <HEAD>
706 /// <TITLE>Welcome to Webdiyer.com </TITLE>
707 /// <script runat="server">
708 /// OleDbConnection conn;
709 /// OleDbCommand cmd;
710 /// void Page_Load(object src,EventArgs e){
711 /// conn=new OleDbConnection("Provider=Microsoft.Jet.OLEDB.4.0;Data Source="+Server.MapPath("access/aspnetpager.mdb"));
712 /// if(!Page.IsPostBack){
713 /// cmd=new OleDbCommand("select count(newsid) from wqnews",conn);
714 /// conn.Open();
715 /// pager.RecordCount=(int)cmd.ExecuteScalar();
716 /// conn.Close();
717 /// BindData();
718 /// }
719 /// }
720 ///
721 /// void BindData(){
722 /// cmd=new OleDbCommand("select newsid,heading,source,addtime from wqnews order by addtime desc",conn);
723 /// OleDbDataAdapter adapter=new OleDbDataAdapter(cmd);
724 /// DataSet ds=new DataSet();
725 /// adapter.Fill(ds,pager.PageSize*(pager.CurrentPageIndex-1),pager.PageSize,"news");
726 /// dg.DataSource=ds.Tables["news"];
727 /// dg.DataBind();
728 /// }
729 ///
730 /// void ChangePage(object src,PageChangedEventArgs e){
731 /// pager.CurrentPageIndex=e.NewPageIndex;
732 /// BindData();
733 /// }
734 ///
735 /// </script>
736 /// <meta http-equiv="Content-Language" content="zh-cn">
737 /// <meta http-equiv="content-type" content="text/html;charset=gb2312">
738 /// <META NAME="Generator" CONTENT="EditPlus">
739 /// <META NAME="Author" CONTENT="Webdiyer(yhaili@21cn.com)">
740 /// </HEAD>
741 /// <body>
742 /// <form runat="server" ID="Form1">
743 /// <h2 align="center">AspNetPager分页示例</h2>
744 /// <asp:DataGrid id="dg" runat="server"
745 /// Width="760" CellPadding="4" Align="center" />
746 ///
747 /// <Webdiyer:AspNetPager runat="server" id="pager"
748 /// OnPageChanged="ChangePage"
749 /// HorizontalAlign="center"
750 /// style="MARGIN-TOP:10px;FONT-SIZE:16px"
751 /// PageSize="8"
752 /// ShowInputBox="always"
753 /// SubmitButtonStyle="border:1px solid #000066;height:20px;width:30px"
754 /// InputBoxStyle="border:1px #0000FF solid;text-align:center"
755 /// SubmitButtonText="转到"
756 /// UrlPaging="true"
757 /// UrlPageIndexName="pageindex" />
758 /// </form>
759 /// </body>
760 ///</HTML>
761 /// ]]></code>
762 /// </example>
763 [Browsable(true),
764 Category("分页"),
765 DefaultValue(false),
766 Description("是否使用url传递分页信息的方式来分页")]
767 public bool UrlPaging
768 {
769 get
770 {
771 return urlPaging;
772 }
773 set
774 {
775 urlPaging=value;
776 }
777 }
778
779 /// <summary>
780 /// 获取或设置当启用Url分页方式时,在url中表示要传递的页索引的参数的名称。
781 /// </summary>
782 /// <remarks>
783 /// 该属性允许您自定义通过Url传递页索引时表示要传递的页索引的参数的名称,以避免与现有的参数名重复。
784 /// <p>该属性的默认值是“page”,即通过Url分页时,显示在浏览器地址栏中的Url类似于:</p>http://www.webdiyer.com/aspnetpager/samples/datagrid_url.aspx?page=2
785 /// <p>如将该值改为“pageindex”,则上面的Url将变为:</p><p>http://www.webdiyer.com/aspnetpager/samples/datagrid_url.aspx?pageindex=2 </p>
786 /// </remarks>
787 [Browsable(true),
788 DefaultValue("page"),
789 Category("分页"),
790 Description("当启用Url分页方式时,显示在url中表示要传递的页索引的参数的名称")]
791 public string UrlPageIndexName
792 {
793 get{return urlPageIndexName;}
794 set{urlPageIndexName=value;}
795 }
796
797 /// <summary>
798 /// 获取或设置当启用Url分页方式时,在url中表示要传递的页索引的参数的名称。
799 /// </summary>
800 /// <remarks>
801 /// 该属性允许您自定义通过Url传递页索引时表示要传递的页索引的参数的名称,以避免与现有的参数名重复。
802 /// <p>该属性的默认值是“page”,即通过Url分页时,显示在浏览器地址栏中的Url类似于:</p>http://www.webdiyer.com/aspnetpager/samples/datagrid_url.aspx?pagesize=20
803 /// <p>如将该值改为“pagesize1”,则上面的Url将变为:</p><p>http://www.webdiyer.com/aspnetpager/samples/datagrid_url.aspx?pagesize1=20 </p>
804 /// </remarks>
805 [Browsable(true),
806 DefaultValue("pagesize"),
807 Category("分页"),
808 Description("当启用Url分页方式时,显示在url中表示要传递的记录数的参数的名称")]
809 public string UrlPageSize
810 {
811 get{return urlPageSize;}
812 set{urlPageSize=value;}
813 }
814
815 /// <summary>
816 /// 获取或设置当前显示页的索引。
817 /// </summary>
818 ///<remarks>使用此属性来确定在 AspNetPager 控件中当前显示的页,当前显示的页的数字索引将以红色字体加粗显示。此属性还用于以编程的方式控制所显示的页。
819 ///<p> <b>注意:</b>不同于DataGrid控件的CurrentPageIndex,AspNetPager的CurrentPageIndex属性是从1开始的。</p></remarks>
820 [ReadOnly(true),
821 Browsable(false),
822 Description("当前显示页的索引"),
823 Category("分页"),
824 DefaultValue(1),
825 DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
826 public int CurrentPageIndex
827 {
828 get
829 {
830 object cpage=ViewState["CurrentPageIndex"];
831 int pindex=(cpage==null)?1:(int)cpage;
832 if(pindex>PageCount&&PageCount>0)
833 return PageCount;
834 else if(pindex<1)
835 return 1;
836 return pindex;
837 }
838 set
839 {
840 int cpage=value;
841 if(cpage<1)
842 cpage=1;
843 else if(cpage>this.PageCount)
844 cpage=this.PageCount;
845 ViewState["CurrentPageIndex"]=cpage;
846 }
847 }
848
849 /// <summary>
850 /// 获取或设置需要分页的所有记录的总数。
851 /// </summary>
852 /// <remarks>
853 /// 当页面第一次加载时,应以编程方式将从存储过程或Sql语句中返回的数据表中所有要分页的记录的总数赋予该属性,AspNetPager会将其保存的ViewState中并在页面回发时从ViewState中获取该值,因此避免了每次分页都要访问数据库而影响分页性能。AspNetPager根据要分页的所有数据的总项数和 <see cref="PageSize"/> 属性来计算显示所有数据需要的总页数,即 <see cref="PageCount"/>的值。
854 /// </remarks>
855 /// <example>
856 /// 下面的示例显示如何以编程方式将从Sql语句返回的记录总数赋给该属性:
857 /// <p>
858 /// <code><![CDATA[
859 /// <HTML>
860 /// <HEAD>
861 /// <TITLE>Welcome to Webdiyer.com </TITLE>
862 /// <script runat="server">
863 /// SqlConnection conn;
864 /// SqlCommand cmd;
865 /// void Page_Load(object src,EventArgs e)
866 /// {
867 /// conn=new SqlConnection(ConfigurationSettings.AppSettings["ConnStr"]);
868 /// if(!Page.IsPostBack)
869 /// {
870 /// cmd=new SqlCommand("select count(id) from news",conn);
871 /// conn.Open();
872 /// pager.RecordCount=(int)cmd.ExecuteScalar();
873 /// conn.Close();
874 /// BindData();
875 /// }
876 /// }
877 ///
878 /// void BindData()
879 /// {
880 /// cmd=new SqlCommand("GetPagedNews",conn);
881 /// cmd.CommandType=CommandType.StoredProcedure;
882 /// cmd.Parameters.Add("@pageindex",pager.CurrentPageIndex);
883 /// cmd.Parameters.Add("@pagesize",pager.PageSize);
884 /// conn.Open();
885 /// dataGrid1.DataSource=cmd.ExecuteReader();
886 /// dataGrid1.DataBind();
887 /// conn.Close();
888 /// }
889 /// void ChangePage(object src,PageChangedEventArgs e)
890 /// {
891 /// pager.CurrentPageIndex=e.NewPageIndex;
892 /// BindData();
893 /// }
894 /// </script>
895 /// <meta http-equiv="Content-Language" content="zh-cn">
896 /// <meta http-equiv="content-type" content="text/html;charset=gb2312">
897 /// <META NAME="Generator" CONTENT="EditPlus">
898 /// <META NAME="Author" CONTENT="Webdiyer(yhaili@21cn.com)">
899 /// </HEAD>
900 /// <body>
901 /// <form runat="server" ID="Form1">
902 /// <asp:DataGrid id="dataGrid1" runat="server" />
903 ///
904 /// <Webdiyer:AspNetPager id="pager" runat="server"
905 /// PageSize="8"
906 /// NumericButtonCount="8"
907 /// ShowCustomInfoSection="before"
908 /// ShowInputBox="always"
909 /// CssClass="mypager"
910 /// HorizontalAlign="center"
911 /// OnPageChanged="ChangePage" />
912 ///
913 /// </form>
914 /// </body>
915 ///</HTML>
916 /// ]]>
917 /// </code></p>
918 /// <p>本示例使用的存储过程代码如下:</p>
919 /// <code><![CDATA[
920 ///CREATE procedure GetPagedNews
921 /// (@pagesize int,
922 /// @pageindex int)
923 /// as
924 /// set nocount on
925 /// declare @indextable table(id int identity(1,1),nid int)
926 /// declare @PageLowerBound int
927 /// declare @PageUpperBound int
928 /// set @PageLowerBound=(@pageindex-1)*@pagesize
929 /// set @PageUpperBound=@PageLowerBound+@pagesize
930 /// set rowcount @PageUpperBound
931 /// insert into @indextable(nid) select id from news order by addtime desc
932 /// select O.id,O.title,O.source,O.addtime from news O,@indextable t where O.id=t.nid
933 /// and t.id>@PageLowerBound and t.id<=@PageUpperBound order by t.id
934 /// set nocount off
935 ///GO
936 /// ]]>
937 /// </code>
938 /// </example>
939 [Browsable(false),
940 Description("要分页的所有记录的总数,该值须在程序运行时设置,默认值为225是为设计时支持而设置的参照值。"),
941 Category("Data"),
942 DefaultValue(225)]
943 public int RecordCount
944 {
945 get
946 {
947 object obj=ViewState["Recordcount"];
948 return (obj==null)?0:(int)obj;
949 }
950 set{ViewState["Recordcount"]=value;}
951 }
952
953 /// <summary>
954 /// 获取当前页之后未显示的页的总数。
955 /// </summary>
956 [Browsable(false),
957 DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
958 public int PagesRemain
959 {
960 get
961 {
962 return PageCount-CurrentPageIndex;
963 }
964 }
965
966 /// <summary>
967 /// 获取或设置每页显示的项数。
968 /// </summary>
969 /// <remarks>
970 /// 该值获取或设置数据呈现控件每次要显示数据表中的的数据的项数,AspNetPager根据该值和 <see cref="RecordCount"/> 来计算显示所有数据需要的总页数,即 <see cref="PageCount"/>的值。</remarks>
971 /// <example>以下示例将 <see cref="AspNetPager"/> 设置为允许每页显示8条数据:
972 /// <code>
973 /// <![CDATA[
974 ///
975 /// <Webdiyer:AspNetPager id="pager" runat="server" PageSize=8 OnPageChanged="ChangePage"/>
976 ///
977 /// ]]></code></example>
978 [Browsable(true),
979 Description("每页显示的记录数"),
980 Category("分页"),
981 DefaultValue(10)]
982 public int PageSize
983 {
984 get
985 {
986 object obj=ViewState["PageSize"];
987 return (obj==null)?10:(int)obj;
988 }
989 set
990 {
991 ViewState["PageSize"]=value;
992 }
993 }
994
995 /// <summary>
996 /// 获取在当前页之后还未显示的剩余记录的项数。
997 /// </summary>
998 [Browsable(false),
999 DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
1000 public int RecordsRemain
1001 {
1002 get
1003 {
1004 if(CurrentPageIndex<PageCount)
1005 return RecordCount-(CurrentPageIndex*PageSize);
1006 return 0;}
1007 }
1008
1009
1010 /// <summary>
1011 /// 获取所有要分页的记录需要的总页数。
1012 /// </summary>
1013 [Browsable(false),
1014 DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
1015 public int PageCount
1016 {
1017 get{return (int)Math.Ceiling((double)RecordCount/(double)PageSize);}
1018 }
1019
1020
1021 #endregion
1022
1023 #region TextBox and Submit Button
1024
1025 /// <summary>
1026 /// 获取或设置页索引文本框的显示方式。
1027 /// </summary>
1028 /// <remarks>
1029 /// 页索引文件框允许用户手式输入要访问的页的索引,当页数非常多时,显示页索引文本框非常方便用户跳转到指定的页,默认情况下,该文本框只有在总页数大于或等于 <see cref="ShowBoxThreshold"/> 的值时才显示,否则不显示,要想该文本框任何时候都显示,请将其值设为Always,若希望任何时候都不显示,则应设为Never。
1030 ///</remarks>
1031 [Browsable(true),
1032 Description("指定页索引文本框的显示方式"),
1033 Category("文本框及提交按钮"),
1034 DefaultValue(ShowInputBox.Auto)]
1035 public ShowInputBox ShowInputBox
1036 {
1037 get
1038 {
1039 object obj=ViewState["ShowInputBox"];
1040 return (obj==null)?ShowInputBox.Auto:(ShowInputBox)obj;
1041 }
1042 set{ViewState["ShowInputBox"]=value;}
1043 }
1044
1045 /// <summary>
1046 /// 获取或设置应用于页索引输入文本框的CSS类名。
1047 /// </summary>
1048 [Browsable(true),
1049 Category("文本框及提交按钮"),
1050 DefaultValue(null),
1051 Description("应用于页索引输入文本框的CSS类名")]
1052 public string InputBoxClass
1053 {
1054 get
1055 {
1056 return (string)ViewState["InputBoxClass"];
1057 }
1058 set
1059 {
1060 if(value.Trim().Length>0)
1061 ViewState["InputBoxClass"]=value;
1062 }
1063 }
1064
1065 /// <summary>
1066 /// 获取或设置页索引输入文本框的CSS样式文本。
1067 /// </summary>
1068
1069 [Browsable(true),
1070 Category("文本框及提交按钮"),
1071 DefaultValue(null),
1072 Description("应用于页索引输入文本框的CSS样式文本")]
1073 public string InputBoxStyle
1074 {
1075 get
1076 {
1077 return (string)ViewState["InputBoxStyle"];
1078 }
1079 set
1080 {
1081 if(value.Trim().Length>0)
1082 ViewState["InputBoxStyle"]=value;
1083 }
1084 }
1085
1086 /// <summary>
1087 /// 获取或设置页索引页索引输入文本框前的文本字符串值。
1088 /// </summary>
1089 [Browsable(true),
1090 Category("文本框及提交按钮"),
1091 DefaultValue(null),
1092 Description("页索引输入文本框前的文本内容字符串")]
1093 public string TextBeforeInputBox
1094 {
1095 get
1096 {
1097 return (string)ViewState["TextBeforeInputBox"];
1098 }
1099 set
1100 {
1101 ViewState["TextBeforeInputBox"]=value;
1102 }
1103 }
1104
1105 /// <summary>
1106 /// 获取或设置页索引文本输入框后的文本内容字符串值。
1107 /// </summary>
1108 [Browsable(true),
1109 DefaultValue(null),
1110 Category("文本框及提交按钮"),
1111 Description("页索引输入文本框后的文本内容字符串")]
1112 public string TextAfterInputBox
1113 {
1114 get
1115 {
1116 return (string)ViewState["TextAfterInputBox"];
1117 }
1118 set
1119 {
1120 ViewState["TextAfterInputBox"]=value;
1121 }
1122 }
1123
1124
1125 /// <summary>
1126 /// 获取或设置提交按钮上的文本。
1127 /// </summary>
1128 [Browsable(true),
1129 Category("文本框及提交按钮"),
1130 DefaultValue("go"),
1131 Description("提交按钮上的文本")]
1132 public string SubmitButtonText
1133 {
1134 get
1135 {
1136 object obj=ViewState["SubmitButtonText"];
1137 return (obj==null)?"go":(string)obj;
1138 }
1139 set
1140 {
1141 if(value.Trim().Length>0)
1142 ViewState["SubmitButtonText"]=value;
1143 }
1144 }
1145 /// <summary>
1146 /// 获取或设置应用于提交按钮的CSS类名。
1147 /// </summary>
1148 [Browsable(true),
1149 Category("文本框及提交按钮"),
1150 DefaultValue(null),
1151 Description("应用于提交按钮的CSS类名")]
1152 public string SubmitButtonClass
1153 {
1154 get
1155 {
1156 return (string)ViewState["SubmitButtonClass"];
1157 }
1158 set
1159 {
1160 ViewState["SubmitButtonClass"]=value;
1161 }
1162 }
1163
1164 /// <summary>
1165 /// 获取或设置应用于提交按钮的CSS样式。
1166 /// </summary>
1167 [Browsable(true),
1168 Category("文本框及提交按钮"),
1169 DefaultValue(null),
1170 Description("应用于提交按钮的CSS样式")]
1171 public string SubmitButtonStyle
1172 {
1173 get
1174 {
1175 return (string)ViewState["SubmitButtonStyle"];
1176 }
1177 set
1178 {
1179 ViewState["SubmitButtonStyle"]=value;
1180 }
1181 }
1182 /// <summary>
1183 /// 获取或设置自动显示页索引输入文本框的最低起始页数。
1184 /// </summary>
1185 /// <remarks>
1186 /// 当 <see cref="ShowInputBox"/> 设为Auto(默认)并且要分页的数据的总页数达到该值时会自动显示页索引输入文本框,默认值为30。该选项当 <see cref="ShowInputBox"/> 设为Never或Always时没有任何作用。
1187 /// </remarks>
1188 [Browsable(true),
1189 Description("指定当ShowInputBox设为ShowInputBox.Auto时,当总页数达到多少时才显示页索引输入文本框"),
1190 Category("文本框及提交按钮"),
1191 DefaultValue(30)]
1192 public int ShowBoxThreshold
1193 {
1194 get
1195 {
1196 object obj=ViewState["ShowBoxThreshold"];
1197 return (obj==null)?30:(int)obj;
1198 }
1199 set{ViewState["ShowBoxThreshold"]=value;}
1200 }
1201
1202
1203 #endregion
1204
1205 #region SelectBox and Submit Button
1206
1207 /// <summary>
1208 /// 获取或设置页索引文本框的显示方式。
1209 /// </summary>
1210 /// <remarks>
1211 /// 页索引文件框允许用户手式输入要访问的页的索引,当页数非常多时,显示页索引文本框非常方便用户跳转到指定的页,默认情况下,该文本框只有在总页数大于或等于 <see cref="ShowBoxThreshold"/> 的值时才显示,否则不显示,要想该文本框任何时候都显示,请将其值设为Always,若希望任何时候都不显示,则应设为Never。
1212 ///</remarks>
1213 [Browsable(true),
1214 Description("指定页索引文本框的显示方式"),
1215 Category("分页记录数选择"),
1216 DefaultValue(ShowInputBox.Auto)]
1217 public ShowInputBox ShowSelectBox
1218 {
1219 get
1220 {
1221 object obj=ViewState["ShowSelectBox"];
1222 return (obj==null)?ShowInputBox.Auto:(ShowInputBox)obj;
1223 }
1224 set{ViewState["ShowSelectBox"]=value;}
1225 }
1226
1227 /// <summary>
1228 /// 获取或设置应用于页索引输入文本框的CSS类名。
1229 /// </summary>
1230 [Browsable(true),
1231 Category("分页记录数选择"),
1232 DefaultValue(null),
1233 Description("应用于页索引输入文本框的CSS类名")]
1234 public string SelectBoxClass
1235 {
1236 get
1237 {
1238 return (string)ViewState["SelectBoxClass"];
1239 }
1240 set
1241 {
1242 if(value.Trim().Length>0)
1243 ViewState["SelectBoxClass"]=value;
1244 }
1245 }
1246
1247 /// <summary>
1248 /// 获取或设置页索引输入文本框的CSS样式文本。
1249 /// </summary>
1250
1251 [Browsable(true),
1252 Category("分页记录数选择"),
1253 DefaultValue(null),
1254 Description("应用于页索引输入文本框的CSS样式文本")]
1255 public string SelectBoxStyle
1256 {
1257 get
1258 {
1259 return (string)ViewState["SelectBoxStyle"];
1260 }
1261 set
1262 {
1263 if(value.Trim().Length>0)
1264 ViewState["SelectBoxStyle"]=value;
1265 }
1266 }
1267
1268 /// <summary>
1269 /// 获取或设置页索引页索引输入文本框前的文本字符串值。
1270 /// </summary>
1271 [Browsable(true),
1272 Category("分页记录数选择"),
1273 DefaultValue("每页"),
1274 Description("页索引输入文本框前的文本内容字符串")]
1275 public string TextBeforeSelectBox
1276 {
1277 get
1278 {
1279 return (string)ViewState["TextBeforeSelectBox"];
1280 }
1281 set
1282 {
1283 ViewState["TextBeforeSelectBox"]=value;
1284 }
1285 }
1286
1287 /// <summary>
1288 /// 获取或设置页索引文本输入框后的文本内容字符串值。
1289 /// </summary>
1290 [Browsable(true),
1291 DefaultValue("条"),
1292 Category("分页记录数选择"),
1293 Description("页索引输入文本框后的文本内容字符串")]
1294 public string TextAfterSelectBox
1295 {
1296 get
1297 {
1298 return (string)ViewState["TextAfterSelectBox"];
1299 }
1300 set
1301 {
1302 ViewState["TextAfterSelectBox"]=value;
1303 }
1304 }
1305
1306
1307 /// <summary>
1308 /// 获取或设置提交按钮上的文本。
1309 /// </summary>
1310 [Browsable(true),
1311 Category("分页记录数选择"),
1312 DefaultValue("设置"),
1313 Description("提交按钮上的文本")]
1314 public string SubmitButtonSelectText
1315 {
1316 get
1317 {
1318 object obj=ViewState["SubmitButtonSelectText"];
1319 return (obj==null)?"设置":(string)obj;
1320 }
1321 set
1322 {
1323 if(value.Trim().Length>0)
1324 ViewState["SubmitButtonSelectText"]=value;
1325 }
1326 }
1327 /// <summary>
1328 /// 获取或设置自动显示页索引输入文本框的最低起始页数。
1329 /// </summary>
1330 /// <remarks>
1331 /// 当 <see cref="ShowInputBox"/> 设为Auto(默认)并且要分页的数据的总页数达到该值时会自动显示页索引输入文本框,默认值为30。该选项当 <see cref="ShowInputBox"/> 设为Never或Always时没有任何作用。
1332 /// </remarks>
1333 [Browsable(true),
1334 Description("指定当ShowInputBox设为ShowInputBox.Auto时,当总页数达到多少时才显示页索引输入文本框"),
1335 Category("分页记录数选择"),
1336 DefaultValue(30)]
1337 public int ShowSelectBoxThreshold
1338 {
1339 get
1340 {
1341 object obj=ViewState["ShowSelectBoxThreshold"];
1342 return (obj==null)?30:(int)obj;
1343 }
1344 set{ViewState["ShowSelectBoxThreshold"]=value;}
1345 }
1346
1347
1348 #endregion
1349
1350 #region CustomInfoSection
1351
1352 /// <summary>
1353 /// 获取或设置显示用户自定义信息区的方式。
1354 /// </summary>
1355 /// <remarks>
1356 /// 该属性值设为Left或Right时会在分页导航元素左边或右边划出一个专门的区域来显示有关用户自定义信息,设为Never时不显示。
1357 /// </remarks>
1358 [Browsable(true),
1359 Description("显示当前页和总页数信息,默认值为不显示,值为ShowCustomInfoSection.Left时将显示在页索引前,为ShowCustomInfoSection.Right时将显示在页索引后"),
1360 DefaultValue(ShowCustomInfoSection.Never),
1361 Category("自定义信息区")]
1362 public ShowCustomInfoSection ShowCustomInfoSection
1363 {
1364 get
1365 {
1366 object obj=ViewState["ShowCustomInfoSection"];
1367 return (obj==null)?ShowCustomInfoSection.Never:(ShowCustomInfoSection)obj;
1368 }
1369 set{ViewState["ShowCustomInfoSection"]=value;}
1370 }
1371
1372 /// <summary>
1373 /// 获取或设置用户自定义信息区文本的对齐方式。
1374 /// </summary>
1375 [Browsable(true),
1376 Category("自定义信息区"),
1377 DefaultValue(HorizontalAlign.Left),
1378 Description("用户自定义信息区文本的对齐方式")]
1379 public HorizontalAlign CustomInfoTextAlign
1380 {
1381 get
1382 {
1383 object obj=ViewState["CustomInfoTextAlign"];
1384 return (obj==null)?HorizontalAlign.Left:(HorizontalAlign)obj;
1385 }
1386 set
1387 {
1388 ViewState["CustomInfoTextAlign"]=value;
1389 }
1390 }
1391
1392 /// <summary>
1393 /// 获取或设置用户自定义信息区的宽度。
1394 /// </summary>
1395 [Browsable(true),
1396 Category("自定义信息区"),
1397 DefaultValue(typeof(Unit),"40%"),
1398 Description("用户自定义信息区的宽度")]
1399 public Unit CustomInfoSectionWidth
1400 {
1401 get
1402 {
1403 object obj=ViewState["CustomInfoSectionWidth"];
1404 return (obj==null)?Unit.Percentage(40):(Unit)obj;
1405 }
1406 set
1407 {
1408 ViewState["CustomInfoSectionWidth"]=value;
1409 }
1410 }
1411
1523 [Browsable(false),
2601
2608 /// 使用文字按钮。
2//版权所有:陕西省吴旗县 Webdiyer(yhaili@21cn.com)(Web site: www.webdiyer.com);
3//此源代码仅供学习参考,不得用作任何商业用途;
4//若需修改并重新编译该控件,请保留完整的源代码的版权信息!
5//有关控件升级及新控件发布信息,请留意 www.webdiyer.com 。
6//版本4.3.3
7//增强版 (修改自4.3.3版本)
8//描述:增加了可自定义每页的记录数。
9//modify by liubiqu(liubiqu@sina.com) [http://www.cnblogs.com/liubiqu]
10//DateTime: 2005-06-10
11
12using System;
13using System.Collections;
14using System.Collections.Specialized;
15using System.ComponentModel;
16using System.IO;
17using System.Text;
18using System.Web.UI;
19using System.Web.UI.Design.WebControls;
20using System.Web.UI.WebControls;
21
22namespace EOffice.Components
23{
24 #region AspNetPager Server Control
25
26 #region 控件说明及示例
27 /// <summary>
28 /// 用于ASP.NET Web应用程序中对数据进行分页的的服务器控件。
29 /// </summary>
30 /// <remarks>不同于DataGrid控件,AspNetPager分页控件本身并不显示任何数据,而只显示页导航元素,数据在页面上的显示方式与该控件无关。该控件可以为DataGrid、DataList、Repeater以及自定义控件进行分页,配合Sql存储过程,分页性能较使用DataGrid分页有明显提升,尤其是当数据量大时性能可提升数倍!
31 /// <p>AspNetPager 2.0 中新增了通过Url来分页的功能,这使得访问者可以直接输入相应的Url来访问任何页面,并且搜索引擎也可以直接检索每个页面,若使用DataGrid的分页功能,这是无法实现的。</p>
32 /// <p>要使用 AspNetPager 分页控件,必须最少指定它的 <see cref="RecordCount"/> 属性,指定并编写 <see cref="PageChanged"/> 事件的处理程序。
33 /// <see cref="RecordCount"/> 属性指定要分页的所有数据的总项数,若未指定该值或该值小于等于 <see cref="PageSize"/> ,则AspNetPager控件不会显示任何内容。
34 /// 若未指定并编写 <see cref="PageChanged"/> 事件处理程序,则当用户点击页导航元素或在页索引文本框中手式输入页索引并提交时AspNetPager不会跳转到指定的页。
35 /// AspNetPager控件的分页方法和DataGrid基本相同,即在它的 <see cref="PageChanged"/> 事件处理程序中将传递事件数据的 <see cref="PageChangedEventArgs"/> 的 <see cref="PageChangedEventArgs.NewPageIndex"/>值赋给 AspNetPager的 <see cref="CurrentPageIndex"/>属性,然后重新将新的数据与数据显示控件绑定。 </p></remarks>
36 /// <example>以下示例说明如何用AspNetPager对DataGrid进行分页。
37 /// <code><![CDATA[
38 ///<%@ Page Language="C#"%>
39 ///<%@ Import Namespace="System.Data"%>
40 ///<%@Import Namespace="System.Data.SqlClient"%>
41 ///<%@Import Namespace="System.Configuration"%>
42 ///<%@Register TagPrefix="Webdiyer" Namespace="Wuqi.Webdiyer" Assembly="aspnetpager"%>
43 ///<HTML>
44 ///<HEAD>
45 ///<TITLE>Welcome to Webdiyer.com </TITLE>
46 /// <script runat="server">
47 /// SqlConnection conn;
48 /// SqlCommand cmd;
49 /// void Page_Load(object src,EventArgs e)
50 /// {
51 /// conn=new SqlConnection(ConfigurationSettings.AppSettings["ConnStr"]);
52 /// if(!Page.IsPostBack)
53 /// {
54 /// cmd=new SqlCommand("GetNews",conn);
55 /// cmd.CommandType=CommandType.StoredProcedure;
56 /// cmd.Parameters.Add("@pageindex",1);
57 /// cmd.Parameters.Add("@pagesize",1);
58 /// cmd.Parameters.Add("@docount",true);
59 /// conn.Open();
60 /// pager.RecordCount=(int)cmd.ExecuteScalar();
61 /// conn.Close();
62 /// BindData();
63 /// }
64 /// }
65 ///
66 /// void BindData()
67 /// {
68 /// cmd=new SqlCommand("GetNews",conn);
69 /// cmd.CommandType=CommandType.StoredProcedure;
70 /// cmd.Parameters.Add("@pageindex",pager.CurrentPageIndex);
71 /// cmd.Parameters.Add("@pagesize",pager.PageSize);
72 /// cmd.Parameters.Add("@docount",false);
73 /// conn.Open();
74 /// dataGrid1.DataSource=cmd.ExecuteReader();
75 /// dataGrid1.DataBind();
76 /// conn.Close();
77 /// pager.CustomInfoText="记录总数:<font color=\"blue\"><b>"+pager.RecordCount.ToString()+"</b></font>";
78 /// pager.CustomInfoText+=" 总页数:<font color=\"blue\"><b>"+pager.PageCount.ToString()+"</b></font>";
79 /// pager.CustomInfoText+=" 当前页:<font color=\"red\"><b>"+pager.CurrentPageIndex.ToString()+"</b></font>";
80 /// }
81 /// void ChangePage(object src,PageChangedEventArgs e)
82 /// {
83 /// pager.CurrentPageIndex=e.NewPageIndex;
84 /// BindData();
85 /// }
86 /// </script>
87 /// <meta http-equiv="Content-Language" content="zh-cn">
88 /// <meta http-equiv="content-type" content="text/html;charset=gb2312">
89 /// <META NAME="Generator" CONTENT="EditPlus">
90 /// <META NAME="Author" CONTENT="Webdiyer(yhaili@21cn.com)">
91 /// </HEAD>
92 /// <body>
93 /// <form runat="server" ID="Form1">
94 /// <asp:DataGrid id="dataGrid1" runat="server" />
95 ///
96 /// <Webdiyer:AspNetPager id="pager"
97 /// runat="server"
98 /// PageSize="8"
99 /// NumericButtonCount="8"
100 /// ShowCustomInfoSection="left"
101 /// PagingButtonSpacing="0"
102 /// ShowInputBox="always"
103 /// CssClass="mypager"
104 /// HorizontalAlign="right"
105 /// OnPageChanged="ChangePage"
106 /// SubmitButtonText="转到"
107 /// NumericButtonTextFormatString="[{0}]"/>
108 ///
109 /// </form>
110 /// </body>
111 ///</HTML>
112 /// ]]>
113 /// </code>
114 /// <p>下面是该示例所用的Sql Server存储过程:</p>
115 /// <code>
116 /// <![CDATA[
117 ///CREATE procedure GetNews
118 /// (@pagesize int,
119 /// @pageindex int,
120 /// @docount bit)
121 /// as
122 /// set nocount on
123 /// if(@docount=1)
124 /// select count(id) from news
125 /// else
126 /// begin
127 /// declare @indextable table(id int identity(1,1),nid int)
128 /// declare @PageLowerBound int
129 /// declare @PageUpperBound int
130 /// set @PageLowerBound=(@pageindex-1)*@pagesize
131 /// set @PageUpperBound=@PageLowerBound+@pagesize
132 /// set rowcount @PageUpperBound
133 /// insert into @indextable(nid) select id from news order by addtime desc
134 /// select O.id,O.source,O.title,O.addtime from news O,@indextable t where O.id=t.nid
135 /// and t.id>@PageLowerBound and t.id<=@PageUpperBound order by t.id
136 /// end
137 /// set nocount off
138 ///GO
139 /// ]]>
140 /// </code></example>
141 #endregion
142
143 [DefaultProperty("PageSize")]
144 [DefaultEvent("PageChanged")]
145 [ParseChildren(false)]
146 [PersistChildren(false)]
147 [Description("专用于ASP.Net Web应用程序的分页控件")]
148 [Designer(typeof(PagerDesigner))]
149 [ToolboxData("<{0}:AspNetPager runat=server></{0}:AspNetPager>")]
150 public class AspNetPager:Panel,INamingContainer,IPostBackEventHandler,IPostBackDataHandler
151 {
152 private string cssClassName;
153 private string urlPageIndexName="page";
154 private string urlPageSize = "pagesize";//TODO:var urlPageSize add by liubiqu 2005-6-10
155 private bool urlPaging=false;
156 private string inputPageIndex;
157 private string selectPageSize; //TODO:var selectPageSize add by liubiqu 2005-6-10
158 private string currentUrl=null;
159 private NameValueCollection urlParams=null;
160
161 #region Properties
162
163 #region Navigation Buttons
164
165 /// <summary>
166 /// 获取或设置一个值,该值批示当鼠标指针悬停在导航按钮上时是否显示工具提示。
167 /// </summary>
168 [Browsable(true),
169 Category("导航按钮"),
170 DefaultValue(true),
171 Description("指定当鼠标停留在导航按钮上时,是否显示工具提示")]
172 public bool ShowNavigationToolTip
173 {
174 get
175 {
176 object obj=ViewState["ShowNavigationToolTip"];
177 return (obj==null)?true:(bool)obj;
178 }
179 set
180 {
181 ViewState["ShowNavigationToolTip"]=value;
182 }
183 }
184
185 /// <summary>
186 /// 获取或设置导航按钮工具提示文本的格式。
187 /// </summary>
188 [Browsable(true),
189 Category("导航按钮"),
190 DefaultValue("转到第{0}页"),
191 Description("页导航按钮工具提示文本的格式")]
192 public string NavigationToolTipTextFormatString
193 {
194 get
195 {
196 object obj=ViewState["NavigationToolTipTextFormatString"];
197 return (obj==null)?"转到第{0}页":(string)obj;
198 }
199 set
200 {
201 string tip=value;
202 if(tip.Trim().Length<1&&tip.IndexOf("{0}")<0)
203 tip="{0}";
204 ViewState["NavigationToolTipTextFormatString"]=tip;
205 }
206 }
207
208 /// <summary>
209 /// 获取或设置一个值,该值指示是否将页索引按钮用中文数字代替。
210 /// </summary>
211 /// <remarks>
212 /// 将该值设为true并且未使用图片按钮时,页索引按钮中的数值1、2、3等将会被中文字符一、二、三等代替。
213 /// </remarks>
214 [Browsable(true),
215 Category("导航按钮"),
216 DefaultValue(false),
217 Description("是否将页索引数值按钮用中文数字一、二、三等代替")]
218 public bool ChinesePageIndex
219 {
220 get
221 {
222 object obj=ViewState["ChinesePageIndex"];
223 return (obj==null)?false:(bool)obj;
224 }
225 set
226 {
227 ViewState["ChinesePageIndex"]=value;
228 }
229 }
230
231 /// <summary>
232 /// 获取或设置页索引数值导航按钮上文字的显示格式。
233 /// </summary>
234 /// <value>
235 /// 字符串,指定页索引数值按钮上文字的显示格式,默认值为<see cref="String.Empty"/>,即未设置该属性。</value>
236 /// <remarks>
237 /// 使用NumericButtonTextFormatString属性指定页索引数值按钮的显示格式,如未设置该值时索引按钮文本将会是:1 2 3 ,设置该值将改变索引按钮文本的显示格式,
238 /// 如将该值设为“[{0}]”则索引文本会显示为:[1] [2] [3] ,将该值设为“-{0}-”则会使索引文本变为:-1- -2- -3- 。
239 /// </remarks>
240 [Browsable(true),
241 DefaultValue(""),
242 Category("导航按钮"),
243 Description("页索引数值按钮上文字的显示格式")]
244 public string NumericButtonTextFormatString
245 {
246 get
247 {
248 object obj=ViewState["NumericButtonTextFormatString"];
249 return (obj==null)?String.Empty:(string)obj;
250 }
251 set
252 {
253 ViewState["NumericButtonTextFormatString"]=value;
254 }
255 }
256
257 /// <summary>
258 /// 获取或设置分页导航按钮的类型,即使用文字还是图片。
259 /// </summary>
260 /// <remarks>
261 /// 要使用图片按钮,您需要准备以下图片:从0到9的十个数值图片(当ShowPageIndex设为true时),第一页、上一页、下一页、最后一页及更多页()五个按钮图片(当ShowFirstLast及ShowPrevNext都设为true时),
262 /// 若需要使当前页索引的数值按钮不同于别的页索引数值按钮,则还需准备当前页索引的按钮图片;
263 /// 若需要使已禁用的第一页、上一页、下一页及最后一页按钮图片不同于正常的按钮图片,则还需准备这四个按钮在禁用状态下的图片;
264 /// <p><b>图片文件的命名规则如下:</b></p>
265 /// <p>从0到9十张数值按钮图片必须命名为“数值+ButtonImageNameExtension+ButtonImageExtension”,其中的ButtonImageNameExtension可以不用设置,
266 /// ButtonImageExtension是图片文件的后缀名,如 .gif或 .jpg等可以在浏览器中显示的任何图片文件类型。如页索引“1”的图片文件可命名为“1.gif”或“1.jpg”,
267 /// 当您有两套或更多套图片文件时,可以通过指定ButtonImageNameExtension属性值来区分不同套的图片,如第一套图片可以不用设ButtonImageNameExtension,则图片文件名类似于“1.gif”、“2.gif”等等,而第二套图片则设置ButtonImageNameExtension为“f”,图片文件名类似于“1f.gif”,“2f.gif”等等。</p>
268 /// <p>第一页按钮的图片文件名以“first”开头,上一页按钮图片名以“prev”开头,下一页按钮图片名以“next”开头,最后一页按钮图片名以“last”开头,更多页按钮图片名以“more”开头,是否使用ButtonImageNameExtension取决于数值按钮的设置及是否有更多套图片。</p>
269 /// </remarks>
270 /// <example>
271 /// 以下代码片段示例如果使用图片按钮:
272 /// <p>
273 /// <code><![CDATA[
274 /// <Webdiyer:AspNetPager runat="server"
275 /// id="pager1"
276 /// OnPageChanged="ChangePage"
277 /// PagingButtonType="image"
278 /// ImagePath="images"
279 /// ButtonImageNameExtension="n"
280 /// DisabledButtonImageNameExtension="g"
281 /// ButtonImageExtension="gif"
282 /// CpiButtonImageNameExtension="r"
283 /// PagingButtonSpacing=5/>
284 /// ]]>
285 /// </code>
286 /// </p>
287 /// </example>
288 [Browsable(true),
289 DefaultValue(PagingButtonType.Text),
290 Category("导航按钮"),
291 Description("分页导航按钮的类型,是使用文字还是图片")]
292 public PagingButtonType PagingButtonType
293 {
294 get
295 {
296 object obj=ViewState["PagingButtonType"];
297 return (obj==null)?PagingButtonType.Text:(PagingButtonType)obj;
298 }
299 set
300 {
301 ViewState["PagingButtonType"]=value;
302 }
303 }
304
305 /// <summary>
306 /// 获取或设置页导航数值按钮的类型,该值仅当PagingButtonType设为Image时才有效。
307 /// </summary>
308 /// <remarks>
309 /// 当您将PagingButtonType设为Image当又不想让页索引数值按钮使用图片时,可以将该值设为Text,这会使页索引数据按钮使用文本而不是图片按钮。
310 /// </remarks>
311 [Browsable(true),
312 DefaultValue(PagingButtonType.Text),
313 Category("导航按钮"),
314 Description("页导航数值按钮的类型")]
315 public PagingButtonType NumericButtonType
316 {
317 get
318 {
319 object obj=ViewState["NumericButtonType"];
320 return (obj==null)?PagingButtonType:(PagingButtonType)obj;
321 }
322 set
323 {
324 ViewState["NumericButtonType"]=value;
325 }
326 }
327
328 /// <summary>
329 /// 获取或设置第一页、上一页、下一页和最后一页按钮的类型,该值仅当PagingButtonType设为Image时才有效。
330 /// </summary>
331 /// <remarks>
332 /// 当您将PagingButtonType设为Image但又不想让第一页、下一页、下一页和最后一页按钮使用图片,则可以将该值设为Text,这会使前面的四个按钮使用文本而不是图片按钮。
333 /// </remarks>
334 [Browsable(true),
335 Category("导航按钮"),
336 DefaultValue(PagingButtonType.Text),
337 Description("第一页、上一页、下一页和最后一页按钮的类型")]
338 public PagingButtonType NavigationButtonType
339 {
340 get
341 {
342 object obj=ViewState["NavigationButtonType"];
343 return (obj==null)?PagingButtonType:(PagingButtonType)obj;
344 }
345 set
346 {
347 ViewState["NavigationButtonType"]=value;
348 }
349 }
350
351 /// <summary>
352 /// 获取或设置“更多页”()按钮的类型,该值仅当PagingButtonType设为Image时才有效。
353 /// </summary>
354 /// <remarks>
355 /// 当您将PagingButtonType设为Image但又不想让更多页()按钮使用图片时,可以将此值设为Text,这会使更多页按钮使用文本而不是图片按钮。
356 /// </remarks>
357 [Browsable(true),
358 Category("导航按钮"),
359 DefaultValue(PagingButtonType.Text),
360 Description("“更多页”()按钮的类型")]
361 public PagingButtonType MoreButtonType
362 {
363 get
364 {
365 object obj=ViewState["MoreButtonType"];
366 return (obj==null)?PagingButtonType:(PagingButtonType)obj;
367 }
368 set
369 {
370 ViewState["MoreButtonType"]=value;
371 }
372 }
373
374 /// <summary>
375 /// 获取或设置分页导航按钮之间的间距。
376 /// </summary>
377 [Browsable(true),
378 Category("导航按钮"),
379 DefaultValue(typeof(Unit),"5px"),
380 Description("分页导航按钮之间的间距")]
381 public Unit PagingButtonSpacing
382 {
383 get
384 {
385 object obj=ViewState["PagingButtonSpacing"];
386 return (obj==null)?Unit.Pixel(5):(Unit.Parse(obj.ToString()));
387 }
388 set
389 {
390 ViewState["PagingButtonSpacing"]=value;
391 }
392 }
393
394 /// <summary>
395 /// 获取或设置一个值,该值指示是否在页导航元素中显示第一页和最后一页按钮。
396 /// </summary>
397 [Browsable(true),
398 Description("是否在页导航元素中显示第一页和最后一页按钮"),
399 Category("导航按钮"),
400 DefaultValue(true)]
401 public bool ShowFirstLast
402 {
403 get
404 {
405 object obj=ViewState["ShowFirstLast"];
406 return (obj==null)?true:(bool)obj;
407 }
408 set{ViewState["ShowFirstLast"]=value;}
409 }
410
411 /// <summary>
412 /// 获取或设置一个值,该值指示是否在页导航元素中显示上一页和下一页按钮。
413 /// </summary>
414 [Browsable(true),
415 Description("是否在页导航元素中显示上一页和下一页按钮"),
416 Category("导航按钮"),
417 DefaultValue(true)]
418 public bool ShowPrevNext
419 {
420 get
421 {
422 object obj=ViewState["ShowPrevNext"];
423 return (obj==null)?true:(bool)obj;
424 }
425 set{ViewState["ShowPrevNext"]=value;}
426 }
427
428 /// <summary>
429 /// 获取或设置一个值,该值指示是否在页导航元素中显示页索引数值按钮。
430 /// </summary>
431 [Browsable(true),
432 Description("是否在页导航元素中显示数值按钮"),
433 Category("导航按钮"),
434 DefaultValue(true)]
435 public bool ShowPageIndex
436 {
437 get
438 {
439 object obj=ViewState["ShowPageIndex"];
440 return (obj==null)?true:(bool)obj;
441 }
442 set{ViewState["ShowPageIndex"]=value;}
443 }
444
445 /// <summary>
446 /// 获取或设置为第一页按钮显示的文本。
447 /// </summary>
448 [Browsable(true),
449 Description("第一页按钮上显示的文本"),
450 Category("导航按钮"),
451 DefaultValue("<font face=\"webdings\">9</font>")]
452 public string FirstPageText
453 {
454 get
455 {
456 object obj=ViewState["FirstPageText"];
457 return (obj==null)?"<font face=\"webdings\">9</font>":(string)obj;
458 }
459 set{ViewState["FirstPageText"]=value;}
460 }
461
462 /// <summary>
463 /// 获取或设置为上一页按钮显示的文本。
464 /// </summary>
465 [Browsable(true),
466 Description("上一页按钮上显示的文本"),
467 Category("导航按钮"),
468 DefaultValue("<font face=\"webdings\">3</font>")]
469 public string PrevPageText
470 {
471 get
472 {
473 object obj=ViewState["PrevPageText"];
474 return (obj==null)?"<font face=\"webdings\">3</font>":(string)obj;
475 }
476 set{ViewState["PrevPageText"]=value;}
477 }
478
479 /// <summary>
480 /// 获取或设置为下一页按钮显示的文本。
481 /// </summary>
482 [Browsable(true),
483 Description("下一页按钮上显示的文本"),
484 Category("导航按钮"),
485 DefaultValue("<font face=\"webdings\">4</font>")]
486 public string NextPageText
487 {
488 get
489 {
490 object obj=ViewState["NextPageText"];
491 return (obj==null)?"<font face=\"webdings\">4</font>":(string)obj;
492 }
493 set{ViewState["NextPageText"]=value;}
494 }
495
496 /// <summary>
497 /// 获取或设置为最后一页按钮显示的文本。
498 /// </summary>
499 [Browsable(true),
500 Description("最后一页按钮上显示的文本"),
501 Category("导航按钮"),
502 DefaultValue("<font face=\"webdings\">:</font>")]
503 public string LastPageText
504 {
505 get
506 {
507 object obj=ViewState["LastPageText"];
508 return (obj==null)?"<font face=\"webdings\">:</font>":(string)obj;
509 }
510 set{ViewState["LastPageText"]=value;}
511 }
512
513 /// <summary>
514 /// 获取或设置在 <see cref="AspNetPager"/> 控件的页导航元素中同时显示的数值按钮的数目。
515 /// </summary>
516 [Browsable(true),
517 Description("要显示的页索引数值按钮的数目"),
518 Category("导航按钮"),
519 DefaultValue(10)]
520 public int NumericButtonCount
521 {
522 get
523 {
524 object obj=ViewState["NumericButtonCount"];
525 return (obj==null)?10:(int)obj;
526 }
527 set{ViewState["NumericButtonCount"]=value;}
528 }
529
530 /// <summary>
531 /// 获取或设置一个值,该值指定是否显示已禁用的按钮。
532 /// </summary>
533 /// <remarks>
534 /// 该值用来指定是否显示已禁用的分页导航按钮,当当前页为第一页时,第一页和上一页按钮将被禁用,当当前页为最后一页时,下一页和最后一页按钮将被禁用,被禁用的按钮没有链接,在按钮上点击也不会有任何作用。
535 /// </remarks>
536 [Browsable(true),
537 Category("导航按钮"),
538 Description("是否显示已禁用的按钮"),
539 DefaultValue(true)]
540 public bool ShowDisabledButtons
541 {
542 get
543 {
544 object obj=ViewState["ShowDisabledButtons"];
545 return (obj==null)?true:(bool)obj;
546 }
547 set
548 {
549 ViewState["ShowDisabledButtons"]=value;
550 }
551 }
552
553 #endregion
554
555 #region Image Buttons
556
557 /// <summary>
558 /// 获取或设置当使用图片按钮时,图片文件的路径。
559 /// </summary>
560 [Browsable(true),
561 Category("图片按钮"),
562 Description("当使用图片按钮时,指定图片文件的路径"),
563 DefaultValue(null)]
564 public string ImagePath
565 {
566 get
567 {
568 string imgPath=(string)ViewState["ImagePath"];
569 if(imgPath!=null)
570 imgPath=this.ResolveUrl(imgPath);
571 return imgPath;
572 }
573 set
574 {
575 string imgPath=value.Trim().Replace("\\","/");
576 ViewState["ImagePath"]=(imgPath.EndsWith("/"))?imgPath:imgPath+"/";
577 }
578 }
579
580 /// <summary>
581 /// 获取或设置当使用图片按钮时,图片的类型,如gif或jpg,该值即图片文件的后缀名。
582 /// </summary>
583 [Browsable(true),
584 Category("图片按钮"),
585 DefaultValue(".gif"),
586 Description("当使用图片按钮时,图片的类型,如gif或jpg,该值即图片文件的后缀名")]
587 public string ButtonImageExtension
588 {
589 get
590 {
591 object obj=ViewState["ButtonImageExtension"];
592 return (obj==null)?".gif":(string)obj;
593 }
594 set
595 {
596 string ext=value.Trim();
597 ViewState["ButtonImageExtension"]=(ext.StartsWith("."))?ext:("."+ext);
598 }
599 }
600
601 /// <summary>
602 /// 获取或设置自定义图片文件名的后缀字符串,以区分不同类型的按钮图片。
603 /// </summary>
604 /// <remarks><note>注意:</note>该值不是文件后缀名,而是为区分不同的图片文件而在图片名中加入的字符串,如:
605 /// 当前有两套按钮图片,其中一套中的“1”的图片名可为“1f.gif”,另一套中的“1”的图片名可起为“1n.gif”,其中的f和n即为ButtonImageNameExtension。</remarks>
606 [Browsable(true),
607 DefaultValue(null),
608 Category("图片按钮"),
609 Description("自定义图片文件名的后缀字符串(非文件后缀名),如图片“1f.gif”的ButtonImageNameExtension即为“f”")]
610 public string ButtonImageNameExtension
611 {
612 get
613 {
614 return (string)ViewState["ButtonImageNameExtension"];
615 }
616 set
617 {
618 ViewState["ButtonImageNameExtension"]=value;
619 }
620 }
621
622 /// <summary>
623 /// 获取或设置当前页索引按钮的图片名后缀。
624 /// </summary>
625 /// <remarks>
626 /// 当 <see cref="PagingButtonType"/> 设为 Image 时,该属性允许您设置当前页索引数值按钮使用的图片名后缀字符,因此可以使当前页索引按钮与其它页索引按钮使用不同的图片,若未设置该值,则默认值为<see cref="ButtonImageNameExtension"/>,即当前页索引按钮与其它页索引按钮使用相同的图片。
627 /// </remarks>
628 [Browsable(true),
629 DefaultValue(null),
630 Category("图片按钮"),
631 Description("当前页索引按钮的图片名后缀字符串")]
632 public string CpiButtonImageNameExtension
633 {
634 get
635 {
636 object obj=ViewState["CpiButtonImageNameExtension"];
637 return (obj==null)?ButtonImageNameExtension:(string)obj;
638 }
639 set
640 {
641 ViewState["CpiButtonImageNameExtension"]=value;
642 }
643 }
644
645 /// <summary>
646 /// 获取或设置已禁用的页导航按钮图片名后缀字符串。
647 /// </summary>
648 /// <remarks>
649 /// 当 <see cref="PagingButtonType"/> 设为 Image 时, 该值允许您设置已禁用(即没有链接,因而点击后无反应)的页导航按钮(包括第一页、上一页、下一页、最后一页四个按钮)的图片文件名后缀字符串,因此可以使已禁用的页导航按钮不同于正常的页导航按钮。若未设置该值,则默认值为<see cref="ButtonImageNameExtension"/>,即已禁用的页导航按钮与正常的页导航按钮使用相同的图片。
650 /// </remarks>
651 [Browsable(true),
652 DefaultValue(null),
653 Category("图片按钮"),
654 Description("已禁用的页导航按钮的图片名后缀字符串")]
655 public string DisabledButtonImageNameExtension
656 {
657 get
658 {
659 object obj=ViewState["DisabledButtonImageNameExtension"];
660 return (obj==null)?ButtonImageNameExtension:(string)obj;
661 }
662 set
663 {
664 ViewState["DisabledButtonImageNameExtension"]=value;
665 }
666 }
667 /// <summary>
668 /// 指定当使用图片按钮时,图片的对齐方式。
669 /// </summary>
670
671 [Browsable(true),
672 Description("指定当使用图片按钮时,图片的对齐方式"),
673 DefaultValue(ImageAlign.Baseline),
674 Category("图片按钮")]
675 public ImageAlign ButtonImageAlign
676 {
677 get
678 {
679 object obj=ViewState["ButtonImageAlign"];
680 return (obj==null)?ImageAlign.Baseline:(ImageAlign)obj;
681 }
682 set{ViewState["ButtonImageAlign"]=value;}
683 }
684
685
686 #endregion
687
688 #region Paging
689
690 /// <summary>
691 /// 获取或设置是否启用url来传递分页信息。
692 /// </summary>
693 /// <remarks>
694 /// 启用Url分页方式是将用户欲访问的页索引通过Url来传递,由于该分页方式不使用页面向自身回发来传递数据,
695 /// 所以每次分页时所有的数据都恢复为初始值或需要重新获取。使用Url分页方式不支持动态改变分页控件的属性值,
696 /// 因暂时无法将新的属性值通过Url来传递给下一页。
697 /// </remarks>
698 /// <example>以下示例说明如何用AspNetPager的Url分页方式对DataGrid进行分页(使用Access数据库):
699 /// <code><![CDATA[
700 ///<%@Register TagPrefix="Webdiyer" Namespace="Wuqi.Webdiyer" Assembly="aspnetpager"%>
701 ///<%@Import Namespace="System.Data.OleDb"%>
702 ///<%@ Import Namespace="System.Data"%>
703 ///<%@ Page Language="C#" debug=true%>
704 ///<HTML>
705 /// <HEAD>
706 /// <TITLE>Welcome to Webdiyer.com </TITLE>
707 /// <script runat="server">
708 /// OleDbConnection conn;
709 /// OleDbCommand cmd;
710 /// void Page_Load(object src,EventArgs e){
711 /// conn=new OleDbConnection("Provider=Microsoft.Jet.OLEDB.4.0;Data Source="+Server.MapPath("access/aspnetpager.mdb"));
712 /// if(!Page.IsPostBack){
713 /// cmd=new OleDbCommand("select count(newsid) from wqnews",conn);
714 /// conn.Open();
715 /// pager.RecordCount=(int)cmd.ExecuteScalar();
716 /// conn.Close();
717 /// BindData();
718 /// }
719 /// }
720 ///
721 /// void BindData(){
722 /// cmd=new OleDbCommand("select newsid,heading,source,addtime from wqnews order by addtime desc",conn);
723 /// OleDbDataAdapter adapter=new OleDbDataAdapter(cmd);
724 /// DataSet ds=new DataSet();
725 /// adapter.Fill(ds,pager.PageSize*(pager.CurrentPageIndex-1),pager.PageSize,"news");
726 /// dg.DataSource=ds.Tables["news"];
727 /// dg.DataBind();
728 /// }
729 ///
730 /// void ChangePage(object src,PageChangedEventArgs e){
731 /// pager.CurrentPageIndex=e.NewPageIndex;
732 /// BindData();
733 /// }
734 ///
735 /// </script>
736 /// <meta http-equiv="Content-Language" content="zh-cn">
737 /// <meta http-equiv="content-type" content="text/html;charset=gb2312">
738 /// <META NAME="Generator" CONTENT="EditPlus">
739 /// <META NAME="Author" CONTENT="Webdiyer(yhaili@21cn.com)">
740 /// </HEAD>
741 /// <body>
742 /// <form runat="server" ID="Form1">
743 /// <h2 align="center">AspNetPager分页示例</h2>
744 /// <asp:DataGrid id="dg" runat="server"
745 /// Width="760" CellPadding="4" Align="center" />
746 ///
747 /// <Webdiyer:AspNetPager runat="server" id="pager"
748 /// OnPageChanged="ChangePage"
749 /// HorizontalAlign="center"
750 /// style="MARGIN-TOP:10px;FONT-SIZE:16px"
751 /// PageSize="8"
752 /// ShowInputBox="always"
753 /// SubmitButtonStyle="border:1px solid #000066;height:20px;width:30px"
754 /// InputBoxStyle="border:1px #0000FF solid;text-align:center"
755 /// SubmitButtonText="转到"
756 /// UrlPaging="true"
757 /// UrlPageIndexName="pageindex" />
758 /// </form>
759 /// </body>
760 ///</HTML>
761 /// ]]></code>
762 /// </example>
763 [Browsable(true),
764 Category("分页"),
765 DefaultValue(false),
766 Description("是否使用url传递分页信息的方式来分页")]
767 public bool UrlPaging
768 {
769 get
770 {
771 return urlPaging;
772 }
773 set
774 {
775 urlPaging=value;
776 }
777 }
778
779 /// <summary>
780 /// 获取或设置当启用Url分页方式时,在url中表示要传递的页索引的参数的名称。
781 /// </summary>
782 /// <remarks>
783 /// 该属性允许您自定义通过Url传递页索引时表示要传递的页索引的参数的名称,以避免与现有的参数名重复。
784 /// <p>该属性的默认值是“page”,即通过Url分页时,显示在浏览器地址栏中的Url类似于:</p>http://www.webdiyer.com/aspnetpager/samples/datagrid_url.aspx?page=2
785 /// <p>如将该值改为“pageindex”,则上面的Url将变为:</p><p>http://www.webdiyer.com/aspnetpager/samples/datagrid_url.aspx?pageindex=2 </p>
786 /// </remarks>
787 [Browsable(true),
788 DefaultValue("page"),
789 Category("分页"),
790 Description("当启用Url分页方式时,显示在url中表示要传递的页索引的参数的名称")]
791 public string UrlPageIndexName
792 {
793 get{return urlPageIndexName;}
794 set{urlPageIndexName=value;}
795 }
796
797 /// <summary>
798 /// 获取或设置当启用Url分页方式时,在url中表示要传递的页索引的参数的名称。
799 /// </summary>
800 /// <remarks>
801 /// 该属性允许您自定义通过Url传递页索引时表示要传递的页索引的参数的名称,以避免与现有的参数名重复。
802 /// <p>该属性的默认值是“page”,即通过Url分页时,显示在浏览器地址栏中的Url类似于:</p>http://www.webdiyer.com/aspnetpager/samples/datagrid_url.aspx?pagesize=20
803 /// <p>如将该值改为“pagesize1”,则上面的Url将变为:</p><p>http://www.webdiyer.com/aspnetpager/samples/datagrid_url.aspx?pagesize1=20 </p>
804 /// </remarks>
805 [Browsable(true),
806 DefaultValue("pagesize"),
807 Category("分页"),
808 Description("当启用Url分页方式时,显示在url中表示要传递的记录数的参数的名称")]
809 public string UrlPageSize
810 {
811 get{return urlPageSize;}
812 set{urlPageSize=value;}
813 }
814
815 /// <summary>
816 /// 获取或设置当前显示页的索引。
817 /// </summary>
818 ///<remarks>使用此属性来确定在 AspNetPager 控件中当前显示的页,当前显示的页的数字索引将以红色字体加粗显示。此属性还用于以编程的方式控制所显示的页。
819 ///<p> <b>注意:</b>不同于DataGrid控件的CurrentPageIndex,AspNetPager的CurrentPageIndex属性是从1开始的。</p></remarks>
820 [ReadOnly(true),
821 Browsable(false),
822 Description("当前显示页的索引"),
823 Category("分页"),
824 DefaultValue(1),
825 DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
826 public int CurrentPageIndex
827 {
828 get
829 {
830 object cpage=ViewState["CurrentPageIndex"];
831 int pindex=(cpage==null)?1:(int)cpage;
832 if(pindex>PageCount&&PageCount>0)
833 return PageCount;
834 else if(pindex<1)
835 return 1;
836 return pindex;
837 }
838 set
839 {
840 int cpage=value;
841 if(cpage<1)
842 cpage=1;
843 else if(cpage>this.PageCount)
844 cpage=this.PageCount;
845 ViewState["CurrentPageIndex"]=cpage;
846 }
847 }
848
849 /// <summary>
850 /// 获取或设置需要分页的所有记录的总数。
851 /// </summary>
852 /// <remarks>
853 /// 当页面第一次加载时,应以编程方式将从存储过程或Sql语句中返回的数据表中所有要分页的记录的总数赋予该属性,AspNetPager会将其保存的ViewState中并在页面回发时从ViewState中获取该值,因此避免了每次分页都要访问数据库而影响分页性能。AspNetPager根据要分页的所有数据的总项数和 <see cref="PageSize"/> 属性来计算显示所有数据需要的总页数,即 <see cref="PageCount"/>的值。
854 /// </remarks>
855 /// <example>
856 /// 下面的示例显示如何以编程方式将从Sql语句返回的记录总数赋给该属性:
857 /// <p>
858 /// <code><![CDATA[
859 /// <HTML>
860 /// <HEAD>
861 /// <TITLE>Welcome to Webdiyer.com </TITLE>
862 /// <script runat="server">
863 /// SqlConnection conn;
864 /// SqlCommand cmd;
865 /// void Page_Load(object src,EventArgs e)
866 /// {
867 /// conn=new SqlConnection(ConfigurationSettings.AppSettings["ConnStr"]);
868 /// if(!Page.IsPostBack)
869 /// {
870 /// cmd=new SqlCommand("select count(id) from news",conn);
871 /// conn.Open();
872 /// pager.RecordCount=(int)cmd.ExecuteScalar();
873 /// conn.Close();
874 /// BindData();
875 /// }
876 /// }
877 ///
878 /// void BindData()
879 /// {
880 /// cmd=new SqlCommand("GetPagedNews",conn);
881 /// cmd.CommandType=CommandType.StoredProcedure;
882 /// cmd.Parameters.Add("@pageindex",pager.CurrentPageIndex);
883 /// cmd.Parameters.Add("@pagesize",pager.PageSize);
884 /// conn.Open();
885 /// dataGrid1.DataSource=cmd.ExecuteReader();
886 /// dataGrid1.DataBind();
887 /// conn.Close();
888 /// }
889 /// void ChangePage(object src,PageChangedEventArgs e)
890 /// {
891 /// pager.CurrentPageIndex=e.NewPageIndex;
892 /// BindData();
893 /// }
894 /// </script>
895 /// <meta http-equiv="Content-Language" content="zh-cn">
896 /// <meta http-equiv="content-type" content="text/html;charset=gb2312">
897 /// <META NAME="Generator" CONTENT="EditPlus">
898 /// <META NAME="Author" CONTENT="Webdiyer(yhaili@21cn.com)">
899 /// </HEAD>
900 /// <body>
901 /// <form runat="server" ID="Form1">
902 /// <asp:DataGrid id="dataGrid1" runat="server" />
903 ///
904 /// <Webdiyer:AspNetPager id="pager" runat="server"
905 /// PageSize="8"
906 /// NumericButtonCount="8"
907 /// ShowCustomInfoSection="before"
908 /// ShowInputBox="always"
909 /// CssClass="mypager"
910 /// HorizontalAlign="center"
911 /// OnPageChanged="ChangePage" />
912 ///
913 /// </form>
914 /// </body>
915 ///</HTML>
916 /// ]]>
917 /// </code></p>
918 /// <p>本示例使用的存储过程代码如下:</p>
919 /// <code><![CDATA[
920 ///CREATE procedure GetPagedNews
921 /// (@pagesize int,
922 /// @pageindex int)
923 /// as
924 /// set nocount on
925 /// declare @indextable table(id int identity(1,1),nid int)
926 /// declare @PageLowerBound int
927 /// declare @PageUpperBound int
928 /// set @PageLowerBound=(@pageindex-1)*@pagesize
929 /// set @PageUpperBound=@PageLowerBound+@pagesize
930 /// set rowcount @PageUpperBound
931 /// insert into @indextable(nid) select id from news order by addtime desc
932 /// select O.id,O.title,O.source,O.addtime from news O,@indextable t where O.id=t.nid
933 /// and t.id>@PageLowerBound and t.id<=@PageUpperBound order by t.id
934 /// set nocount off
935 ///GO
936 /// ]]>
937 /// </code>
938 /// </example>
939 [Browsable(false),
940 Description("要分页的所有记录的总数,该值须在程序运行时设置,默认值为225是为设计时支持而设置的参照值。"),
941 Category("Data"),
942 DefaultValue(225)]
943 public int RecordCount
944 {
945 get
946 {
947 object obj=ViewState["Recordcount"];
948 return (obj==null)?0:(int)obj;
949 }
950 set{ViewState["Recordcount"]=value;}
951 }
952
953 /// <summary>
954 /// 获取当前页之后未显示的页的总数。
955 /// </summary>
956 [Browsable(false),
957 DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
958 public int PagesRemain
959 {
960 get
961 {
962 return PageCount-CurrentPageIndex;
963 }
964 }
965
966 /// <summary>
967 /// 获取或设置每页显示的项数。
968 /// </summary>
969 /// <remarks>
970 /// 该值获取或设置数据呈现控件每次要显示数据表中的的数据的项数,AspNetPager根据该值和 <see cref="RecordCount"/> 来计算显示所有数据需要的总页数,即 <see cref="PageCount"/>的值。</remarks>
971 /// <example>以下示例将 <see cref="AspNetPager"/> 设置为允许每页显示8条数据:
972 /// <code>
973 /// <![CDATA[
974 ///
975 /// <Webdiyer:AspNetPager id="pager" runat="server" PageSize=8 OnPageChanged="ChangePage"/>
976 ///
977 /// ]]></code></example>
978 [Browsable(true),
979 Description("每页显示的记录数"),
980 Category("分页"),
981 DefaultValue(10)]
982 public int PageSize
983 {
984 get
985 {
986 object obj=ViewState["PageSize"];
987 return (obj==null)?10:(int)obj;
988 }
989 set
990 {
991 ViewState["PageSize"]=value;
992 }
993 }
994
995 /// <summary>
996 /// 获取在当前页之后还未显示的剩余记录的项数。
997 /// </summary>
998 [Browsable(false),
999 DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
1000 public int RecordsRemain
1001 {
1002 get
1003 {
1004 if(CurrentPageIndex<PageCount)
1005 return RecordCount-(CurrentPageIndex*PageSize);
1006 return 0;}
1007 }
1008
1009
1010 /// <summary>
1011 /// 获取所有要分页的记录需要的总页数。
1012 /// </summary>
1013 [Browsable(false),
1014 DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
1015 public int PageCount
1016 {
1017 get{return (int)Math.Ceiling((double)RecordCount/(double)PageSize);}
1018 }
1019
1020
1021 #endregion
1022
1023 #region TextBox and Submit Button
1024
1025 /// <summary>
1026 /// 获取或设置页索引文本框的显示方式。
1027 /// </summary>
1028 /// <remarks>
1029 /// 页索引文件框允许用户手式输入要访问的页的索引,当页数非常多时,显示页索引文本框非常方便用户跳转到指定的页,默认情况下,该文本框只有在总页数大于或等于 <see cref="ShowBoxThreshold"/> 的值时才显示,否则不显示,要想该文本框任何时候都显示,请将其值设为Always,若希望任何时候都不显示,则应设为Never。
1030 ///</remarks>
1031 [Browsable(true),
1032 Description("指定页索引文本框的显示方式"),
1033 Category("文本框及提交按钮"),
1034 DefaultValue(ShowInputBox.Auto)]
1035 public ShowInputBox ShowInputBox
1036 {
1037 get
1038 {
1039 object obj=ViewState["ShowInputBox"];
1040 return (obj==null)?ShowInputBox.Auto:(ShowInputBox)obj;
1041 }
1042 set{ViewState["ShowInputBox"]=value;}
1043 }
1044
1045 /// <summary>
1046 /// 获取或设置应用于页索引输入文本框的CSS类名。
1047 /// </summary>
1048 [Browsable(true),
1049 Category("文本框及提交按钮"),
1050 DefaultValue(null),
1051 Description("应用于页索引输入文本框的CSS类名")]
1052 public string InputBoxClass
1053 {
1054 get
1055 {
1056 return (string)ViewState["InputBoxClass"];
1057 }
1058 set
1059 {
1060 if(value.Trim().Length>0)
1061 ViewState["InputBoxClass"]=value;
1062 }
1063 }
1064
1065 /// <summary>
1066 /// 获取或设置页索引输入文本框的CSS样式文本。
1067 /// </summary>
1068
1069 [Browsable(true),
1070 Category("文本框及提交按钮"),
1071 DefaultValue(null),
1072 Description("应用于页索引输入文本框的CSS样式文本")]
1073 public string InputBoxStyle
1074 {
1075 get
1076 {
1077 return (string)ViewState["InputBoxStyle"];
1078 }
1079 set
1080 {
1081 if(value.Trim().Length>0)
1082 ViewState["InputBoxStyle"]=value;
1083 }
1084 }
1085
1086 /// <summary>
1087 /// 获取或设置页索引页索引输入文本框前的文本字符串值。
1088 /// </summary>
1089 [Browsable(true),
1090 Category("文本框及提交按钮"),
1091 DefaultValue(null),
1092 Description("页索引输入文本框前的文本内容字符串")]
1093 public string TextBeforeInputBox
1094 {
1095 get
1096 {
1097 return (string)ViewState["TextBeforeInputBox"];
1098 }
1099 set
1100 {
1101 ViewState["TextBeforeInputBox"]=value;
1102 }
1103 }
1104
1105 /// <summary>
1106 /// 获取或设置页索引文本输入框后的文本内容字符串值。
1107 /// </summary>
1108 [Browsable(true),
1109 DefaultValue(null),
1110 Category("文本框及提交按钮"),
1111 Description("页索引输入文本框后的文本内容字符串")]
1112 public string TextAfterInputBox
1113 {
1114 get
1115 {
1116 return (string)ViewState["TextAfterInputBox"];
1117 }
1118 set
1119 {
1120 ViewState["TextAfterInputBox"]=value;
1121 }
1122 }
1123
1124
1125 /// <summary>
1126 /// 获取或设置提交按钮上的文本。
1127 /// </summary>
1128 [Browsable(true),
1129 Category("文本框及提交按钮"),
1130 DefaultValue("go"),
1131 Description("提交按钮上的文本")]
1132 public string SubmitButtonText
1133 {
1134 get
1135 {
1136 object obj=ViewState["SubmitButtonText"];
1137 return (obj==null)?"go":(string)obj;
1138 }
1139 set
1140 {
1141 if(value.Trim().Length>0)
1142 ViewState["SubmitButtonText"]=value;
1143 }
1144 }
1145 /// <summary>
1146 /// 获取或设置应用于提交按钮的CSS类名。
1147 /// </summary>
1148 [Browsable(true),
1149 Category("文本框及提交按钮"),
1150 DefaultValue(null),
1151 Description("应用于提交按钮的CSS类名")]
1152 public string SubmitButtonClass
1153 {
1154 get
1155 {
1156 return (string)ViewState["SubmitButtonClass"];
1157 }
1158 set
1159 {
1160 ViewState["SubmitButtonClass"]=value;
1161 }
1162 }
1163
1164 /// <summary>
1165 /// 获取或设置应用于提交按钮的CSS样式。
1166 /// </summary>
1167 [Browsable(true),
1168 Category("文本框及提交按钮"),
1169 DefaultValue(null),
1170 Description("应用于提交按钮的CSS样式")]
1171 public string SubmitButtonStyle
1172 {
1173 get
1174 {
1175 return (string)ViewState["SubmitButtonStyle"];
1176 }
1177 set
1178 {
1179 ViewState["SubmitButtonStyle"]=value;
1180 }
1181 }
1182 /// <summary>
1183 /// 获取或设置自动显示页索引输入文本框的最低起始页数。
1184 /// </summary>
1185 /// <remarks>
1186 /// 当 <see cref="ShowInputBox"/> 设为Auto(默认)并且要分页的数据的总页数达到该值时会自动显示页索引输入文本框,默认值为30。该选项当 <see cref="ShowInputBox"/> 设为Never或Always时没有任何作用。
1187 /// </remarks>
1188 [Browsable(true),
1189 Description("指定当ShowInputBox设为ShowInputBox.Auto时,当总页数达到多少时才显示页索引输入文本框"),
1190 Category("文本框及提交按钮"),
1191 DefaultValue(30)]
1192 public int ShowBoxThreshold
1193 {
1194 get
1195 {
1196 object obj=ViewState["ShowBoxThreshold"];
1197 return (obj==null)?30:(int)obj;
1198 }
1199 set{ViewState["ShowBoxThreshold"]=value;}
1200 }
1201
1202
1203 #endregion
1204
1205 #region SelectBox and Submit Button
1206
1207 /// <summary>
1208 /// 获取或设置页索引文本框的显示方式。
1209 /// </summary>
1210 /// <remarks>
1211 /// 页索引文件框允许用户手式输入要访问的页的索引,当页数非常多时,显示页索引文本框非常方便用户跳转到指定的页,默认情况下,该文本框只有在总页数大于或等于 <see cref="ShowBoxThreshold"/> 的值时才显示,否则不显示,要想该文本框任何时候都显示,请将其值设为Always,若希望任何时候都不显示,则应设为Never。
1212 ///</remarks>
1213 [Browsable(true),
1214 Description("指定页索引文本框的显示方式"),
1215 Category("分页记录数选择"),
1216 DefaultValue(ShowInputBox.Auto)]
1217 public ShowInputBox ShowSelectBox
1218 {
1219 get
1220 {
1221 object obj=ViewState["ShowSelectBox"];
1222 return (obj==null)?ShowInputBox.Auto:(ShowInputBox)obj;
1223 }
1224 set{ViewState["ShowSelectBox"]=value;}
1225 }
1226
1227 /// <summary>
1228 /// 获取或设置应用于页索引输入文本框的CSS类名。
1229 /// </summary>
1230 [Browsable(true),
1231 Category("分页记录数选择"),
1232 DefaultValue(null),
1233 Description("应用于页索引输入文本框的CSS类名")]
1234 public string SelectBoxClass
1235 {
1236 get
1237 {
1238 return (string)ViewState["SelectBoxClass"];
1239 }
1240 set
1241 {
1242 if(value.Trim().Length>0)
1243 ViewState["SelectBoxClass"]=value;
1244 }
1245 }
1246
1247 /// <summary>
1248 /// 获取或设置页索引输入文本框的CSS样式文本。
1249 /// </summary>
1250
1251 [Browsable(true),
1252 Category("分页记录数选择"),
1253 DefaultValue(null),
1254 Description("应用于页索引输入文本框的CSS样式文本")]
1255 public string SelectBoxStyle
1256 {
1257 get
1258 {
1259 return (string)ViewState["SelectBoxStyle"];
1260 }
1261 set
1262 {
1263 if(value.Trim().Length>0)
1264 ViewState["SelectBoxStyle"]=value;
1265 }
1266 }
1267
1268 /// <summary>
1269 /// 获取或设置页索引页索引输入文本框前的文本字符串值。
1270 /// </summary>
1271 [Browsable(true),
1272 Category("分页记录数选择"),
1273 DefaultValue("每页"),
1274 Description("页索引输入文本框前的文本内容字符串")]
1275 public string TextBeforeSelectBox
1276 {
1277 get
1278 {
1279 return (string)ViewState["TextBeforeSelectBox"];
1280 }
1281 set
1282 {
1283 ViewState["TextBeforeSelectBox"]=value;
1284 }
1285 }
1286
1287 /// <summary>
1288 /// 获取或设置页索引文本输入框后的文本内容字符串值。
1289 /// </summary>
1290 [Browsable(true),
1291 DefaultValue("条"),
1292 Category("分页记录数选择"),
1293 Description("页索引输入文本框后的文本内容字符串")]
1294 public string TextAfterSelectBox
1295 {
1296 get
1297 {
1298 return (string)ViewState["TextAfterSelectBox"];
1299 }
1300 set
1301 {
1302 ViewState["TextAfterSelectBox"]=value;
1303 }
1304 }
1305
1306
1307 /// <summary>
1308 /// 获取或设置提交按钮上的文本。
1309 /// </summary>
1310 [Browsable(true),
1311 Category("分页记录数选择"),
1312 DefaultValue("设置"),
1313 Description("提交按钮上的文本")]
1314 public string SubmitButtonSelectText
1315 {
1316 get
1317 {
1318 object obj=ViewState["SubmitButtonSelectText"];
1319 return (obj==null)?"设置":(string)obj;
1320 }
1321 set
1322 {
1323 if(value.Trim().Length>0)
1324 ViewState["SubmitButtonSelectText"]=value;
1325 }
1326 }
1327 /// <summary>
1328 /// 获取或设置自动显示页索引输入文本框的最低起始页数。
1329 /// </summary>
1330 /// <remarks>
1331 /// 当 <see cref="ShowInputBox"/> 设为Auto(默认)并且要分页的数据的总页数达到该值时会自动显示页索引输入文本框,默认值为30。该选项当 <see cref="ShowInputBox"/> 设为Never或Always时没有任何作用。
1332 /// </remarks>
1333 [Browsable(true),
1334 Description("指定当ShowInputBox设为ShowInputBox.Auto时,当总页数达到多少时才显示页索引输入文本框"),
1335 Category("分页记录数选择"),
1336 DefaultValue(30)]
1337 public int ShowSelectBoxThreshold
1338 {
1339 get
1340 {
1341 object obj=ViewState["ShowSelectBoxThreshold"];
1342 return (obj==null)?30:(int)obj;
1343 }
1344 set{ViewState["ShowSelectBoxThreshold"]=value;}
1345 }
1346
1347
1348 #endregion
1349
1350 #region CustomInfoSection
1351
1352 /// <summary>
1353 /// 获取或设置显示用户自定义信息区的方式。
1354 /// </summary>
1355 /// <remarks>
1356 /// 该属性值设为Left或Right时会在分页导航元素左边或右边划出一个专门的区域来显示有关用户自定义信息,设为Never时不显示。
1357 /// </remarks>
1358 [Browsable(true),
1359 Description("显示当前页和总页数信息,默认值为不显示,值为ShowCustomInfoSection.Left时将显示在页索引前,为ShowCustomInfoSection.Right时将显示在页索引后"),
1360 DefaultValue(ShowCustomInfoSection.Never),
1361 Category("自定义信息区")]
1362 public ShowCustomInfoSection ShowCustomInfoSection
1363 {
1364 get
1365 {
1366 object obj=ViewState["ShowCustomInfoSection"];
1367 return (obj==null)?ShowCustomInfoSection.Never:(ShowCustomInfoSection)obj;
1368 }
1369 set{ViewState["ShowCustomInfoSection"]=value;}
1370 }
1371
1372 /// <summary>
1373 /// 获取或设置用户自定义信息区文本的对齐方式。
1374 /// </summary>
1375 [Browsable(true),
1376 Category("自定义信息区"),
1377 DefaultValue(HorizontalAlign.Left),
1378 Description("用户自定义信息区文本的对齐方式")]
1379 public HorizontalAlign CustomInfoTextAlign
1380 {
1381 get
1382 {
1383 object obj=ViewState["CustomInfoTextAlign"];
1384 return (obj==null)?HorizontalAlign.Left:(HorizontalAlign)obj;
1385 }
1386 set
1387 {
1388 ViewState["CustomInfoTextAlign"]=value;
1389 }
1390 }
1391
1392 /// <summary>
1393 /// 获取或设置用户自定义信息区的宽度。
1394 /// </summary>
1395 [Browsable(true),
1396 Category("自定义信息区"),
1397 DefaultValue(typeof(Unit),"40%"),
1398 Description("用户自定义信息区的宽度")]
1399 public Unit CustomInfoSectionWidth
1400 {
1401 get
1402 {
1403 object obj=ViewState["CustomInfoSectionWidth"];
1404 return (obj==null)?Unit.Percentage(40):(Unit)obj;
1405 }
1406 set
1407 {
1408 ViewState["CustomInfoSectionWidth"]=value;
1409 }
1410 }
1411
1523 [Browsable(false),
2601
2608 /// 使用文字按钮。