共用方式為

EditorZoneBase.CancelVerb 屬性

  • 參考

定義

命名空間:
System.Web.UI.WebControls.WebParts
組件:
System.Web.dll

取得 WebPartVerb 物件參考，其可讓使用者取消對處於編輯模式之控制項的編輯變更。

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

屬性值

WebPartVerb

WebPartVerb，可讓使用者取消對控制項的編輯變更。

屬性
PersistenceModeAttribute

範例

下列程式代碼範例示範如何以宣告方式和程序設計方式存取 CancelVerb 屬性。 如需執行範例所需的完整程式碼，請參閱類別概觀主題的 EditorZoneBase 範例一節。

程式代碼範例的第一個部分示範如何在網頁中以宣告方式存取 CancelVerb 屬性。 本範例會自定義動詞的文字。

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

範例的第二個部分示範如何使用切換按鈕來啟用或停用屬性，以程式設計方式存取 CancelVerb 屬性。

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

當您在瀏覽器中載入頁面時，您可以在下拉式清單控制項中選取 [ 編輯模式 ]，以切換至編輯模式。 您可以單擊動詞功能表 (其中一個控件標題列中的向下箭號) ，然後單擊 [ 編輯 ] 以編輯選取的控件。 EditorZone當顯示控制項和編輯 UI 時，您可以看到代表取消動詞的按鈕，然後按兩下 [切換取消][啟用] 按鈕來啟用或停用它。

備註

取消動詞是由 CancelVerb 衍生自 EditorZoneBase 類別之控件上的 屬性所參考。 取消動詞會取消使用者對編輯使用者介面中的伺服器控制項所做的編輯變更， (UI) 。 根據預設，取消動詞會在UI Button 中顯示為控件。 按鈕的類型可以是影像、鏈接或實際按鈕;您可以藉由在區域層級設定繼承 VerbButtonType 的屬性，為區域中的所有動詞按鈕設定 (不適用於個別按鈕) 。

當使用者取消編輯變更時，控件中的任何 EditorPart 變更都不會套用至正在編輯的伺服器控制件。 此外，頁面會維持在編輯顯示模式中，但 EditorPart 會隱藏控件，而且不再選取正在編輯的 WebPart 控件。 這可讓用戶選取另一個 WebPart 控件進行編輯，而不需要再次變更顯示模式。

取消動詞是區域層級控件，這表示雖然可能有數 EditorPart 個控件，但每個控件都會編輯處於編輯模式的伺服器控件一或多個屬性，取消動詞可通用地取消區域中所有控件的所有 EditorPart 變更。

適用於

另請參閱