IWebEditable.CreateEditorParts Metodo

Definizione

Spazio dei nomi:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

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

Public Function CreateEditorParts () As EditorPartCollection

Restituisce

EditorPartCollection

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.

Vedi anche

• EditorPart
• ASP.NET controlli web part