EditorZoneBase.ApplyVerb プロパティ

定義

エンド ユーザーが編集モードで編集結果をコントロールに適用できるようにする WebPartVerb オブジェクトへの参照を取得します。

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

プロパティ値

エンド ユーザーが変更をコントロールに適用できるようにする WebPartVerb

属性

次のコード例では、宣言型とプログラムの両方で プロパティにアクセス ApplyVerb する方法を示します。 この例を実行するために必要な完全なコードについては、クラスの概要に関するトピックの「例」セクションを EditorZoneBase 参照してください。

コード例の最初の部分では、Web ページで宣言によって プロパティにアクセス ApplyVerb する方法を示します。 次の使用例は、動詞のテキストをカスタマイズします。

<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 番目の部分では、トグル ボタンを ApplyVerb 使用してプロパティを有効または無効にすることで、プログラムからプロパティにアクセスする方法を示します。

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

ブラウザーでページを読み込むとき、ドロップダウン リスト コントロールで [編集モード ] を選択して編集モードに切り替えることができます。 いずれかのコントロールのタイトル バーで動詞メニュー (下矢印) をクリックし、[ 編集 ] をクリックして選択したコントロールを編集できます。 EditorZoneコントロールと編集 UI が表示されたら、適用動詞を表すボタンを表示し、[ApplyVerb Enabled の切り替え] ボタンをクリックして有効または無効にすることができます。

注釈

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

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

適用対象

こちらもご覧ください