WebPart.IsShared Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает значение, указывающее, является ли WebPart элемент управления общим, то есть отображается всем пользователям страницы веб-частей.
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
Значение свойства
trueЗначение , falseесли элемент WebPart управления имеет общую видимость пользователя на веб-странице; в противном случае . Значение по умолчанию — false.
- Атрибуты
Примеры
В следующем примере кода показано использование IsShared свойства для пользовательского элемента управления веб-частей. В этом примере предполагается использование пользовательского элемента управления, TextDisplayWebPartсозданного в разделе WebPart "Пример" обзора класса.
При загрузке веб-страницы в браузере и нажатии кнопки "Проверить общий доступ ", код проверяет IsShared свойство элемента TextDisplayWebPart управления и значение свойства true, так как элемент управления ссылается как статический элемент управления в декларативной разметке страницы.
<%@ 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>
Комментарии
Элемент управления "Общие веб-части" отображается всем пользователям веб-страницы. Противоположность общему элементу управления — это элемент управления для каждого пользователя, который является конкретным пользователем и виден только пользователю, который добавил этот элемент управления на страницу.
Если динамический элемент управления добавляется, когда пользователь просматривает страницу в области общей персонализации, элемент управления будет общий. Если элемент управления добавляется, пока пользователь находится в области персонализации пользователя, IsShared значение свойства для этого элемента управления будет false.
Дополнительные сведения об общих и пользовательских элементах управления см. в обзоре персонализации веб-частей.