EditorZoneBase.CancelVerb Eigenschaft

Definition

Ruft einen Verweis auf ein WebPartVerb-Objekt ab, das es den Endbenutzern ermöglicht, Bearbeitungsänderungen an einem Steuerelement im Bearbeitungsmodus abzubrechen.Gets a reference to a WebPartVerb object that enables end users to cancel editing changes to a control in edit mode.

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; }
member this.CancelVerb : System.Web.UI.WebControls.WebParts.WebPartVerb
Public Overridable ReadOnly Property CancelVerb As WebPartVerb

Eigenschaftswert

Ein WebPartVerb, das Endbenutzern ermöglicht, Änderungen an einem Steuerelement abzubrechen.A WebPartVerb that enables end users to cancel editing changes to a control.

Attribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sowohl deklarativ als auch Programm gesteuert auf die CancelVerb-Eigenschaft zugegriffen wird.The following code example demonstrates how to access the CancelVerb property both declaratively and programmatically. Den vollständigen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Beispiel Abschnitt des Themas Übersicht über EditorZoneBase-Klasse.For the full code required to run the example, see the Example section of the EditorZoneBase class overview topic.

Der erste Teil des Code Beispiels zeigt, wie der Zugriff auf die CancelVerb-Eigenschaft auf einer Webseite deklarativ ist.The first part of the code example shows how to access the CancelVerb property declaratively in a Web page. In diesem Beispiel wird der Text für das Verb angepasst.This example customizes the text for the verb.

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

Im zweiten Teil des Beispiels wird gezeigt, wie Sie Programm gesteuert auf die CancelVerb Eigenschaft zugreifen können, indem Sie eine UMSCHALT Fläche verwenden, um Sie zu aktivieren oder zu deaktivieren.The second part of the example shows how to access the CancelVerb property programmatically, by using a toggle button to enable or disable it.

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

Wenn Sie die Seite in einem Browser laden, können Sie im Dropdown Listen-Steuerelement den Bearbeitungsmodus auswählen, um in den Bearbeitungsmodus zu wechseln.When you load the page in a browser, you can select Edit Mode in the drop-down list control to switch to edit mode. Sie können in der Titelleiste eines der Steuerelemente auf das Verbenmenü (den Pfeil nach unten) klicken und dann auf Bearbeiten klicken, um das ausgewählte Steuerelement zu bearbeiten.You can click the verbs menu (the down arrow) in the title bar of one of the controls, and click Edit to edit the selected control. Wenn das EditorZone Steuerelement und die Bearbeitungs Benutzeroberfläche angezeigt werden, sehen Sie die Schaltfläche, die das Abbruch Verb darstellt, und klicken Sie auf die Schaltfläche CancelVerb aktiviert umschalten , um Sie zu aktivieren oder zu deaktivieren.When the EditorZone control and editing UI are visible, you can see the button that represents the cancel verb, and click the Toggle CancelVerb Enabled button to enable or disable it.

Hinweise

Auf das Cancel-Verb wird durch die CancelVerb-Eigenschaft eines von der EditorZoneBase-Klasse abgeleiteten Steuer Elements verwiesen.The cancel verb is referenced by the CancelVerb property on a control derived from the EditorZoneBase class. Das Cancel-Verb bricht Bearbeitungs Änderungen ab, die ein Endbenutzer an einem Server Steuerelement in der Bearbeitungs Benutzeroberfläche vorgenommen hat.The cancel verb cancels editing changes that an end user has made to a server control in the editing user interface (UI). Standardmäßig wird das Cancel-Verb in der Benutzeroberfläche als Button-Steuerelement angezeigt.By default, the cancel verb appears in the UI as a Button control. Der Typ der Schaltfläche kann ein Bild, ein Link oder eine tatsächliche Schaltfläche sein. Sie können diese Einstellung für alle Verb Schaltflächen in einer Zone (nicht für einzelne Schaltflächen) festlegen, indem Sie die geerbte VerbButtonType-Eigenschaft auf Zonenebene festlegen.The type of button can be an image, a link, or an actual button; you can set this for all verb buttons in a zone (not for individual buttons) by setting the inherited VerbButtonType property at the zone level.

Wenn ein Benutzer Bearbeitungs Änderungen abbricht, werden keine der Änderungen in den EditorPart Steuerelementen auf das zu bearbeitende Server Steuerelement angewendet.When a user cancels editing changes, none of the changes in the EditorPart controls are applied to the server control that is being edited. Außerdem verbleibt die Seite im Bearbeitungs Anzeigemodus, aber die EditorPart Steuerelemente sind ausgeblendet, und das WebPart Steuerelement, das bearbeitet wurde, ist nicht mehr ausgewählt.In addition, the page remains in edit display mode, but the EditorPart controls are hidden and the WebPart control that was being edited is no longer selected. Dadurch kann ein Endbenutzer ein anderes WebPart Steuerelement auswählen, um es zu bearbeiten, ohne die Anzeigemodi erneut ändern zu müssen.This allows an end user to select another WebPart control to edit without having to change display modes again.

Das Cancel-Verb ist ein Steuerelement auf Zonenebene, d. h., es können mehrere EditorPart-Steuerelemente vorhanden sein, die jeweils eine oder mehrere Eigenschaften für das Server Steuerelement bearbeiten, das sich im Bearbeitungsmodus befindet, aber das Cancel-Verb funktioniert universell, um alle Änderungen aus allen EditorPart Steuerelementen in der Zone abzubrechen.The cancel verb is a zone-level control, meaning that while there might be several EditorPart controls, each editing one or more properties for the server control that is in edit mode, the cancel verb works universally to cancel all changes from all the EditorPart controls in the zone.

Gilt für:

Siehe auch