IWebEditable.CreateEditorParts Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Restituisce un insieme di controlli EditorPart personalizzati associati a un controllo server che implementa l'interfaccia 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 EditorPartCollectionRestituisce
Un oggetto EditorPartCollection che contiene l'insieme di controlli EditorPart personalizzati associati a un controllo server.
Esempio
Nell'esempio CreateEditorParts di codice seguente viene illustrato un override del metodo in un controllo personalizzato WebPart . Il codice sorgente completo necessario per eseguire l'esempio è disponibile nella sezione Esempio dell'argomento panoramica della IWebEditable classe.
L'esempio di codice contiene entrambi i membri dell'interfaccia IWebEditable . Si noti che l'override del CreateEditorParts metodo crea un ArrayList oggetto per raccogliere uno o più controlli personalizzati EditorPart e quindi usa l'elenco per creare l'oggetto 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
Commenti
Il CreateEditorParts metodo consente di creare una raccolta di tutti i controlli personalizzati associati al controllo, WebPart al controllo o al controllo utente personalizzati EditorPart e di restituirli come EditorPartCollection oggetto. Il WebPartManager controllo accetta la raccolta e crea istanze di tutti i EditorPart controlli ogni volta che il controllo server entra in modalità di modifica.
In genere si implementa questo metodo in un controllo personalizzato WebPart eseguendo l'override del CreateEditorParts relativo metodo. Nel metodo si creano istanze dei controlli personalizzati EditorPart che si desidera associare ai controlli, aggiungerli a un EditorPartCollection oggetto e quindi restituire tale oggetto. La raccolta di EditorPart controlli viene quindi assegnata alla EditorParts proprietà della EditorZoneBase zona.
Nota
Qualsiasi EditorPart elemento aggiunto alla raccolta di EditorPart controlli in un'implementazione del CreateEditorParts metodo deve avere un valore assegnato alla relativa proprietà ID, in caso contrario, viene generata un'eccezione quando la raccolta viene assegnata alla EditorParts proprietà.
Note per gli implementatori
L'oggetto EditorPartCollection restituito dal CreateEditorParts() metodo è di sola lettura e non dispone di un metodo accessibile per aggiungere singoli controlli. Tuttavia, nell'override o nell'implementazione del metodo è possibile creare un altro tipo di ICollection oggetto, ad esempio , ArrayListper contenere tutti i controlli personalizzati EditorPart e passarlo al costruttore quando si crea un nuovo EditorPartCollection oggetto. Per un esempio di codice, vedere la sezione Esempio.
