EditorZoneBase.EditorParts Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u een verzameling van alle EditorPart besturingselementen in een EditorZoneBase zone op.
public:
property System::Web::UI::WebControls::WebParts::EditorPartCollection ^ EditorParts { System::Web::UI::WebControls::WebParts::EditorPartCollection ^ get(); };[System.ComponentModel.Browsable(false)]
public System.Web.UI.WebControls.WebParts.EditorPartCollection EditorParts { get; }[<System.ComponentModel.Browsable(false)>]
member this.EditorParts : System.Web.UI.WebControls.WebParts.EditorPartCollectionPublic ReadOnly Property EditorParts As EditorPartCollectionWaarde van eigenschap
Een EditorPartCollection met alle afzonderlijke EditorPart besturingselementen in een zone.
- Kenmerken
Uitzonderingen
Een EditorPart aan de verzameling toegevoegde waarde heeft geen waarde die is toegewezen aan de id-eigenschap.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u via programmacode toegang krijgen tot de EditorParts eigenschap. Zie de sectie Voorbeeld van het EditorZoneBase onderwerp Class Overview voor de volledige code die is vereist om het voorbeeld uit te voeren.
Het eerste deel van het codevoorbeeld laat zien dat de EditorParts eigenschap verwijzingen bevat naar alle EditorPart besturingselementen waarnaar declaratief wordt verwezen op de webpagina.
<aspSample:MyEditorZone ID="EditorZone1" runat="server">
<ApplyVerb Text="Apply Changes" />
<CancelVerb Text="Cancel Changes" />
<OKVerb Text="Finished" />
<ZoneTemplate>
<asp:AppearanceEditorPart ID="AppearanceEditorPart1"
runat="server" />
<asp:LayoutEditorPart ID="LayoutEditorPart1"
runat="server" />
</ZoneTemplate>
</aspSample:MyEditorZone>
<aspSample:MyEditorZone ID="EditorZone1" runat="server">
<ApplyVerb Text="Apply Changes" />
<CancelVerb Text="Cancel Changes" />
<OKVerb Text="Finished" />
<ZoneTemplate>
<asp:AppearanceEditorPart ID="AppearanceEditorPart1"
runat="server" />
<asp:LayoutEditorPart ID="LayoutEditorPart1"
runat="server" />
</ZoneTemplate>
</aspSample:MyEditorZone>
Het tweede deel van het codevoorbeeld opent programmatisch toegang tot de EditorParts eigenschap en vermeldt de id van elk besturingselement in een Label besturingselement.
void Button3_Click(object sender, EventArgs e)
{
Label1.Text = "<br />";
foreach (EditorPart part in EditorZone1.EditorParts)
{
Label1.Text += part.ID + "<br />";
}
}
Sub Button3_Click(ByVal sender As Object, ByVal e As EventArgs)
Label1.Text = "<br />"
Dim part As EditorPart
For Each part In EditorZone1.EditorParts
Label1.Text += part.ID + "<br />"
Next part
End Sub
Wanneer u de pagina in een browser laadt, kunt u op de knop EditorParts Collection weergeven klikken om de id's weer te geven van alle EditorPart besturingselementen waarnaar in de EditorParts eigenschap wordt verwezen.
Opmerkingen
De EditorParts eigenschap bevat een verwijzing naar een verzameling van alle EditorPart besturingselementen in de zone. Het verwijst naar de EditorPart besturingselementen die worden geleverd met de set webonderdelen en eventuele aangepaste EditorPart besturingselementen die aan de zone worden toegevoegd. Omdat de verzameling het kenmerk Alleen-lezen heeft, moeten ontwikkelaars die aangepaste EditorPart besturingselementen willen maken voor algemene bewerkingsdoeleinden en deze aan de verzameling toevoegen, de CreateEditorParts methode overschrijven.
Als u aangepaste EditorPart besturingselementen ontwerpt om een specifiek WebPart besturingselement te bewerken, moet u de leden van de IWebEditable interface overschrijven: de CreateEditorParts methode en de WebBrowsableObject eigenschap van het WebPart besturingselement. De reden om deze leden te overschrijven, is het inschakelen van uw WebPart besturingselement om de aangepaste EditorPart besturingselementen te maken en toe te voegen aan de EditorParts verzameling wanneer uw besturingselement wordt bewerkt, en om de bewerkingsbesturingselementen te voorzien van een objectverwijzing naar het WebPart besturingselement dat ze bewerken. Als u een aangepast besturingselement EditorPart wilt toevoegen om een serverbesturingselement te bewerken dat niet van de WebPart klasse overkomt, moet u de IWebEditable interface in de klasse implementeren, net zoals voor een WebPart besturingselement.
Note
Houd er rekening mee dat aan EditorPart de verzameling EditorPart besturingselementen in een implementatie van de methode een waarde moet zijn toegewezen aan de CreateEditorParts id-eigenschap, anders wordt er een uitzondering gegenereerd wanneer de verzameling wordt toegewezen aan de EditorParts eigenschap.
