IWebEditable.CreateEditorParts Methode

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Gibt eine Auflistung von benutzerdefinierten EditorPart-Steuerelementen zurück, die einem Serversteuerelement zugeordnet wird, das die IWebEditable-Schnittstelle implementiert.

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

Gibt zurück

EditorPartCollection

Eine EditorPartCollection, die die Auflistung der einem Serversteuerelement zugeordneten benutzerdefinierten EditorPart-Steuerelemente enthält.

Beispiele

Im folgenden Codebeispiel wird eine Außerkraftsetzung der CreateEditorParts Methode in einem benutzerdefinierten WebPart Steuerelement veranschaulicht. Der vollständige Quellcode, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Abschnitt "Beispiel" des IWebEditable Klassenübersichtsthemas.

Das Codebeispiel enthält beide Member der IWebEditable Schnittstelle. Beachten Sie, dass die Außerkraftsetzung der CreateEditorParts Methode ein ArrayList oder mehrere benutzerdefinierte EditorPart Steuerelemente erstellt und dann die Liste zum Erstellen des EditorPartCollection Objekts verwendet.

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

Hinweise

Mit der CreateEditorParts Methode können Sie eine Auflistung aller benutzerdefinierten Steuerelemente erstellen, die Ihrem benutzerdefinierten EditorPart Steuerelement, WebPart Steuerelement oder Benutzersteuerelement zugeordnet sind, und sie als EditorPartCollection Objekt zurückgeben. Das WebPartManager Steuerelement übernimmt die Auflistung und erstellt Instanzen aller EditorPart Steuerelemente, wenn das Serversteuerelement den Bearbeitungsmodus eingibt.

In der Regel implementieren Sie diese Methode in einem benutzerdefinierten WebPart Steuerelement, indem Sie die CreateEditorParts Methode außer Kraft setzen. In der Methode erstellen Sie Instanzen der benutzerdefinierten EditorPart Steuerelemente, die Sie Ihren Steuerelementen zuordnen möchten, fügen Sie sie zu einem EditorPartCollection Objekt hinzu, und geben Sie dieses Objekt zurück. Die Sammlung von EditorPart Steuerelementen wird dann der EditorParts Eigenschaft der EditorZoneBase Zone zugewiesen.

Hinweis

Jedes EditorPart Element, das der Auflistung von EditorPart Steuerelementen in einer Implementierung der CreateEditorParts Methode hinzugefügt wird, muss dem ID-Eigenschaft einen Wert zugewiesen haben, andernfalls wird eine Ausnahme ausgelöst, wenn die Auflistung der EditorParts Eigenschaft zugewiesen wird.

Hinweise für Ausführende

Das EditorPartCollection objekt, das die CreateEditorParts() Methode zurückgibt, ist schreibgeschützt und verfügt über keine barrierefreie Methode, um einzelne Steuerelemente hinzuzufügen. In Ihrer Außerkraftsetzung oder Implementierung der Methode können Sie jedoch eine andere Art von ICollection Objekt erstellen, z. B. ein ArrayList, um alle benutzerdefinierten EditorPart Steuerelemente zu enthalten und ihn beim Erstellen eines neuen EditorPartCollection Objekts an den Konstruktor zu übergeben. Ein Codebeispiel finden Sie im Abschnitt "Beispiel".

Gilt für

Siehe auch