Panel.DefaultButton プロパティ

定義

Panel コントロールに格納されている既定のボタンの識別子を取得または設定します。

public:
 virtual property System::String ^ DefaultButton { System::String ^ get(); void set(System::String ^ value); };
[System.Web.UI.Themeable(false)]
public virtual string DefaultButton { get; set; }
[<System.Web.UI.Themeable(false)>]
member this.DefaultButton : string with get, set
Public Overridable Property DefaultButton As String

プロパティ値

ID に格納されているボタン コントロールの Panel に対応する文字列値。 既定値は空の文字列です。Panel に既定のボタンがないことを示します。

属性

注釈

コントロールに DefaultButton フォーカスがあり、ユーザーが Enter キーを Panel 押したときにクリックされるボタンを示すには、 プロパティを使用します。 は DefaultButton 、コントロールの識別子 Button 、またはコントロールを除くインターフェイスを実装する任意の IButtonControl コントロールに LinkButton 設定できます。

DefaultButtonがインターフェイスを実装IButtonControlしていないコントロール、またはコントロールに含Panelまれていないコントロールに設定されている場合、Panelコントロールはレンダリング中に例外をスローします。

プロパティの DefaultButton 設定は、次のシナリオではサポートされていません。

  • パネルの入力コントロールの外側にフォーカスを設定し、Enter キーを押します。 既定のポストバック アクションがトリガーされる保証はありません。

  • 複数行のテキスト ボックス内でフォーカスのある Enter キーを押します。 複数行のテキスト ボックスで、Enter キーを押すと、テキスト ボックスに予期される動作である新しい行が作成されます。 複数行のテキストボックス内で Enter キーを押すとポストバックがトリガーされるブラウザーでは、Enter キーを使用して新しい行を作成する代わりに、JavaScript 関数を入力コントロールにアタッチできます。 スクリプトは ENTER キーをキャプチャし、ポストバックを停止する必要があります。 たとえば、 プロパティ コレクションを使用して、 Attributes イベントのクライアント スクリプトを onKeyPress 追加できます。

  • コントロールである既定のボタンを LinkButton 参照する。 および ImageButton コントロールのみがButtonサポートされています。

  • コントロールが DefaultButton コントロール内にない場合に、非同期ポストバック中に Panel プログラムによって を UpdatePanel 変更します。 ページに 1 つ以上 UpdatePanel のコントロールを追加することで、ページで非同期ポスト バックを有効にすることができます。 UpdatePanel コントロールを使用すると、ポストバックでページ全体を更新する代わりに、ページの選択した領域を更新できます。 詳細については、「 UpdatePanel コントロールの概要 」および「 部分ページ レンダリングの概要」を参照してください

  • テーマまたはスタイル シートテーマでこのプロパティを設定します。 詳細については、「テーマとスキンの ASP.NET」を参照してくださいThemeableAttribute

適用対象

こちらもご覧ください