EditorZoneBase.ApplyVerb Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Ruft einen Verweis auf ein WebPartVerb-Objekt ab, das den Endbenutzern ermöglicht, Bearbeitungsänderungen an einem Steuerelement im Bearbeitungsmodus zu übernehmen.

public:
 virtual property System::Web::UI::WebControls::WebParts::WebPartVerb ^ ApplyVerb { System::Web::UI::WebControls::WebParts::WebPartVerb ^ get(); };

[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.WebParts.WebPartVerb ApplyVerb { get; }

[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.ApplyVerb : System.Web.UI.WebControls.WebParts.WebPartVerb

Public Overridable ReadOnly Property ApplyVerb As WebPartVerb

Eigenschaftswert

WebPartVerb

Ein WebPartVerb, das Endbenutzern ermöglicht, Änderungen auf ein Steuerelement anzuwenden.

Attribute

PersistenceModeAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sie sowohl deklarativ als auch programmgesteuert auf die ApplyVerb 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 ApplyVerb 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 ApplyVerb Eigenschaft zugreifen, indem Sie eine Umschaltfläche verwenden, um sie zu aktivieren oder zu deaktivieren.

void Button1_Click(object sender, EventArgs e)
{
  if (EditorZone1.ApplyVerb.Enabled)
    EditorZone1.ApplyVerb.Enabled = false;
  else
    EditorZone1.ApplyVerb.Enabled = true;
}

Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)
  If EditorZone1.ApplyVerb.Enabled Then
    EditorZone1.ApplyVerb.Enabled = False
  Else
    EditorZone1.ApplyVerb.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 anwendende Verb darstellt, und klicken Sie auf die Schaltfläche AnwendenVerb aktiviert , um sie zu aktivieren oder zu deaktivieren.

Hinweise

Auf das apply-Verb wird von der ApplyVerb -Eigenschaft für ein steuerelement verwiesen, das von der EditorZoneBase -Klasse abgeleitet ist. Das Apply-Verb speichert Bearbeitungsänderungen, die ein Endbenutzer auf der Bearbeitungsbenutzeroberfläche (UI) vorgenommen hat, an einem Serversteuerelement, das gerade bearbeitet wird. Standardmäßig wird das Apply-Verb auf 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.

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

Weitere Informationen

• WebPartVerb
• ASP.NET Webparts-Steuerelemente