Panel.DefaultButton Proprietà

Definizione

Ottiene o imposta l'identificatore per il pulsante predefinito contenuto nel controllo 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

Valore della proprietà

Valore di stringa corrispondente alla proprietà ID di un controllo pulsante contenuto nel controllo Panel. Il valore predefinito è una stringa vuota, a indicare che il controllo Panel non contiene un pulsante predefinito.

Attributi

Commenti

Utilizzare la DefaultButton proprietà per indicare il pulsante selezionato quando il Panel controllo ha lo stato attivo e l'utente preme INVIO. L'oggetto DefaultButton può essere impostato sull'identificatore di un Button controllo o di qualsiasi controllo che implementa l'interfaccia IButtonControl ad eccezione di un LinkButton controllo .

Se l'oggetto DefaultButton è impostato su un controllo che non implementa l'interfaccia IButtonControl o su un controllo non contenuto nel controllo , il controllo genera un'eccezione durante il PanelPanel rendering.

L'impostazione della DefaultButton proprietà non è supportata per gli scenari seguenti:

  • Impostare lo stato attivo all'esterno dei controlli di input nel pannello e quindi premere INVIO. L'azione postback predefinita non è garantita per l'attivazione.

  • Premendo INVIO con lo stato attivo all'interno di una casella di testo a più righe. In una casella di testo a più righe premere INVIO per creare una nuova riga nella casella di testo che rappresenta il comportamento previsto. Nei browser in cui la pressione del tasto INVIO all'interno di una casella di testo a più righe attiva un postback, ma si vuole che il tasto INVIO crei una nuova riga invece è possibile collegare una funzione JavaScript al controllo di input. Lo script deve acquisire la chiave INVIO e arrestare il postback. Ad esempio, è possibile usare la Attributes raccolta di proprietà per aggiungere script client per l'evento onKeyPress .

  • Riferimento a un pulsante predefinito che è un LinkButton controllo . Sono supportati solo Button i controlli e ImageButton .

  • Modifica dell'oggetto DefaultButton a livello di codice durante un postback asincrono quando il Panel controllo non si trova all'interno di un UpdatePanel controllo . I postback asincroni possono essere abilitati in una pagina aggiungendo uno o più UpdatePanel controlli alla pagina. UpdatePanel I controlli possono essere usati per aggiornare le aree selezionate di una pagina anziché aggiornare l'intera pagina con un postback. Per altre informazioni, vedere Panoramica del controllo UpdatePanel e Panoramica del rendering a pagina parziale.

  • Impostazione di questa proprietà in base ai temi o ai temi del foglio di stile. Per altre informazioni, vedere ThemeableAttribute e ASP.NET Temi e interfacce.

Si applica a

Vedi anche