WebPartChrome.Zone Propriedade

Definição

Obtém uma referência à zona WebPartZoneBase associada.Gets a reference to the associated WebPartZoneBase zone.

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 uma WebPartZoneBase que está associada ao WebPartChrome .A reference to a WebPartZoneBase that is associated with the WebPartChrome.

Exemplos

Este exemplo de código demonstra o uso da Zone propriedade.This code example demonstrates use of the Zone property. Para obter o código completo necessário para executar o exemplo, consulte a seção de exemplo do WebPartChrome tópico Visão geral da classe.For the full code required to run the example, see the Example section of the WebPartChrome class overview topic.

O exemplo de código a seguir usa a Zone propriedade para determinar se a zona associada atualmente ao WebPartChrome objeto é uma zona do tipo MyZone .The following code example uses the Zone property to determine whether the zone currently associated with the WebPartChrome object is a zone of type MyZone. Nesse caso, o conteúdo do controle é renderizado.If so, the control's contents are rendered. Esse código impediria que o WebPartChrome objeto personalizado funcionasse com qualquer outra zona além da criada para criar uma instância dele.This code would prevent the custom WebPartChrome object from working with any other zone besides the one designed to create an instance of it.

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.If you load the Web page in a browser, the content of each control is rendered normally. Você pode alternar a página para o modo de design selecionando design no controle de lista suspensa modo de exibição .You can switch the page into design mode by selecting Design in the Display Mode drop-down list control. Se você arrastar um dos controles para a zona vazia chamada WebPartZone2, seu conteúdo será renderizado de forma diferente, porque o WebPartChrome objeto personalizado não está sendo usado para a renderização.If you drag one of the controls into the empty zone labeled WebPartZone2, its contents are rendered differently, because the custom WebPartChrome object is not being used for the rendering. Esse é o mesmo efeito que você obteria se tentasse usar a classe personalizada WebPartChrome com qualquer outra zona além da MyZone classe, devido ao código-fonte anterior.This is the same effect that you would achieve if you tried to use the custom WebPartChrome class with any other zone besides the MyZone class, because of the preceding source code.

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.The Zone property provides a reference to the WebPartZoneBase zone that contains the controls for which the WebPartChrome object provides rendering.

Aplica-se a

Confira também