EditorZoneBase.EditorParts Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar en samling av alla EditorPart kontroller som finns i en EditorZoneBase zon.
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.EditorPartCollection
Public ReadOnly Property EditorParts As EditorPartCollection
Egenskapsvärde
En EditorPartCollection som innehåller alla enskilda EditorPart kontroller i en zon.
- Attribut
Undantag
En EditorPart som läggs till i samlingen har inte ett värde som tilldelats dess ID-egenskap.
Exempel
Följande kodexempel visar hur du kommer åt EditorParts egenskapen programmatiskt. Fullständig kod som krävs för att köra exemplet finns i avsnittet Exempel i EditorZoneBase avsnittet klassöversikt.
Den första delen av kodexemplet visar att EditorParts egenskapen innehåller referenser till alla EditorPart kontroller som refereras deklarativt på webbsidan.
<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>
Den andra delen av kodexemplet kommer programmatiskt åt EditorParts egenskapen och visar ID:t för varje kontroll i en Label kontroll.
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
När du läser in sidan i en webbläsare kan du klicka på knappen Visa redigerareDelsamling för att visa ID:t för alla EditorPart kontroller som refereras till i EditorParts egenskapen.
Kommentarer
Egenskapen EditorParts innehåller en referens till en samling av alla EditorPart kontroller i zonen. Den refererar till både de EditorPart kontroller som tillhandahålls med kontrolluppsättningen Webbdelar och eventuella anpassade EditorPart kontroller som läggs till i zonen. Eftersom samlingen är skrivskyddad bör utvecklare som vill skapa anpassade EditorPart kontroller i allmänna redigeringssyften och lägga till dem i samlingen åsidosätta CreateEditorParts metoden.
Om du utformar anpassade EditorPart kontroller för att redigera en specifik WebPart kontroll bör du åsidosätta medlemmarna IWebEditable i gränssnittet – CreateEditorParts metoden och WebBrowsableObject egenskapen – i WebPart kontrollen. Anledningen till att åsidosätta dessa medlemmar är att aktivera din WebPart kontroll för att skapa anpassade EditorPart kontroller och lägga till dem i EditorParts samlingen när kontrollen redigeras, och för att ge redigeringskontrollerna en objektreferens till den WebPart kontroll som de redigerar. Om du vill lägga till en anpassad EditorPart kontroll för att redigera en serverkontroll som inte ärver från WebPart klassen måste du implementera IWebEditable gränssnittet i klassen precis som för en WebPart kontroll.
Note
Observera att alla EditorPart som läggs till i samlingen med EditorPart kontroller i en implementering av CreateEditorParts metoden måste ha ett värde som tilldelats dess ID-egenskap, annars genereras ett undantag när samlingen tilldelas egenskapen EditorParts .