EditorZoneBase.EditorParts Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Obtient une collection de tous les contrôles EditorPart contenus dans une zone EditorZoneBase.

public:
 property System::Web::UI::WebControls::WebParts::EditorPartCollection ^ EditorParts { System::Web::UI::WebControls::WebParts::EditorPartCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Web.UI.WebControls.WebParts.EditorPartCollection EditorParts { get; }
[<System.ComponentModel.Browsable(false)>]
member this.EditorParts : System.Web.UI.WebControls.WebParts.EditorPartCollection
Public ReadOnly Property EditorParts As EditorPartCollection

Valeur de propriété

EditorPartCollection

EditorPartCollection qui contient tous les contrôles EditorPart d'une zone.

Attributs
BrowsableAttribute

Exceptions

InvalidOperationException

Un EditorPart qui est ajouté à la collection n'a pas de valeur assignée à sa propriété ID.

Exemples

L’exemple de code suivant montre comment accéder à la EditorParts propriété par programmation. 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 que la EditorParts propriété contient des références à tous les EditorPart contrôles référencés de manière déclarative dans la page Web.

<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 de code accède par programmation à la EditorParts propriété et répertorie l’ID de chaque contrôle dans un Label contrôle.

void Button3_Click(object sender, EventArgs e)
{
  Label1.Text = "<br />";
  foreach (EditorPart part in EditorZone1.EditorParts)
  {
    Label1.Text += part.ID + "<br />";
  }
}

Sub Button3_Click(ByVal sender As Object, ByVal e As EventArgs)
  Label1.Text = "<br />"
  Dim part As EditorPart
  For Each part In EditorZone1.EditorParts
    Label1.Text += part.ID + "<br />"
  Next part
End Sub

Lorsque vous chargez la page dans un navigateur, vous pouvez cliquer sur le bouton Afficher la collection EditorParts pour répertorier les ID de tous les EditorPart contrôles référencés dans la EditorParts propriété.

Remarques

La EditorParts propriété fournit une référence à une collection de tous les EditorPart contrôles de la zone. Il référence les EditorPart contrôles fournis avec le jeu de contrôles composants WebPart et tous les contrôles personnalisés EditorPart ajoutés à la zone. Étant donné que la collection est en lecture seule, les développeurs qui souhaitent créer des contrôles personnalisés EditorPart à des fins d’édition générale et les ajouter à la collection doivent remplacer la CreateEditorParts méthode.

Si vous concevez des contrôles personnalisés EditorPart pour modifier un contrôle spécifique WebPart , vous devez remplacer les membres de la IWebEditable méthode interface et CreateEditorParts de la WebBrowsableObject propriété dans le WebPart contrôle. La raison de remplacer ces membres est de permettre à votre WebPart contrôle de créer les contrôles personnalisés EditorPart et de les ajouter à la EditorParts collection lorsque votre contrôle est en cours de modification, et de fournir aux contrôles d’édition une référence d’objet au WebPart contrôle qu’ils modifient. Si vous souhaitez ajouter un contrôle personnalisé EditorPart pour modifier un contrôle serveur qui n’hérite pas de la WebPart classe, vous devez implémenter l’interface IWebEditable dans la classe comme vous le feriez pour un WebPart contrôle.

Notes

Notez que tout EditorPart élément ajouté à la collection de EditorPart contrôles dans une implémentation de la CreateEditorParts méthode doit avoir une valeur affectée à sa propriété ID; sinon, une exception est levée lorsque la collection est affectée à la EditorParts propriété.

S’applique à

Voir aussi