EditorZoneBase.CancelVerb Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Ottiene un riferimento a un oggetto WebPartVerb che consente agli utenti finali di annullare le modifiche apportate a un controllo in modalità di modifica.

public:
 virtual property System::Web::UI::WebControls::WebParts::WebPartVerb ^ CancelVerb { System::Web::UI::WebControls::WebParts::WebPartVerb ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.WebParts.WebPartVerb CancelVerb { get; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.CancelVerb : System.Web.UI.WebControls.WebParts.WebPartVerb
Public Overridable ReadOnly Property CancelVerb As WebPartVerb

Valore della proprietà

WebPartVerb

Un oggetto WebPartVerb che consente agli utenti finali di annullare le modifiche apportate a un controllo.

Attributi
PersistenceModeAttribute

Esempio

Nell'esempio di codice seguente viene illustrato come accedere alla CancelVerb proprietà sia dichiarativa che a livello di codice. Per il codice completo necessario per eseguire l'esempio, vedere la sezione Esempio dell'argomento panoramica della EditorZoneBase classe.

La prima parte dell'esempio di codice illustra come accedere CancelVerb alla proprietà dichiarativamente in una pagina Web. In questo esempio viene personalizzato il testo per il verbo.

<aspSample:MyEditorZone ID="EditorZone1" runat="server">
  <ApplyVerb Text="Apply Changes" />
  <CancelVerb Text="Cancel Changes" />
  <OKVerb Text="Finished" />
  <ZoneTemplate>
    <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
      runat="server" />
    <asp:LayoutEditorPart ID="LayoutEditorPart1" 
      runat="server" />
  </ZoneTemplate>
</aspSample:MyEditorZone>

<aspSample:MyEditorZone ID="EditorZone1" runat="server">
  <ApplyVerb Text="Apply Changes" />
  <CancelVerb Text="Cancel Changes" />
  <OKVerb Text="Finished" />
  <ZoneTemplate>
    <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
      runat="server" />
    <asp:LayoutEditorPart ID="LayoutEditorPart1" 
      runat="server" />
  </ZoneTemplate>
</aspSample:MyEditorZone>

La seconda parte dell'esempio illustra come accedere alla CancelVerb proprietà a livello di codice usando un pulsante di attivazione o disabilitazione.

void Button2_Click(object sender, EventArgs e)
{
  if (EditorZone1.CancelVerb.Enabled)
    EditorZone1.CancelVerb.Enabled = false;
  else
    EditorZone1.CancelVerb.Enabled = true;
}

Sub Button2_Click(ByVal sender As Object, ByVal e As EventArgs)
  If EditorZone1.CancelVerb.Enabled Then
    EditorZone1.CancelVerb.Enabled = False
  Else
    EditorZone1.CancelVerb.Enabled = True
  End If
End Sub

Quando si carica la pagina in un browser, è possibile selezionare Modalità di modifica nel controllo elenco a discesa per passare alla modalità di modifica. È possibile fare clic sul menu verbi (freccia giù) nella barra del titolo di uno dei controlli e fare clic su Modifica per modificare il controllo selezionato. Quando il controllo e la EditorZone modifica dell'interfaccia utente sono visibili, è possibile visualizzare il pulsante che rappresenta il verbo annulla e fare clic sul pulsante Toggle CancelVerb Enabled per abilitarlo o disabilitarlo.

Commenti

Il verbo cancel viene fatto riferimento alla CancelVerb proprietà in un controllo derivato dalla EditorZoneBase classe . Il verbo annulla la modifica delle modifiche apportate a un utente finale in un controllo server nell'interfaccia utente di modifica. Per impostazione predefinita, il verbo annulla viene visualizzato nell'interfaccia utente come Button controllo. Il tipo di pulsante può essere un'immagine, un collegamento o un pulsante effettivo; è possibile impostare questo valore per tutti i pulsanti verbi in una zona (non per singoli pulsanti) impostando la proprietà ereditata VerbButtonType a livello di zona.

Quando un utente annulla le modifiche, nessuna delle modifiche apportate EditorPart ai controlli viene applicata al controllo server che viene modificato. Inoltre, la pagina rimane in modalità di visualizzazione modifica, ma i EditorPart controlli sono nascosti e il WebPart controllo che è stato modificato non è più selezionato. Ciò consente a un utente finale di selezionare un altro WebPart controllo da modificare senza dover modificare di nuovo le modalità di visualizzazione.

Il verbo annulla è un controllo a livello di zona, ovvero che, mentre potrebbero essere presenti diversi EditorPart controlli, ogni modifica di una o più proprietà per il controllo server in modalità di modifica, il verbo annulla funziona universalmente per annullare tutte le modifiche da tutti i EditorPart controlli della zona.

Si applica a

Vedi anche