EditorZoneBase.CancelVerb Egenskap

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

Egenskapsvärde

En WebPartVerb som gör det möjligt för slutanvändare att avbryta redigering av ändringar i en kontroll.

Attribut

PersistenceModeAttribute

Exempel

I följande kodexempel visas hur du kommer åt CancelVerb egenskapen både deklarativt och programmatiskt. Fullständig kod som krävs för att köra exemplet finns i avsnittet Exempel i EditorZoneBase avsnittet klassöversikt.

Den första delen av kodexemplet visar hur du CancelVerb kommer åt egenskapen deklarativt på en webbsida. Det här exemplet anpassar texten för verbet.

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

Den andra delen av exemplet visar hur du kommer åt CancelVerb egenskapen programmatiskt med hjälp av en växlingsknapp för att aktivera eller inaktivera den.

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

När du läser in sidan i en webbläsare kan du välja Redigera läge i listrutan för att växla till redigeringsläge. Du kan klicka på verbmenyn (nedåtpilen) i namnlisten för en av kontrollerna och klicka på Redigera för att redigera den valda kontrollen. När kontrollen och redigeringsgränssnittet EditorZone visas kan du se knappen som representerar det avbrutna verbet och klicka på knappen Växla CancelVerb-aktiverad för att aktivera eller inaktivera det.

Kommentarer

Cancel-verbet refereras av CancelVerb egenskapen på en kontroll som härleds från EditorZoneBase klassen. Det avbrutna verbet avbryter redigering av ändringar som en slutanvändare har gjort i en serverkontroll i användargränssnittet för redigering. Som standard visas avbryt-verbet i användargränssnittet som en Button kontroll. Typen av knapp kan vara en bild, en länk eller en faktisk knapp. du kan ange detta för alla verbknappar i en zon (inte för enskilda knappar) genom att ange den ärvda VerbButtonType egenskapen på zonnivå.

När en användare avbryter redigeringsändringar tillämpas ingen av ändringarna i EditorPart kontrollerna på den serverkontroll som redigeras. Dessutom förblir sidan i redigeringsläge, men EditorPart kontrollerna är dolda och kontrollen WebPart som redigerades är inte längre markerad. Detta gör att en slutanvändare kan välja en annan WebPart kontroll att redigera utan att behöva ändra visningslägen igen.

Cancel-verbet är en kontroll på zonnivå, vilket innebär att även om det kan finnas flera EditorPart kontroller, där var och en redigerar en eller flera egenskaper för serverkontrollen som är i redigeringsläge, fungerar avbryt-verbet universellt för att avbryta alla ändringar från alla EditorPart kontroller i zonen.

Se även

• WebPartVerb
• ASP.NET webbdelskontroller