EditorZoneBase.ApplyVerb Eigenschaft

Definition

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

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

Eigenschaftswert

Ein WebPartVerb, das Endbenutzern ermöglicht, Änderungen auf ein Steuerelement anzuwenden.A WebPartVerb that enables end users to apply changes to a control.

Attribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sowohl deklarativ als auch Programm gesteuert auf die ApplyVerb-Eigenschaft zugegriffen wird.The following code example demonstrates how to access the ApplyVerb 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 ApplyVerb-Eigenschaft auf einer Webseite deklarativ ist.The first part of the code example shows how to access the ApplyVerb 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 ApplyVerb 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 ApplyVerb property programmatically, by using a toggle button to enable or disable it.

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 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 apply-Verb darstellt, und klicken Sie auf die Schaltfläche ApplyVerb aktiviert aktivieren, um Sie zu aktivieren oder zu deaktivieren.When the EditorZone control and editing UI are visible, you can see the button that represents the apply verb, and click the Toggle ApplyVerb Enabled button to enable or disable it.

Hinweise

Auf das apply-Verb wird durch die ApplyVerb-Eigenschaft eines von der EditorZoneBase-Klasse abgeleiteten Steuer Elements verwiesen.The apply verb is referenced by the ApplyVerb property on a control derived from the EditorZoneBase class. Das Apply-Verb speichert Bearbeitungs Änderungen, die ein Endbenutzer in der Bearbeitungs Benutzeroberfläche vorgenommen hat, zu einem Server Steuerelement, das gerade bearbeitet wird.The apply verb saves editing changes that an end user has made in the editing user interface (UI) to a server control that is currently being edited. Standardmäßig wird das apply-Verb in der Benutzeroberfläche als Button Steuerelement angezeigt.By default, the apply 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.

Das Apply-Verb ist ein Steuerelement auf Zonenebene. Dies bedeutet, dass es möglicherweise mehrere EditorPart-Steuerelemente gibt, die jeweils eine oder mehrere Eigenschaften für das Server Steuerelement bearbeiten, das sich im Bearbeitungsmodus befindet. das apply-Verb funktioniert jedoch universell, um alle Änderungen von allen EditorPart-Steuerelementen in der Zone auf das Server Steuerelement anzuwenden.The apply verb is a zone-level control, which means that although there might be several EditorPart controls, each editing one or more properties for the server control that is in edit mode, the apply verb works universally to apply all changes from all the EditorPart controls in the zone to the server control.

Gilt für:

Siehe auch