WebPartZoneCollection Konstruktory

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls.WebParts

Zestaw:

System.Web.dll

Inicjuje nowe wystąpienie klasy WebPartZoneCollection.

Przeciążenia

WebPartZoneCollection()	Inicjuje puste wystąpienie WebPartZoneCollection klasy.
WebPartZoneCollection(ICollection)	Inicjuje WebPartZoneCollection wystąpienie klasy, przekazując kolekcję WebPartZone obiektów.

Uwagi

Konstruktor WebPartZoneCollection jest używany przez kontrolkę WebPartManager , przez inne kontrolki w zestawie kontrolek składników Web Part lub przez niestandardowy kod dewelopera w celu utworzenia kolekcji WebPartZone kontrolek tylko do odczytu, które istnieją na stronie składników Web Part.

WebPartZoneCollection()

Inicjuje puste wystąpienie WebPartZoneCollection klasy.

public:
 WebPartZoneCollection();

public WebPartZoneCollection ();

Public Sub New ()

Uwagi

Kontrolka WebPartManager używa tego konstruktora we własnym konstruktorze, aby zainicjować nowe wystąpienie klasy dla strony składników WebPartZoneCollection Web Part.

Zobacz też

• kontrolki składników Web Part ASP.NET

WebPartZoneCollection(ICollection)

Inicjuje WebPartZoneCollection wystąpienie klasy, przekazując kolekcję WebPartZone obiektów.

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)

Parametry

webPartZones

ICollection

WebPartZone Obiekt.ICollection

Wyjątki

ArgumentNullException

Kolekcja stref to null.

ArgumentException

Jeden z obiektów w kolekcji jest null lub nie jest typu WebPartZone.

Przykłady

Poniższy przykład kodu przedstawia użycie konstruktora WebPartZoneCollection . Kompletny kod przykładu znajduje się w sekcji Przykład w przeglądzie WebPartZoneCollection klasy.

W poniższej sekcji kodu zwróć uwagę, że przypisuje WebPartZoneCollection obiekt do zmiennej, pobierając wartość Zones właściwości. Jeśli chcesz, zamiast przypisywać wszystkie strefy z Zones właściwości, możesz utworzyć tablicę WebPartZoneBase obiektów zawierających podzbiór wszystkich stref na stronie i przypisać tablicę do nowego WebPartZoneCollection obiektu.

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

Po utworzeniu kolekcji można łatwo iterować za pośrednictwem kolekcji i wykonywać operacje na wszystkich zawartych strefach lub ich zawartości. Aby wykonać przykładowy kod, załaduj stronę w przeglądarce i kliknij przycisk Przełącz tryb renderowania czasownika w każdej strefie. To alternatywne sposób renderowania czasowników na pasku tytułu każdej kontrolki serwera zawartej w strefie. Czasowniki mogą być wyświetlane w menu rozwijanym lub bezpośrednio jako linki na pasku tytułu.

Uwagi

Użyj konstruktora WebPartZoneCollection , gdy chcesz utworzyć niestandardową kolekcję WebPartZone obiektów do wykonywania na nich operacji programowych. Na przykład można uzyskać dostęp do Zones właściwości i utworzyć podzbiór WebPartZone obiektów na stronie składników Web Part, przypisując je do WebPartZoneCollection obiektu, a następnie wykonywać operacje na kontrolkach podrzędnych lub różnych właściwościach tylko tego podzestawu stref.

Zobacz też

• kontrolki składników Web Part ASP.NET