WebPart.IsShared 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 um valor que indica se um controle WebPart é compartilhado, o que significa que ele é visível para todos os usuários de uma página de Web Parts.

public:
 property bool IsShared { bool get(); };

[System.ComponentModel.Browsable(false)]
public bool IsShared { get; }

[<System.ComponentModel.Browsable(false)>]
member this.IsShared : bool

Public ReadOnly Property IsShared As Boolean

Valor da propriedade

Boolean

true se o WebPart controle tiver visibilidade de usuário compartilhada em uma página da Web; caso contrário, false. O valor padrão é false.

Atributos: BrowsableAttribute

Exemplos

O exemplo de código a seguir demonstra o uso da IsShared propriedade para um controle de Web Parts personalizado. Este exemplo pressupõe o uso de um controle personalizado, TextDisplayWebPart, criado na seção Exemplo da visão geral da WebPart classe.

Quando você carrega a página da Web em um navegador e clica no botão Verificar Compartilhamento , o código verifica a IsShared propriedade no TextDisplayWebPart controle e o valor da propriedade é true, porque o controle é referenciado como um controle estático na marcação declarativa da página.

<%@ page language="C#" %>
<%@ register tagprefix="aspSample" 
             Namespace="Samples.AspNet.CS.Controls" 
             Assembly="TextDisplayWebPartCS"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

void  button1_Click(object sender, EventArgs e)
{
  if (textwebpart.IsShared)
    label1.Text = "Text WebPart control is shared.";
}
</script>
<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" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc" />
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" 
            />
        </zonetemplate>
    </asp:webpartzone>
    <asp:Button ID="button1" Runat="server" 
      OnClick="button1_Click" 
      Text="Check Sharing" 
      />
    <asp:Label ID="label1" Runat="server" />
  </form>
</body>
</html>

<%@ page language="VB" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.VB.Controls" 
  Assembly="TextDisplayWebPartVB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  Sub button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)
    If textwebpart.IsShared Then
      label1.Text = "Text WebPart control is shared."
    End If
  End Sub
</script>
<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" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc" />
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" 
            />
        </zonetemplate>
    </asp:webpartzone>
    <asp:Button ID="button1" Runat="server" 
      OnClick="button1_Click" 
      Text="Check Sharing" 
      />
    <asp:Label ID="label1" Runat="server" />
  </form>
</body>
</html>

Comentários

Um controle de Web Parts compartilhado é visível para todos os usuários de uma página da Web. O oposto de um controle compartilhado é um controle por usuário, que é específico do usuário e é visível apenas para o usuário que adicionou esse controle a uma página.

Se um controle dinâmico for adicionado enquanto um usuário estiver exibindo a página no escopo de personalização compartilhada, o controle será compartilhado. Se o controle for adicionado enquanto o usuário estiver no escopo de personalização do usuário, o valor da IsShared propriedade para esse controle será false.

Para obter mais informações sobre controles compartilhados e por usuário, consulte Visão geral de personalização de Web Parts.

Aplica-se a

Partilhar via