WebPartChrome.Zone Propriedade

Definição

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Obtém uma referência à zona WebPartZoneBase associada.

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 da propriedade

WebPartZoneBase

Uma referência a um WebPartZoneBase associado ao WebPartChrome.

Exemplos

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

O exemplo de código a seguir usa a Zone propriedade para determinar se a zona atualmente associada ao WebPartChrome objeto é uma zona do tipo MyZone. Nesse caso, o conteúdo do controle será renderizado. Esse código impediria que o objeto personalizado WebPartChrome funcionasse com qualquer outra zona além daquela projetada para criar uma instância dele.

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 você carregar a página da Web em um navegador, o conteúdo de cada controle será renderizado normalmente. Você pode alternar a página para o modo de design selecionando Design no controle de lista suspensa Modo de Exibição . Se você arrastar um dos controles para a zona vazia rotulada WebPartZone2, seu conteúdo será renderizado de forma diferente, pois o objeto personalizado WebPartChrome não está sendo usado para a renderização. Esse é o mesmo efeito que você alcançaria se tentasse usar a classe personalizada WebPartChrome com qualquer outra zona além da MyZone classe, devido ao código-fonte anterior.

Comentários

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

Confira também

• WebPartZoneBase
• controles de Web Parts ASP.NET