EditorZoneBase.CancelVerb Propriedade

  • Referência

Definição

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Obtém uma referência a um objeto WebPartVerb que permite que os usuários finais cancelem alterações de edição em um controle no modo de edição.

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

Valor da propriedade

WebPartVerb

Um WebPartVerb que permite que os usuários finais cancelem a edição de alterações em um controle.

Atributos
PersistenceModeAttribute

Exemplos

O exemplo de código a seguir demonstra como acessar a CancelVerb propriedade de forma declarativa e programática. Para obter o código completo necessário para executar o exemplo, consulte a seção Exemplo do tópico de visão geral da EditorZoneBase classe.

A primeira parte do exemplo de código mostra como acessar a CancelVerb propriedade declarativamente em uma página da Web. Este exemplo personaliza o texto para o verbo.

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

A segunda parte do exemplo mostra como acessar a CancelVerb propriedade programaticamente usando um botão de alternância para habilitá-la ou desabilitá-la.

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

Ao carregar a página em um navegador, você pode selecionar o Modo de Edição no controle de lista suspensa para alternar para o modo de edição. Você pode clicar no menu de verbos (a seta para baixo) na barra de título de um dos controles e clicar em Editar para editar o controle selecionado. Quando a interface do EditorZone usuário de controle e edição estiver visível, você poderá ver o botão que representa o verbo cancelar e clicar no botão Alternar CancelVerb Habilitado para habilitá-lo ou desabilitá-lo.

Comentários

O verbo de cancelamento é referenciado pela CancelVerb propriedade em um controle derivado da EditorZoneBase classe. O verbo cancela a edição de alterações feitas por um usuário final em um controle de servidor na interface do usuário (interface do usuário) de edição. Por padrão, o verbo cancelar aparece na interface do usuário como um Button controle. O tipo de botão pode ser uma imagem, um link ou um botão real; você pode definir isso para todos os botões de verbo em uma zona (não para botões individuais) definindo a propriedade herdada VerbButtonType no nível da zona.

Quando um usuário cancela a edição de alterações, nenhuma das alterações nos EditorPart controles é aplicada ao controle do servidor que está sendo editado. Além disso, a página permanece no modo de exibição de edição, mas os EditorPart controles estão ocultos e o WebPart controle que estava sendo editado não está mais selecionado. Isso permite que um usuário final selecione outro WebPart controle para editar sem precisar alterar os modos de exibição novamente.

O verbo de cancelamento é um controle de nível de zona, o que significa que, embora possa haver vários EditorPart controles, cada um editando uma ou mais propriedades para o controle do servidor que está no modo de edição, o verbo de cancelamento funciona universalmente para cancelar todas as alterações de todos os EditorPart controles na zona.

Aplica-se a

Confira também