Web サーバー コントロールの基本プロパティ

WebControl クラスから派生したすべての Web サーバー コントロールに適用されるプロパティを次の表に一覧表示します。WebControl クラスから継承されない Web サーバー コントロールには、LiteralPlaceHolderRepeater、および Xml が含まれます。

プロパティ

AccessKey

コントロールのキーボード ショートカット キー (AccessKey) を指定します。このプロパティは、Alt キーを押しながら押す単一文字または数字を指定します。たとえば、Alt キーを押しながら K キーを押すとコントロールにアクセスできるようにする場合は、"K" を指定します。ショートカット キーがサポートされているのは、Microsoft Internet Explorer 4.0 以降だけです。

Attributes

パブリック プロパティでは定義されていないが出力する必要のある、コントロールの追加属性のコレクションを指定します。Web サーバー コントロールで定義されていないすべての属性が、このコレクションに追加されます。これによって、コントロールでは直接サポートされていない HTML 属性を使用できます。

注意

このプロパティは、プログラミング時にだけ使用します。コントロールの宣言時に設定することはできません。

BackColor

コントロールの背景色を指定します。BackColor プロパティは、標準の HTML 色識別子を使用して設定できます。色の名前 ("black" や "red") または 16 進数形式で表される RGB 値 ("#ffffff") で指定できます。

BorderColor

コントロールの境界の色を指定します。BorderColor プロパティは、標準の HTML 色識別子を使用して設定できます。色の名前 ("black" や "red") または 16 進数形式で表される RGB 値 ("#ffffff") で指定できます。

BorderWidth

コントロールの境界線の幅をピクセル単位で指定します (境界線がある場合)。

注意

このプロパティは、Internet Explorer 4.0 より前のブラウザでは、すべてのコントロールに対して無効になる可能性があります。

BorderStyle

コントロールの境界線のスタイルを指定します (境界線がある場合)。次の値を指定できます。

  • NotSet

  • None

  • Dotted

  • Dashed

  • Solid

  • Double

  • Groove

  • Ridge

  • Inset

  • Outset

CssClass

コントロールに割り当てるカスケード スタイル シート (CSS: Cascading Style Sheets) クラスを指定します。

Style

コントロールの外部タグに CSS スタイル属性として出力するテキスト属性のコレクションを指定します。

注意

BackColor などのスタイル プロパティで設定されたスタイル値によって、このコレクションの対応する値は自動的にオーバーライドされます。このプロパティで設定した値は、厳密に型指定されたスタイル プロパティに対して自動的には反映されません。

一部のコントロールは、スタイル プロパティをコントロールの個別の要素に適用できるスタイル オブジェクトをサポートしています。これらのプロパティによって、Style プロパティで設定した値はオーバーライドされます。

Enabled

このプロパティが true (既定値) に設定されている場合は、コントロールが有効になります。false に設定されていると、コントロールは無効になります。

注意

コントロールを無効にすると、コントロールは淡色表示され、アクティブでなくなります。コントロールは非表示にはなりません。

EnableTheming

このプロパティが true (既定値) に設定されている場合は、コントロールのビュー状態の永続性が有効になります。このプロパティが false に設定されている場合は、このコントロールのビュー状態の永続性が無効になります。

EnableViewState

このプロパティが true (既定値) に設定されている場合は、コントロールのテーマが有効になります。false に設定されていると、このコントロールのテーマは無効になります。

Font

宣言している Web サーバー コントロールのフォント情報を指定します。このプロパティには、Web サーバー コントロール要素の開始タグのプロパティ サブプロパティ構文を使用して宣言できるサブプロパティが含まれます。たとえば、Web サーバー コントロールのテキストを太字にするには、Font-Bold 属性を開始タグに含めます。

ForeColor

コントロールの前景色を指定します。

注意

このプロパティは、Internet Explorer 4.0 より前のブラウザでは、すべてのコントロールに対して無効になる可能性があります。

Height

コントロールの高さを指定します。

注意

このプロパティは、Internet Explorer 4.0 より前のブラウザでは、すべてのコントロールに対して無効になる可能性があります。

SkinID

コントロールに適用するスキン。

TabIndex

コントロールのタブ オーダー位置を指定します。このプロパティが設定されていない場合、コントロールの位置インデックスは 0 になります。同じタブ インデックスを持つコントロールについては、Web ページ上で宣言された順序に従ってタブ移動します。

注意

このプロパティは、Internet Explorer 4.0 以降でだけ機能します。

ToolTip

ユーザーがマウス ポインタをコントロールの上に置いたときに表示されるテキストを指定します。

注意

ToolTip プロパティが機能しないブラウザもあります。互換性については、ブラウザで確認してください。

Width

コントロールの固定幅を指定します。次の単位を指定できます。

  • Pixel

  • Point

  • Pica

  • Inch

  • Mm

  • Cm

  • Percentage

  • Em

  • Ex

    注意

    既定の単位はピクセル (Pixel) です。ブラウザによっては、サポートされない単位もあります。

参照

関連項目

System.Web.UI.WebControls

その他の技術情報

Web サーバー コントロール構文