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 参照してください。

コード例の最初の部分では、Web ページで宣言によって プロパティにアクセス 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>

この例の 2 番目の部分では、トグル ボタンを 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 Enabled の切り替え] ボタンをクリックして有効または無効にすることができます。

注釈

cancel 動詞は、 クラスから派生したコントロールの プロパティによってCancelVerbEditorZoneBase参照されます。 cancel 動詞は、エンド ユーザーが編集ユーザー インターフェイス (UI) でサーバー コントロールに加えた変更の編集を取り消します。 既定では、キャンセル動詞は UI にコントロールとして Button 表示されます。 ボタンの種類には、画像、リンク、または実際のボタンを指定できます。これは、ゾーン レベルで継承プロパティ VerbButtonType を設定することで、(個々のボタンではなく) ゾーン内のすべての動詞ボタンに対して設定できます。

ユーザーが変更の編集を取り消すと、コントロールの EditorPart 変更は、編集中のサーバー コントロールに適用されません。 さらに、ページは編集表示モードのままですが EditorPart 、コントロールは非表示になり、 WebPart 編集中のコントロールは選択されなくなります。 これにより、エンド ユーザーは、もう一度表示モードを変更することなく、編集する別 WebPart のコントロールを選択できます。

cancel 動詞はゾーン レベルのコントロールです。つまり、複数 EditorPart のコントロールがある可能性がありますが、編集モードのサーバー コントロールに対して 1 つ以上のプロパティを編集するたびに、キャンセル動詞は、ゾーン内のすべてのコントロールからのすべての EditorPart 変更を取り消すために汎用的に機能します。

適用対象

こちらもご覧ください