EditorZoneBase.CancelVerb Vlastnost

Definice

Obor názvů:

System.Web.UI.WebControls.WebParts

Sestavení:

System.Web.dll

Získá odkaz na WebPartVerb objekt, který umožňuje koncovým uživatelům zrušit úpravy změny ovládacího prvku v režimu úprav.

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

Hodnota vlastnosti

WebPartVerb

A WebPartVerb , který umožňuje koncovým uživatelům zrušit úpravy změn ovládacího prvku.

Atributy

PersistenceModeAttribute

Příklady

Následující příklad kódu ukazuje, jak získat přístup k CancelVerb vlastnosti jak deklarativně, tak programově. Úplný kód potřebný ke spuštění příkladu najdete v části Příklad tématu s přehledem EditorZoneBase třídy.

První část příkladu kódu ukazuje, jak přistupovat k CancelVerb vlastnosti deklarativně na webové stránce. Tento příklad přizpůsobí text pro operaci.

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

Druhá část příkladu ukazuje, jak k vlastnosti přistupovat CancelVerb programově pomocí přepínacího tlačítka pro její povolení nebo zakázání.

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

Když stránku načtete v prohlížeči, můžete výběrem možnosti Režim úprav v ovládacím prvku rozevíracího seznamu přepnout do režimu úprav. Můžete kliknout na nabídku sloves (šipka dolů) v záhlaví jednoho z ovládacích prvků a kliknout na Upravit a vybraný ovládací prvek upravit. EditorZone Když je ovládací prvek a uživatelské rozhraní pro úpravy viditelné, uvidíte tlačítko, které představuje příkaz zrušit, a kliknutím na tlačítko Přepnout možnost ZrušitVerb povoleno ji povolíte nebo zakážete.

Poznámky

Na příkaz cancel odkazuje CancelVerb vlastnost ovládacího prvku odvozeného z EditorZoneBase třídy . Příkaz zrušit zruší úpravy změn, které koncový uživatel provedl na serverovém ovládacím prvku v uživatelském rozhraní pro úpravy. Ve výchozím nastavení se příkaz zrušit zobrazí v uživatelském rozhraní jako ovládací prvek Button . Typ tlačítka může být obrázek, odkaz nebo skutečné tlačítko; Tuto možnost můžete nastavit pro všechna tlačítka sloves v zóně (ne pro jednotlivá tlačítka) nastavením zděděné VerbButtonType vlastnosti na úrovni zóny.

Když uživatel zruší úpravy změn, žádné změny v EditorPart ovládacích prvcích nejsou použity na serverový ovládací prvek, který je upravován. Stránka navíc zůstává v režimu zobrazení pro úpravy, ale EditorPart ovládací prvky jsou skryté a WebPart upravovaný ovládací prvek již není vybrán. To umožňuje koncovému uživateli vybrat jiný WebPart ovládací prvek pro úpravy, aniž by musel znovu měnit režimy zobrazení.

Příkaz zrušit je ovládací prvek na úrovni zóny, což znamená, že zatímco může existovat několik EditorPart ovládacích prvků, z nichž každý upravuje jednu nebo více vlastností serverového ovládacího prvku, který je v režimu úprav, příkaz cancel funguje univerzálně a ruší všechny změny ze všech EditorPart ovládacích prvků v zóně.

Viz také

• WebPartVerb
• ASP.NET ovládací prvky webových částí