Język

WebPartZoneCollection Konstruktory

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls.WebParts
Zestaw:
System.Web.dll

Inicjuje nowe wystąpienie klasy WebPartZoneCollection.

Przeciążenia

Nazwa Opis
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, aby utworzyć kolekcję 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 WebPartZoneCollection klasy dla strony składników Web Part.

Zobacz też

Dotyczy

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

ICollection Obiekt WebPartZone .

Wyjątki

ArgumentNullException

Kolekcja stref to null.

ArgumentException

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

Przykłady

W poniższym przykładzie kodu pokazano 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ć po 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. Spowoduje to zmianę sposobu 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. Można na przykład uzyskać dostęp do Zones właściwości i utworzyć podzbiór WebPartZone obiektów na stronie składników Web Part, przypisać je do WebPartZoneCollection obiektu, a następnie wykonać operacje na kontrolkach podrzędnych lub różnych właściwościach tylko tego podzestawu stref.

Zobacz też

Dotyczy