Freigeben über

WebPartChrome.Zone Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Ruft einen Verweis auf die zugeordnete WebPartZoneBase-Zone ab.

protected:
 property System::Web::UI::WebControls::WebParts::WebPartZoneBase ^ Zone { System::Web::UI::WebControls::WebParts::WebPartZoneBase ^ get(); };
protected System.Web.UI.WebControls.WebParts.WebPartZoneBase Zone { get; }
member this.Zone : System.Web.UI.WebControls.WebParts.WebPartZoneBase
Protected ReadOnly Property Zone As WebPartZoneBase

Eigenschaftswert

WebPartZoneBase

Ein Verweis auf ein WebPartZoneBase-Objekt, das dem WebPartChrome-Objekt zugeordnet ist.

Beispiele

In diesem Codebeispiel wird die Verwendung der Zone -Eigenschaft veranschaulicht. Den vollständigen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Abschnitt Beispiel des WebPartChrome Themas Klassenübersicht.

Im folgenden Codebeispiel wird die Zone -Eigenschaft verwendet, um zu bestimmen, ob die dem Objekt derzeit zugeordnete WebPartChrome Zone eine Zone vom Typ MyZoneist. In diesem Fall wird der Inhalt des Steuerelements gerendert. Dieser Code würde verhindern, dass das benutzerdefinierte WebPartChrome Objekt mit einer anderen Zone außer der zum Erstellen einer Instanz des Objekts arbeitet.

protected override void RenderPartContents(HtmlTextWriter writer, 
  WebPart part)
{

    if (part == this.WebPartManager.SelectedWebPart)
      HttpContext.Current.Response.Write("<span>Not rendered</span>");
    else
      if(this.Zone.GetType() == typeof(MyZone))
        part.RenderControl(writer);
}

Protected Overrides Sub RenderPartContents _
  (ByVal writer As HtmlTextWriter, ByVal part As WebPart)

  If part Is Me.WebPartManager.SelectedWebPart Then
    HttpContext.Current.Response.Write("<span>Not rendered</span>")
  Else
    If (Me.Zone.GetType() Is GetType(MyZone)) Then
      part.RenderControl(writer)
    End If
  End If

End Sub

Wenn Sie die Webseite in einem Browser laden, wird der Inhalt jedes Steuerelements normal gerendert. Sie können die Seite in den Entwurfsmodus wechseln, indem Sie im Dropdownlistensteuerelement Anzeigemodus die Option Entwurf auswählen. Wenn Sie eines der Steuerelemente in die leere Zone mit der Bezeichnung WebPartZone2 ziehen, wird dessen Inhalt anders gerendert, da das benutzerdefinierte WebPartChrome Objekt nicht für das Rendering verwendet wird. Dies ist derselbe Effekt, den Sie aufgrund des vorherigen Quellcodes erzielen würden, wenn Sie versuchen würden, die benutzerdefinierte WebPartChrome Klasse mit einer anderen Zone neben der MyZone -Klasse zu verwenden.

Hinweise

Die Zone -Eigenschaft stellt einen Verweis auf die WebPartZoneBase Zone bereit, die die Steuerelemente enthält, für die das WebPartChrome Objekt renderingt.

Gilt für:

Weitere Informationen