WebPartChrome.Zone Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls.WebParts
Assemblagem:
System.Web.dll

Recebe uma referência para a zona associada WebPartZoneBase .

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

Valor de Propriedade

WebPartZoneBase

Uma referência a um WebPartZoneBase que está associada ao WebPartChrome.

Exemplos

Este exemplo de código demonstra a utilização da Zone propriedade. Para o código completo necessário para executar o exemplo, consulte a secção Exemplo do WebPartChrome tópico de visão geral da aula.

O exemplo de código seguinte utiliza a Zone propriedade para determinar se a zona atualmente associada ao WebPartChrome objeto é uma zona do tipo MyZone. Se sim, o conteúdo do controlo é renderizado. Este código impediria que o objeto personalizado WebPartChrome funcionasse com qualquer outra zona que não fosse aquela concebida para criar uma instância do mesmo.

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

Se carregar a página Web num navegador, o conteúdo de cada controlo é apresentado normalmente. Pode mudar a página para o modo Design selecionando Design no controlo de lista suspensa do Modo de Exibição . Se arrastares um dos controlos para a zona vazia rotulada WebPartZone2, o seu conteúdo é renderizado de forma diferente, porque o objeto personalizado WebPartChrome não está a ser usado para a renderização. Este é o mesmo efeito que conseguirias se tentasses usar a classe personalizada WebPartChrome com qualquer outra zona que não a MyZone classe, devido ao código-fonte anterior.

Observações

A Zone propriedade fornece uma referência à WebPartZoneBase zona que contém os controlos para os quais o WebPartChrome objeto fornece renderização.

Aplica-se a

Ver também