IWebEditable.CreateEditorParts Methode

Referenz

Definition

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

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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 Themas Klassenübersicht.

Das Codebeispiel enthält beide Member der IWebEditable Schnittstelle. Beachten Sie, dass die Außerkraftsetzung der CreateEditorParts -Methode ein erstellt, ArrayList um ein oder mehrere benutzerdefinierte EditorPart Steuerelemente zu sammeln, und dann die Liste verwendet, um das EditorPartCollection -Objekt zu erstellen.

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 CreateEditorParts der -Methode können Sie eine Auflistung aller benutzerdefinierten EditorPart Steuerelemente erstellen, die Ihrem benutzerdefinierten 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 in den Bearbeitungsmodus wechselt.

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

Hinweis

Alle EditorPart , die der Auflistung von EditorPart Steuerelementen in einer Implementierung der -Methode hinzugefügt werden, müssen über einen Wert verfügen, der CreateEditorParts ihrer ID-Eigenschaft zugewiesen ist. Andernfalls wird eine Ausnahme ausgelöst, wenn die Auflistung der EditorParts -Eigenschaft zugewiesen wird.

Hinweise für Ausführende

Das EditorPartCollection von der CreateEditorParts() Methode zurückgegebene Objekt ist schreibgeschützt und verfügt über keine zugängliche Methode zum Hinzufügen einzelner Steuerelemente. In Der Außerkraftsetzung oder Implementierung der -Methode können Sie jedoch eine andere Art von ICollection Objekt erstellen, z. B. ein ArrayList-Objekt, das alle benutzerdefinierten EditorPart Steuerelemente enthält, und sie an den Konstruktor übergeben, wenn Sie ein neues EditorPartCollection Objekt erstellen. Ein Codebeispiel finden Sie im Abschnitt Beispiel.

Gilt für:

Teilen über