WebPart.IsShared Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Ottiene un valore che indica se un controllo WebPart è condiviso, ovvero se è visibile a tutti gli utenti di una pagina Web part.

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

Valore della proprietà

Boolean

true se il controllo WebPart presenta una visibilità condivisa in una pagina Web. In caso contrario, false. Il valore predefinito è false.

Attributi
BrowsableAttribute

Esempio

Nell'esempio di codice seguente viene illustrato l'uso IsShared della proprietà per un controllo di Web part personalizzato. In questo esempio si presuppone l'uso di un controllo personalizzato, , TextDisplayWebPartcreato nella sezione Esempio della panoramica della WebPart classe.

Quando si carica la pagina Web in un browser e si fa clic sul pulsante Controlla condivisione , il codice controlla la IsShared proprietà nel controllo e il valore della proprietà TextDisplayWebPart è , perché il controllo viene truefatto riferimento come controllo statico nel markup dichiarativo della pagina.

<%@ 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>

Commenti

Un controllo Web part condiviso è visibile a tutti gli utenti di una pagina Web. L'opposto di un controllo condiviso è un controllo per utente, che è specifico dell'utente ed è visibile solo all'utente che ha aggiunto tale controllo a una pagina.

Se viene aggiunto un controllo dinamico mentre un utente visualizza la pagina nell'ambito di personalizzazione condivisa, il controllo verrà condiviso. Se il controllo viene aggiunto mentre l'utente si trova nell'ambito della personalizzazione utente, il IsShared valore della proprietà per tale controllo sarà false.

Per altre informazioni sui controlli condivisi e per utente, vedere Panoramica della personalizzazione Web part.

Si applica a

Vedi anche