IWebEditable.CreateEditorParts Methode
Definition
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 sind, 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.EditorPartCollectionPublic Function CreateEditorParts () As EditorPartCollectionGibt zurück
Eine EditorPartCollection Auflistung von benutzerdefinierten EditorPart Steuerelementen, die einem Serversteuerelement zugeordnet sind.
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 ArrayList objekt zum Sammeln eines oder mehrerer benutzerdefinierter 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 verwendet 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 dieses Objekt zurück. Die Auflistung der EditorPart Steuerelemente wird dann der EditorParts Eigenschaft der EditorZoneBase Zone zugewiesen.
Hinweis
Alle EditorPart Elemente, die der Auflistung von EditorPart Steuerelementen in einer Implementierung der CreateEditorParts Methode hinzugefügt werden, müssen der 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 nicht über eine barrierefreie Methode zum Hinzufügen einzelner Steuerelemente. In Ihrer Außerkraftsetzung oder Implementierung der Methode können Sie jedoch eine andere Art von ICollection Objekt erstellen, z. B. ein ArrayListObjekt, das alle benutzerdefinierten EditorPart Steuerelemente enthält, und sie beim Erstellen eines neuen EditorPartCollection Objekts an den Konstruktor übergeben. Ein Codebeispiel finden Sie im Abschnitt "Beispiel".
