EditorZoneBase.CancelVerb Eigenschap

Definitie

Hiermee haalt u een verwijzing op naar een WebPartVerb object waarmee eindgebruikers bewerkingswijzigingen in een besturingselement in de bewerkingsmodus kunnen annuleren.

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

Waarde van eigenschap

Een WebPartVerb functie waarmee eindgebruikers bewerkingswijzigingen in een besturingselement kunnen annuleren.

Kenmerken

Voorbeelden

In het CancelVerb volgende codevoorbeeld ziet u hoe u de eigenschap zowel declaratief als programmatisch kunt openen. Zie de sectie Voorbeeld van het EditorZoneBase onderwerp Class Overview voor de volledige code die is vereist om het voorbeeld uit te voeren.

In het eerste deel van het codevoorbeeld ziet u hoe CancelVerb u de eigenschap declaratief kunt openen op een webpagina. In dit voorbeeld wordt de tekst voor het werkwoord aangepast.

<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>

Het tweede deel van het voorbeeld laat zien hoe CancelVerb u de eigenschap programmatisch opent met behulp van een wisselknop om deze in of uit te schakelen.

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

Wanneer u de pagina in een browser laadt, kunt u de bewerkingsmodus selecteren in het besturingselement voor de vervolgkeuzelijst om over te schakelen naar de bewerkingsmodus. U kunt op het menu Werkwoorden (de pijl-omlaag) in de titelbalk van een van de besturingselementen klikken en op Bewerken klikken om het geselecteerde besturingselement te bewerken. Wanneer het besturingselement en de EditorZone bewerkingsinterface zichtbaar zijn, ziet u de knop die het annuleringswerkwoord vertegenwoordigt en klikt u op de knop Annulerenverb ingeschakeld om deze in of uit te schakelen.

Opmerkingen

Er wordt naar de CancelVerb eigenschap voor het annuleren verwezen op een besturingselement dat is afgeleid van de EditorZoneBase klasse. De bewerking annuleren annuleert wijzigingen die een eindgebruiker heeft aangebracht in een serverbesturing in de gebruikersinterface voor bewerken. Standaard wordt de annuleringsopdracht weergegeven in de gebruikersinterface als een Button besturingselement. Het type knop kan een afbeelding, een koppeling of een werkelijke knop zijn; u kunt dit instellen voor alle werkwoordknoppen in een zone (niet voor afzonderlijke knoppen) door de overgenomen VerbButtonType eigenschap op zoneniveau in te stellen.

Wanneer een gebruiker bewerkingswijzigingen annuleert, worden geen van de wijzigingen in de EditorPart besturingselementen toegepast op het serverbesturingselement dat wordt bewerkt. Bovendien blijft de pagina in de bewerkingsweergavemodus, maar de EditorPart besturingselementen zijn verborgen en het WebPart besturingselement dat wordt bewerkt, wordt niet meer geselecteerd. Hierdoor kan een eindgebruiker een ander WebPart besturingselement selecteren om te bewerken zonder de weergavemodi opnieuw te hoeven wijzigen.

De bewerking annuleren is een besturingselement op zoneniveau, wat betekent dat hoewel er mogelijk meerdere EditorPart besturingselementen zijn, elke bewerking van een of meer eigenschappen voor het serverbesturingselement in de bewerkingsmodus, het annuleren werkwoord universeel werkt om alle wijzigingen van alle EditorPart besturingselementen in de zone te annuleren.

Van toepassing op

Zie ook