ControlPrefix プロパティ (SmartWebControl)

このインスタンスをコントロールタイプによって一意に修飾する短い接頭辞を 取得します。

シンタックス

Visual Basic

'宣言
 
Protected Overridable ReadOnly Property ControlPrefix As String

C#

protected virtual string ControlPrefix {get;}

プロパティ値

デフォルトでは、ControlPrefix の基本実装は常に空の文字列を返します。

解説

この接頭辞は、CSS クラスと他の識別ラベルの前位置に描画され、特定のコントロール タイプに対して一意であることを保証します。この接頭辞を適用するタイミングは、Init イベントの発生より前に設定できます。そのため、コントロールのインスタンスを差別化するために使用できません。

継承者は、このプロパティをオーバーライドし、コントロールの Type を一意に識別する短い非 null 文字列を提供する必要があります。ControlPrefix をオーバーライドできないと、一部の CSS クラスは異なるコントロールタイプ間で名前の衝突を引き起こす場合があります。たとえば、WebMonthView と WebDayView が同じページ上にある場合、これらが ControlPrefix をオーバーライドしないかぎり、2 つの DayStyle のCSSクラス (デフォルト CSS クラス名が Day である場合) 間で名前の衝突が生じる可能性があります。WebMonthView が オーバーライドから「month」接頭辞を返すと、その DayStyle は CSSクラス名 monthDay で描画し、ページ上の異なるタイプを持つ他のコントロールともはや衝突しなくなります。