EditorZoneBase.EditorParts Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Ottiene un insieme di tutti i controlli EditorPart contenuti in una zona EditorZoneBase.

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

Valore della proprietà

EditorPartCollection

Un oggetto EditorPartCollection che contiene tutti i singoli controlli EditorPart in una zona.

Attributi
BrowsableAttribute

Eccezioni

InvalidOperationException

Alla proprietà ID di un controllo EditorPart aggiunto all'insieme non è assegnato un valore.

Esempio

Nell'esempio di codice seguente viene illustrato come accedere alla EditorParts proprietà a livello di codice. Per il codice completo necessario per eseguire l'esempio, vedere la sezione Esempio dell'argomento panoramica della EditorZoneBase classe.

La prima parte dell'esempio di codice illustra che la EditorParts proprietà contiene riferimenti a tutti i EditorPart controlli a cui si fa riferimento dichiarativamente nella pagina Web.

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

La seconda parte dell'esempio di codice accede a livello di codice alla EditorParts proprietà e elenca l'ID di ogni controllo in un Label controllo.

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

Quando si carica la pagina in un browser, è possibile fare clic sul pulsante Visualizza EditorParts Collection per elencare gli ID di tutti i EditorPart controlli a cui si fa riferimento nella EditorParts proprietà.

Commenti

La EditorParts proprietà fornisce un riferimento a una raccolta di tutti i EditorPart controlli nella zona. Fa riferimento a entrambi i controlli forniti con il set di controlli Web part e a tutti i EditorPart controlli personalizzati EditorPart aggiunti alla zona. Poiché la raccolta è di sola lettura, gli sviluppatori che vogliono creare controlli personalizzati EditorPart per scopi di modifica generale e aggiungerli alla raccolta devono eseguire l'override del CreateEditorParts metodo.

Se si progettano controlli personalizzati EditorPart per modificare un controllo specifico WebPart , è necessario eseguire l'override dei membri del IWebEditable metodo interface-the-the-and-property-in-the CreateEditorPartsWebBrowsableObjectWebPart control. Il motivo per eseguire l'override di questi membri consiste nell'abilitare il WebPart controllo per creare i controlli personalizzati EditorPart e aggiungerli alla EditorParts raccolta quando il controllo viene modificato e fornire ai controlli di modifica un riferimento a un oggetto al WebPart controllo che stanno modificando. Se si vuole aggiungere un controllo personalizzato EditorPart per modificare un controllo server che non eredita dalla WebPart classe, è necessario implementare l'interfaccia IWebEditable nella classe esattamente come si vuole per un WebPart controllo.

Nota

Si noti che qualsiasi EditorPart elemento aggiunto alla raccolta di EditorPart controlli in un'implementazione del CreateEditorParts metodo deve avere un valore assegnato alla relativa proprietà ID, in caso contrario, viene generata un'eccezione quando la raccolta viene assegnata alla EditorParts proprietà.

Si applica a

Vedi anche