IWebEditable.CreateEditorParts Méthode

  • Référence

Définition

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

Retourne une collection de contrôles EditorPart personnalisés associés à un contrôle serveur qui implémente l'interface IWebEditable.

public:
 System::Web::UI::WebControls::WebParts::EditorPartCollection ^ CreateEditorParts();
public System.Web.UI.WebControls.WebParts.EditorPartCollection CreateEditorParts ();
abstract member CreateEditorParts : unit -> System.Web.UI.WebControls.WebParts.EditorPartCollection
Public Function CreateEditorParts () As EditorPartCollection

Retours

EditorPartCollection

EditorPartCollection qui contient la collection de contrôles EditorPart personnalisés associés à un contrôle serveur.

Exemples

L’exemple de code suivant illustre une substitution de la CreateEditorParts méthode dans un contrôle personnalisé WebPart . Le code source complet requis pour exécuter l’exemple se trouve dans la section Exemple de la rubrique vue d’ensemble de la IWebEditable classe.

L’exemple de code contient les deux membres de l’interface IWebEditable . Notez que le remplacement de la CreateEditorParts méthode crée un ArrayList ou plusieurs contrôles personnalisés EditorPart , puis utilise la liste pour créer l’objet EditorPartCollection .

public override EditorPartCollection CreateEditorParts()
{
  ArrayList editorArray = new ArrayList();
  TextDisplayEditorPart edPart = new TextDisplayEditorPart();
  edPart.ID = this.ID + "_editorPart1";
  editorArray.Add(edPart);
  EditorPartCollection editorParts = 
    new EditorPartCollection(editorArray);
  return editorParts;
}

public override object WebBrowsableObject
{
  get { return this; }
}

Public Overrides Function CreateEditorParts() _
                            As EditorPartCollection
  Dim editorArray As New ArrayList()
  Dim edPart as New TextDisplayEditorPart()
  edPart.ID = Me.ID & "_editorPart1"
  editorArray.Add(edPart)
  Dim editorParts As New EditorPartCollection(editorArray)
  Return editorParts

End Function

Public Overrides ReadOnly Property WebBrowsableObject() _
                                    As Object
  Get
    Return Me
  End Get
End Property

Remarques

La CreateEditorParts méthode vous permet de créer une collection de tous les contrôles personnalisés EditorPart associés à votre contrôle personnalisé, WebPart contrôle ou contrôle utilisateur, et de les retourner en tant qu’objet EditorPartCollection . Le WebPartManager contrôle prend la collection et crée des instances de tous les EditorPart contrôles chaque fois que le contrôle serveur entre en mode édition.

En règle générale, vous implémentez cette méthode dans un contrôle personnalisé WebPart en remplaçant sa CreateEditorParts méthode. Dans la méthode, vous créez des instances des contrôles personnalisés EditorPart que vous souhaitez associer à vos contrôles, ajoutez-les à un EditorPartCollection objet, puis retournez cet objet. La collection de EditorPart contrôles est ensuite affectée à la EditorParts propriété de la EditorZoneBase zone.

Notes

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

Notes pour les responsables de l’implémentation

L’objet EditorPartCollection retourné par la CreateEditorParts() méthode est en lecture seule et n’a aucune méthode accessible pour y ajouter des contrôles individuels. Toutefois, dans votre remplacement ou implémentation de la méthode, vous pouvez créer un autre type d’objet ICollection , tel qu’un ArrayList, pour contenir tous les contrôles personnalisés EditorPart et le transmettre au constructeur lorsque vous créez un EditorPartCollection objet. Pour obtenir un exemple de code, consultez la section Exemple.

S’applique à

Voir aussi