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.

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

Eigenschaftswert

Ein WebPartVerb, das Endbenutzern ermöglicht, Änderungen an einem Steuerelement abzubrechen.

Attribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sie sowohl deklarativ als auch programmgesteuert auf die CancelVerb Eigenschaft zugreifen. Den vollständigen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Abschnitt Beispiel des EditorZoneBase Themas Klassenübersicht.

Der erste Teil des Codebeispiels zeigt, wie Sie deklarativ auf die CancelVerb Eigenschaft in einer Webseite zugreifen. In diesem Beispiel wird der Text für das Verb angepasst.

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

Der zweite Teil des Beispiels zeigt, wie Sie programmgesteuert auf die CancelVerb Eigenschaft zugreifen, indem Sie eine Umschaltfläche verwenden, um sie zu aktivieren oder zu deaktivieren.

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 Dropdownlistensteuerelement Bearbeitungsmodus auswählen, um in den Bearbeitungsmodus zu wechseln. Sie können auf das Verbenmenü (den Pfeil nach unten) in der Titelleiste eines der Steuerelemente klicken und dann auf Bearbeiten klicken, um das ausgewählte Steuerelement zu bearbeiten. Wenn das Steuerelement und die EditorZone Bearbeitungsoberfläche sichtbar sind, sehen Sie die Schaltfläche, die das Verb cancel darstellt, und klicken Sie auf die Schaltfläche CancelVerb Enabled umschalten , um es zu aktivieren oder zu deaktivieren.

Hinweise

Auf das Cancel-Verb wird von der CancelVerb -Eigenschaft eines von der -Klasse abgeleiteten Steuerelements EditorZoneBase verwiesen. Das Cancel-Verb bricht die Bearbeitung von Änderungen ab, die ein Endbenutzer an einem Serversteuerelement in der Bearbeitungs-Benutzeroberfläche (UI) vorgenommen hat. Standardmäßig wird das Cancel-Verb in der Benutzeroberfläche als Button Steuerelement angezeigt. Der Typ der Schaltfläche kann ein Bild, ein Link oder eine tatsächliche Schaltfläche sein. Sie können dies für alle Verbschaltflächen in einer Zone (nicht für einzelne Schaltflächen) festlegen, indem Sie die geerbte VerbButtonType Eigenschaft auf Zonenebene festlegen.

Wenn ein Benutzer die Bearbeitung von Änderungen abbricht, wird keine der Änderungen in den EditorPart Steuerelementen auf das Serversteuerelement angewendet, das bearbeitet wird. Darüber hinaus verbleibt die Seite im Bearbeitungsanzeigemodus, aber die EditorPart Steuerelemente sind ausgeblendet, und das WebPart Steuerelement, das bearbeitet wurde, ist nicht mehr ausgewählt. Dadurch kann ein Endbenutzer ein anderes WebPart Steuerelement auswählen, das bearbeitet werden soll, ohne den Anzeigemodus erneut ändern zu müssen.

Das Verb cancel ist ein Steuerelement auf Zonenebene. Dies bedeutet, dass zwar mehrere EditorPart Steuerelemente vorhanden sein können, aber bei jeder Bearbeitung einer oder mehrerer Eigenschaften für das Serversteuerelement, das sich im Bearbeitungsmodus befindet, das Verb cancel universell funktioniert, um alle Änderungen aller EditorPart Steuerelemente in der Zone abzubrechen.

Gilt für:

Weitere Informationen