EditorZoneBase.CancelVerb Propriété

Définition

Espace de noms:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Obtient une référence à un objet WebPartVerb qui permet à l'utilisateur final d'annuler des modifications apportées à un contrôle en mode édition.

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

Valeur de propriété

WebPartVerb

Un WebPartVerb qui permet à l'utilisateur final d'annuler des modifications apportées à un contrôle.

Attributs

PersistenceModeAttribute

Exemples

L’exemple de code suivant montre comment accéder à la CancelVerb propriété de manière déclarative et programmatique. Pour obtenir le code complet requis pour exécuter l’exemple, consultez la section Exemple de la rubrique Vue d’ensemble de la EditorZoneBase classe.

La première partie de l’exemple de code montre comment accéder à la CancelVerb propriété de manière déclarative dans une page Web. Cet exemple montre comment personnaliser le texte du verbe.

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

La deuxième partie de l’exemple montre comment accéder à la propriété par programmation, à l’aide CancelVerb d’un bouton bascule pour l’activer ou la désactiver.

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

Lorsque vous chargez la page dans un navigateur, vous pouvez sélectionner Mode d’édition dans le contrôle de liste déroulante pour passer en mode édition. Vous pouvez cliquer sur le menu verbes (flèche vers le bas) dans la barre de titre de l’un des contrôles, puis cliquer sur Modifier pour modifier le contrôle sélectionné. Lorsque le contrôle et l’interface EditorZone utilisateur de modification sont visibles, vous pouvez voir le bouton qui représente le verbe annuler, puis cliquer sur le bouton Désactiver AnnulerVerb Activé pour l’activer ou le désactiver.

Remarques

Le verbe cancel est référencé par la CancelVerb propriété sur un contrôle dérivé de la EditorZoneBase classe . Le verbe annuler annule les modifications apportées par un utilisateur final à un contrôle serveur dans l’interface utilisateur de modification. Par défaut, le verbe annuler apparaît dans l’interface utilisateur en tant que Button contrôle. Le type de bouton peut être une image, un lien ou un bouton réel ; vous pouvez définir cette valeur pour tous les boutons verbes d’une zone (et non pour les boutons individuels) en définissant la propriété héritée VerbButtonType au niveau de la zone.

Lorsqu’un utilisateur annule la modification des modifications, aucune des modifications apportées aux EditorPart contrôles n’est appliquée au contrôle serveur en cours de modification. En outre, la page reste en mode d’affichage d’édition, mais les EditorPart contrôles sont masqués et le WebPart contrôle en cours de modification n’est plus sélectionné. Cela permet à un utilisateur final de sélectionner un autre WebPart contrôle à modifier sans avoir à modifier à nouveau les modes d’affichage.

Le verbe annuler est un contrôle au niveau de la zone, ce qui signifie que même s’il peut y avoir plusieurs EditorPart contrôles, chaque modification d’une ou plusieurs propriétés pour le contrôle serveur en mode édition, le verbe annuler fonctionne de manière universelle pour annuler toutes les modifications de tous les EditorPart contrôles de la zone.

Voir aussi

• WebPartVerb
• contrôles webPart ASP.NET