IWebEditable.CreateEditorParts Metoda

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls.WebParts

Zestaw:

System.Web.dll

Zwraca kolekcję kontrolek niestandardowych EditorPart skojarzonych z kontrolką serwera, która implementuje IWebEditable interfejs.

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

Zwraca

EditorPartCollection

Element EditorPartCollection zawierający kolekcję kontrolek niestandardowych EditorPart skojarzonych z kontrolką serwera.

Przykłady

Poniższy przykład kodu przedstawia zastąpienie CreateEditorParts metody w kontrolce niestandardowej WebPart . Kompletny kod źródłowy wymagany do uruchomienia przykładu znajduje się w sekcji Przykład tematu IWebEditable przeglądu klasy.

Przykładowy kod zawiera oba elementy członkowskie interfejsu IWebEditable . Należy pamiętać, że zastąpienie CreateEditorParts metody tworzy obiekt ArrayList w celu zebrania co najmniej jednej kontrolki niestandardowej EditorPart , a następnie użycie listy do utworzenia EditorPartCollection obiektu.

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

Uwagi

Metoda CreateEditorParts umożliwia utworzenie kolekcji wszystkich kontrolek niestandardowych skojarzonych z kontrolką niestandardową EditorPart , WebPart kontrolką lub kontrolką EditorPartCollection użytkownika oraz zwrócenie ich jako obiektu. Kontrolka WebPartManager pobiera kolekcję i tworzy wystąpienia wszystkich EditorPart kontrolek za każdym razem, gdy kontrolka serwera przechodzi w tryb edycji.

Zazwyczaj tę metodę implementujesz w kontrolce niestandardowej WebPart , przesłaniając jej CreateEditorParts metodę. W metodzie tworzysz wystąpienia kontrolek niestandardowych EditorPart , które chcesz skojarzyć z kontrolkami, dodawaj je do EditorPartCollection obiektu, a następnie zwracasz ten obiekt. Kolekcja EditorPart kontrolek jest następnie przypisywana do EditorParts właściwości EditorZoneBase strefy.

Uwaga

Każdy EditorPart element dodawany do kolekcji EditorPart kontrolek w implementacji CreateEditorParts metody musi mieć przypisaną wartość do jej właściwości ID. W przeciwnym razie wyjątek zostanie zgłoszony, gdy kolekcja zostanie przypisana EditorParts do właściwości .

Uwagi dotyczące implementowania

EditorPartCollection Obiekt zwracany przez CreateEditorParts() metodę jest tylko do odczytu i nie ma dostępnej metody dodawania do niej poszczególnych kontrolek. Jednak w zastąpieniu lub implementacji metody można utworzyć inny rodzaj ICollection obiektu, takiego jak ArrayList, zawierający wszystkie kontrolki niestandardowe EditorPart , i przekazać go do konstruktora podczas tworzenia nowego EditorPartCollection obiektu. Aby zapoznać się z przykładem kodu, zobacz sekcję Przykład.

Zobacz też

• EditorPart
• kontrolki składników Web Part ASP.NET