Panel.DefaultButton プロパティ

  • リファレンス

定義

名前空間:
System.Web.UI.WebControls
アセンブリ:
System.Web.dll

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

プロパティ値

String

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

属性
ThemeableAttribute

注釈

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

インターフェイスを 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。

適用対象

こちらもご覧ください