EditorZoneBase.CancelVerb Proprietà

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 in modo dichiarativo che a livello di codice. Per il codice completo necessario per eseguire l'esempio, vedere la sezione Esempio dell'argomento di panoramica della EditorZoneBase classe.

La prima parte dell'esempio di codice mostra come accedere alla CancelVerb proprietà in modo dichiarativo 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>

Nella seconda parte dell'esempio viene illustrato come accedere alla CancelVerb proprietà a livello di codice usando un pulsante di attivazione/disattivazione per abilitarlo o disabilitarlo.

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 dei 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 l'interfaccia EditorZone utente di modifica sono visibili, è possibile visualizzare il pulsante che rappresenta il verbo di annullamento e fare clic sul pulsante Attiva/Disattiva CancelVerb per abilitarlo o disabilitarlo.

Commenti

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

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

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

Vedi anche

• WebPartVerb
• controlli web part ASP.NET