AjaxToolKit之Rating控件怎么用

發(fā)布時間：2021-08-27 14:15:01 來源：億速云閱讀：151 作者：小新欄目：web開發(fā)

這篇文章主要為大家展示了“AjaxToolKit之Rating控件怎么用”，內(nèi)容簡而易懂，條理清晰，希望能夠幫助大家解決疑惑，下面讓小編帶領(lǐng)大家一起研究并學習一下“AjaxToolKit之Rating控件怎么用”這篇文章吧。

AjaxToolKit中的Rating控件是微軟Ajax控件庫中專門用來處理網(wǎng)頁評分（或投票）功能的控件，它本身支持網(wǎng)頁無刷新功能，在使用的時候完全沒有必要將它放在UpdatePanel控件里，而只需要將它的AutoPostBack屬性設(shè)為False即可。該控件使用起來非常簡單，而且還可以設(shè)置各種不同的效果，以及自定義函數(shù)回調(diào)等。下面是使用時候的一個截圖

先說一下常用屬性的功能：
ID：這個自然不用說了，大家都明白，所有的控件都會有一個服務(wù)器端的ID。
BehaviorID：通過Ajax客戶端獲取控件對象時所要使用的ID，這個在設(shè)置回調(diào)函數(shù)時通過$Find方法進行查找。
MaxRating：控件當前最大值。該值在UI上直接反映了“星形”圖標的個數(shù)。
CurrentRating：當前值，即控件當前所顯示的值。該值在UI上直接反映了被點亮的“星形”圖標的數(shù)量。注意該值的范圍在0-MaxRating之間（包括0和MaxRating）。
runat：注冊控件為服務(wù)器端行為，必須設(shè)置該值。
StarCssClass：“星形”圖標的樣式。必須指定。
WaitingStarCssClass：當處理客戶端響應(yīng)時，控件與服務(wù)器進行交互期間處于等待狀態(tài)時“星形”圖標的樣式。必須指定。
FilledStarCssClass：當“星形”圖標被點亮時的樣式。必須指定。
EmptyStarCssClass：當“星形”圖標未被點亮時的樣式。必須指定。
CssClass：Rating控件的整體樣式。需要時指定。
OnChanged：用于處理用戶點擊“星形”圖標后的響應(yīng)事件。該事件在服務(wù)器端處理。
AutoPostBack：設(shè)置控件是否自動回傳。一般情況下設(shè)置該值為False。
ReadOnly：控件的只讀狀態(tài)，處于只讀狀態(tài)下的Rating不能被用戶點擊，可以為只讀狀態(tài)的Rating設(shè)置單獨的樣式。
下面來看看如何使用。
準備工作：
1. 確保工程中正確引用了AjaxControlToolkit.dll程序集。該程序集在Visual Studio2005中為beta版本，需要自己去微軟的官方網(wǎng)站下載安裝包，Visual Studio2008中已經(jīng)隨IDE自動安裝了，可以直接使用。
2. 在Visual Studio2008中，該控件沒有被自動添加到工具箱中，需要手動添加到工具箱，然后拖放到頁面上。你可以在Visual Studio中打開工具箱浮動面板，選擇一個空白的Tab（如General Tab），點擊右鍵，選擇“選擇項…”，在彈出的對話框中找到AjaxControlToolkit程序集中相應(yīng)的控件，如下圖。

AjaxToolKit之Rating控件怎么用

3. 注意，如果你在上述對話框中沒有找到有關(guān)AjaxControlToolkit的控件，則需要自己指定AjaxControlToolkit.dll程序集的路徑。讀者如果沒有找到該文件的話這里方便給大家提供一個下載。
AjaxControlToolkit.dll
4. 添加好控件后，在工具箱中就可以像標準的ASP.NET控件一樣使用Rating控件了。

AjaxToolKit之Rating控件怎么用

準備工作做好之后，在工程中新建一個Web頁面，將控件放到頁面上，注意所有的Ajax控件都需要ScriptManager控件的支持，該控件負責在客戶端注冊必要的腳本。所以在添加Rating控件之前，先確保頁面上有且僅有一個ScriptManager控件。下面是aspx文件的代碼示例。

<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="WebForm1.aspx.cs" Inherits="iFrameUpload.WebForm1" %> 

<%@ Register Assembly="AjaxControlToolkit, Version=3.0.20820.0, Culture=neutral, PublicKeyToken=28f01b0e84b6d53e" 
 Namespace="AjaxControlToolkit" TagPrefix="ajaxToolkit" %> 
<!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 runat="server"> 
 <title>Untitled Page</title> 
 <link href="css/style.css" rel="stylesheet" type="text/css" /> 
</head> 
<body> 
 <form id="form1" runat="server"> 
 <div> 
 <asp:ScriptManager ID="ScriptManager1" runat="server"> 
 </asp:ScriptManager> 
 <ajaxToolkit:Rating ID="RatingRate" BehaviorID="RatingRate1" MaxRating="5" CurrentRating="3" 
  runat="server" StarCssClass="ratingStar" WaitingStarCssClass="waitingRatingStar" 
  FilledStarCssClass="filledRatingStar" EmptyStarCssClass="emptyRatingStar" 
  OnChanged="RatingRate_Changed" AutoPostBack="false"> 
 </ajaxToolkit:Rating> 

 <script type="text/javascript"> 
   Sys.Application.add_load( 
   function() { 
    $find("RatingRate1").add_EndClientCallback( 
    function(sender, e) { 
     var result = e.get_CallbackResult(); 
     alert(result); 
    } 
    ); 
   } 
   ); 
 </script> 

 </div> 
 </form> 
</body> 
</html>

Rating控件的相關(guān)屬性和事件都已經(jīng)添加了，這里說一下腳本的含義。通過Sys.Application.add_load方法在頁面全部加載完成后給Rating控件注冊一個回調(diào)方法，通過$find(“RatingRate1”).add_EndClientCallback方法進行注冊，用于接收服務(wù)端傳遞回來的值。這些腳本都是標準的Ajax框架提供的，這里就不做太多解釋了，讀者可以去查閱微軟的MSDN，上面有很詳細的介紹。

接下來是cs文件的代碼。

protected void RatingRate_Changed(object sender, AjaxControlToolkit.RatingEventArgs e) 
{ 
 System.Threading.Thread.Sleep(300); 
 //TODO: Save e.Value to database. 
 e.CallbackResult = "success"; 
}

很簡單，首先讓線程停止300ms，這樣我們可以有時間看到處于等待狀態(tài)的Rating控件的樣式。然后可以去處理數(shù)據(jù)保存（例如將Rating的當前值保存到數(shù)據(jù)庫等），注意用戶所選的值是通過e.Value屬性得到的，該屬性為字符串類型。然后通過e.CallbackResult屬性傳遞一個回調(diào)值到客戶端，客戶端得到該值后進行相應(yīng)的處理。

下面順便給出css樣式和示例圖片下載，讀者可以自己去嘗試一下！注意Rating的當前值是不能被用戶點擊的，如初始化時Rating的CurrentRating值為3，則用戶點擊第三個“星形”圖標則不會觸發(fā)點擊事件，另外就是Rating可以被用戶反復點擊，你可以在服務(wù)端進行處理，如當用戶點擊之后將控件設(shè)為只讀狀態(tài)等。

.ratingStar 
{ 
 font-size: 0pt; 
 width: 13px; 
 height: 12px; 
 margin: 0px; 
 padding: 0px; 
 cursor: pointer; 
 display: block; 
 background-repeat: no-repeat; 
} 

.waitingRatingStar /*normal mode empty style*/ 
{ 
 background-image: url(Rating_default.gif); 
} 

.filledRatingStar /*normal mode filled style*/ 
{ 
 background-image: url(Rating_normal.gif); 
} 

.emptyRatingStar /*readonly mode empty style*/ 
{ 
 background-image: url(Rating_empty.gif); 
}

以下是運行時的效果：

AjaxToolKit之Rating控件怎么用

以上是“AjaxToolKit之Rating控件怎么用”這篇文章的所有內(nèi)容，感謝各位的閱讀！相信大家都有了一定的了解，希望分享的內(nèi)容對大家有所幫助，如果還想學習更多知識，歡迎關(guān)注億速云行業(yè)資訊頻道！

向AI問一下細節(jié)

AjaxToolKit之Rating控件怎么用

猜你喜歡

最新資訊

相關(guān)推薦

相關(guān)標簽