WebZone.BackImageUrl Propriedade

Referência

Definição

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

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém ou define a URL de uma imagem da tela de fundo para uma zona.

public:
 virtual property System::String ^ BackImageUrl { System::String ^ get(); void set(System::String ^ value); };

public virtual string BackImageUrl { get; set; }

member this.BackImageUrl : string with get, set

Public Overridable Property BackImageUrl As String

Valor da propriedade

String

Uma cadeia de caracteres que representa a URL para uma imagem usada como uma imagem de plano de fundo para a zona. O valor padrão é uma cadeia de caracteres vazia ("").

Exemplos

O exemplo de código a seguir demonstra o uso da BackImageUrl propriedade. Observe que há duas zonas na marcação declarativa e que o segundo <asp:webpartzone> elemento está vazio.

<%@ page language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server">
        <zonetemplate>
          <asp:Calendar ID="cal1" Runat="server" Title="My Calendar" />
        </zonetemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server" 
      BackImageUrl="image.GIF">
    </asp:webpartzone>
  </form>
</body>
</html>

<%@ page language="VB" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server">
        <zonetemplate>
          <asp:Calendar ID="cal1" Runat="server" Title="My Calendar" />
        </zonetemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server" 
      BackImageUrl="image.GIF">
    </asp:webpartzone>
  </form>
</body>
</html>

Em um navegador, você pode alternar para o modo de design para ver a imagem na zona vazia. Observe que uma URL real para a BackImageUrl propriedade não é fornecida neste exemplo. Para obter detalhes sobre como alterar os modos de exibição da página, consulte Passo a passo: Alterando os modos de exibição em uma página de Web Parts.

Comentários

A imagem de fundo de uma zona é visível em todos os modos de exibição nos quais o conteúdo de uma zona está visível. Se uma zona contiver controles de parte, a imagem será exibida atrás dos controles. Se uma zona não contiver controles, seu conteúdo não será renderizado no modo de navegação, portanto, a imagem não será exibida.

Se a imagem fornecida for menor que o corpo de uma zona, ela será em bloco para cobrir a área do corpo inteiro.

Aplica-se a

Confira também

Controles de ASP.NET Web Parts

Share via