IWebEditable.CreateEditorParts Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.EditorPartCollectionPublic Function CreateEditorParts () As EditorPartCollectionRetours
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 pour collecter un 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, WebPart contrôle ou contrôle utilisateur personnalisé et de les renvoyer 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 passe 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
Toute EditorPart valeur ajoutée à 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.
