WebPartZoneCollection Costruttori

Definizione

Spazio dei nomi:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Inizializza una nuova istanza della classe WebPartZoneCollection.

Overload

WebPartZoneCollection()	Inizializza un'istanza vuota della classe WebPartZoneCollection.
WebPartZoneCollection(ICollection)	Inizializza una nuova istanza della classe WebPartZoneCollection passando un insieme di oggetti WebPartZone.

Commenti

Il WebPartZoneCollection costruttore viene utilizzato dal WebPartManager controllo, da altri controlli nel set di controlli Web part o dal codice per sviluppatori personalizzato, per creare una raccolta di sola lettura dei WebPartZone controlli presenti in una pagina Web part.

WebPartZoneCollection()

Inizializza un'istanza vuota della classe WebPartZoneCollection.

public:
 WebPartZoneCollection();

public WebPartZoneCollection ();

Public Sub New ()

Commenti

Il WebPartManager controllo utilizza questo costruttore all'interno del proprio costruttore per inizializzare una nuova istanza della WebPartZoneCollection classe per una pagina Web part.

Vedi anche

• controlli web part ASP.NET

WebPartZoneCollection(ICollection)

Inizializza una nuova istanza della classe WebPartZoneCollection passando un insieme di oggetti WebPartZone.

public:
 WebPartZoneCollection(System::Collections::ICollection ^ webPartZones);

public WebPartZoneCollection (System.Collections.ICollection webPartZones);

new System.Web.UI.WebControls.WebParts.WebPartZoneCollection : System.Collections.ICollection -> System.Web.UI.WebControls.WebParts.WebPartZoneCollection

Public Sub New (webPartZones As ICollection)

Parametri

webPartZones

ICollection

Oggetto ICollection di oggetti WebPartZone.

Eccezioni

ArgumentNullException

L'insieme di zone è null.

ArgumentException

Uno degli oggetti nell'insieme è null o non è di tipo WebPartZone.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso del WebPartZoneCollection costruttore . Il codice completo per l'esempio è disponibile nella sezione Esempio della panoramica della WebPartZoneCollection classe.

Nella sezione di codice seguente si noti che assegna un WebPartZoneCollection oggetto a una variabile recuperando il valore della Zones proprietà . Se si desidera, invece di assegnare tutte le zone dalla Zones proprietà , è possibile creare una matrice di WebPartZoneBase oggetti contenente un subset di tutte le zone nella pagina e assegnare la matrice a un nuovo WebPartZoneCollection oggetto.

protected void Button5_Click(object sender, EventArgs e)
{
  Label1.Text = String.Empty;

  WebPartZoneCollection zoneCollection = mgr.Zones;
  foreach (WebPartZone zone in zoneCollection)
  {

    if (zone.WebPartVerbRenderMode == WebPartVerbRenderMode.Menu)
      zone.WebPartVerbRenderMode = WebPartVerbRenderMode.TitleBar;
    else
      zone.WebPartVerbRenderMode = WebPartVerbRenderMode.Menu;
  }
}

Protected Sub Button5_Click(ByVal sender As Object, ByVal e As EventArgs)
  Label1.Text = String.Empty

  Dim zoneCollection As WebPartZoneCollection = mgr.Zones
  Dim zone As WebPartZone
  For Each zone In zoneCollection
    If zone.WebPartVerbRenderMode = WebPartVerbRenderMode.Menu Then
      zone.WebPartVerbRenderMode = WebPartVerbRenderMode.TitleBar
    Else
      zone.WebPartVerbRenderMode = WebPartVerbRenderMode.Menu
    End If
  Next zone

End Sub

Dopo aver creato la raccolta, è possibile scorrere facilmente la raccolta ed eseguire operazioni su tutte le zone contenute o il relativo contenuto. Per eseguire il codice di esempio, caricare la pagina in un browser e fare clic sul pulsante Attiva/Disattiva modalità rendering verbo in ogni zona. In questo modo viene eseguito il rendering dei verbi nella barra del titolo di ogni controllo server contenuto in una zona. I verbi possono essere visualizzati in un menu a discesa o direttamente come collegamenti nella barra del titolo.

Commenti

Usare il WebPartZoneCollection costruttore quando si desidera creare una raccolta personalizzata di oggetti per eseguire operazioni a livello di WebPartZone codice su di esse. Ad esempio, è possibile accedere alla Zones proprietà e creare un sottoinsieme di WebPartZone oggetti in una pagina web part, assegnandoli a un WebPartZoneCollection oggetto e quindi eseguire operazioni sui controlli figlio o su varie proprietà di solo tale subset di zone.

Vedi anche

• controlli web part ASP.NET