EditorZoneBase.CancelVerb Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém uma referência a um WebPartVerb objeto que permite aos utilizadores finais cancelar alterações de edição a um controlo em 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.WebPartVerbPublic Overridable ReadOnly Property CancelVerb As WebPartVerbValor de Propriedade
A WebPartVerb que permite aos utilizadores finais cancelar alterações de edição a um controlo.
- Atributos
Exemplos
O exemplo de código seguinte demonstra como aceder à CancelVerb propriedade tanto de forma declarativa como programática. Para o código completo necessário para executar o exemplo, consulte a secção Exemplo do EditorZoneBase tópico de visão geral da aula.
A primeira parte do exemplo de código mostra como aceder declarativamente à CancelVerb propriedade numa página 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 aceder à CancelVerb propriedade programaticamente, usando um botão de alternância para a ativar ou desativar.
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
Quando carregas a página num navegador, podes selecionar o Modo Editar no controlo da lista suspensa para mudar para o modo de edição. Podes clicar no menu de verbos (a seta para baixo) na barra de título de um dos controlos e clicar em Editar para editar o controlo selecionado. Quando a EditorZone interface de controlo e edição estão visíveis, pode ver o botão que representa o verbo cancelar e clicar no botão Toggle CancelVerb Enabled para o ativar ou desativar.
Observações
O verbo cancelar é referenciado pela CancelVerb propriedade sobre um controlo derivado da EditorZoneBase classe. O verbo cancelar cancela alterações de edição que o utilizador final fez a um controlo de servidor na interface de utilizador (UI) de edição. Por defeito, o verbo cancelar aparece na interface como controlo Button . O tipo de botão pode ser uma imagem, um link ou um botão real; Podes definir isto para todos os botões verbais numa zona (não para botões individuais) definindo a propriedade herdada VerbButtonType ao nível da zona.
Quando um utilizador cancela alterações de edição, nenhuma das alterações nos EditorPart controlos é aplicada ao controlo do servidor que está a ser editado. Além disso, a página mantém-se em modo de exibição de edição, mas os EditorPart controlos estão ocultos e o WebPart controlo que estava a ser editado já não está selecionado. Isto permite ao utilizador final selecionar outro WebPart controlo para editar sem ter de mudar novamente os modos de visualização.
O verbo cancelar é um controlo ao nível da zona, o que significa que, embora possam existir vários EditorPart controlos, cada um editando uma ou mais propriedades para o controlo do servidor que está em modo de edição, o verbo cancelar funciona universalmente para cancelar todas as alterações de todos os EditorPart controlos na zona.
