WebPart.IsShared Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene un valore che indica se un WebPart controllo è condiviso, ovvero è 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à
true se il WebPart controllo ha visibilità utente condivisa in una pagina Web; in caso contrario, false. Il valore predefinito è false.
- Attributi
Esempio
Nell'esempio di codice seguente viene illustrato l'uso della IsShared proprietà per un controllo Web part personalizzato. In questo esempio si presuppone l'uso di un controllo personalizzato, TextDisplayWebPart, creato 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 TextDisplayWebPart controllo e il valore della proprietà è true, perché il controllo viene fatto 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, specifico dell'utente ed è visibile solo all'utente che ha aggiunto tale controllo a una pagina.
Se un controllo dinamico viene aggiunto mentre un utente sta visualizzando la pagina nell'ambito della personalizzazione condivisa, il controllo verrà condiviso. Se il controllo viene aggiunto mentre l'utente è nell'ambito della personalizzazione dell'utente, il valore della IsShared proprietà per tale controllo sarà false.
Per altre informazioni sui controlli condivisi e per utente, vedere Cenni preliminari sulla personalizzazione delle web part.