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