WebRating™ コントロールによって、エンドユーザーに評価画像を表示して、画像をクリックした時にエンドユーザーの入力を記録することができます。このコントロールは、それぞれ Average プロパティと VoteCount プロパティでユーザーの平均評価と投票数を保存します。評価および対応する投票数は、コントロール ポストバック時に限って記録されます。
AutoPostBackFlags . Rated プロパティを設定することによって、フルページまたは非同期ポストバックを有効にできます。このプロパティが Async または On に設定されている場合、ユーザーが評価画像をクリックするとコントロールはポストバックします。
注： Average および VoteCount プロパティは、現在のユーザーの平均および投票数を保存するだけです。この情報を表示したい場合、すべてのユーザーの平均および投票数を決定する必要があります。
WebRating コントロールの平均値は、各評価項目ごとに指定された値によって決定されます。これは、 WebRatingImageCollection コレクションで各 RatingImageItem オブジェクトごとに Value プロパティを設定することによって決定されます。平均値はクリックされた画像およびクリック数に基づいて計算されます。
評価値の設定についての詳細は、 「WebRating 項目の追加」を参照してください。
WebRating コントロールは、ユーザーが最後にクリックした評価値を選択します。この選択は、その値に至るまで評価画像を塗りつぶす色でスタイルされます。
この選択は、 EnableContinuousSelection プロパティによって制御されます。この値はデフォルトで True になっており、選択した値に先行するすべての項目で選択したスタイルを描画します。このプロパティを False に設定して、選択した項目だけに対して選択したスタイルを描画できます。
この選択した評価値は、 Precision プロパティによって制御されます。このプロパティは、Exact、Half、および Whole の 3 つの RatingPrecision 列挙値を取得します。Exact 値によって、エンドユーザーはクリックしたポイントで正確に値を選択できます。Half 値は次の半値に丸め、Whole 値は次の全体値に丸めます。
注： Half または Whole RatingPrecision 値で、コードに Value プロパティを設定することによって、正確な値を設定できます。
WebRating には EnableShowSelectionOnHover と呼ばれるプロパティもあります。これは、マウス オーバーに基づいて選択された評価項目の表示を制御します。このプロパティはデフォルトでは True で、他の値にマウスを重ねると、選択した値を表示します。False に設定すると、マウスが重ねられた場合だけ値を表示します。
WebRating コントロールによって、評価項目として独自の画像を指定したり、コントロールの異なる状態にカスタム スタイルを設定できます。デフォルトでは、このコントロールは星として評価画像を表示します。独自の CSS クラスを設定することによって、選択されたスタイルとホバーされたスタイルを変更できます。WebRating は、コントロールのルック アンド フィールをカスタマイズするために、さまざまな CSS プロパティを公開します。
カスタム スタイルについての詳細は、 「WebRating のスタイル」を参照してください。