Freigeben über

WebPart.IsShared Eigenschaft

Definition

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

Ruft einen Wert ab, der angibt, ob ein WebPart Steuerelement freigegeben ist, was bedeutet, dass es für alle Benutzer einer Webpartseite sichtbar ist.

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

Eigenschaftswert

Boolean

true wenn das Steuerelement die Sichtbarkeit des WebPart Benutzers auf einer Webseite freigegeben hat; andernfalls false. Der Standardwert ist false.

Attribute
BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung der IsShared Eigenschaft für ein benutzerdefiniertes Webpart-Steuerelement veranschaulicht. In diesem Beispiel wird davon ausgegangen, dass ein benutzerdefiniertes Steuerelement verwendet wird, TextDisplayWebPartdas im Beispielabschnitt der WebPart Klassenübersicht erstellt wurde.

Wenn Sie die Webseite in einem Browser laden und auf die Schaltfläche " Freigabe überprüfen " klicken, überprüft der Code die IsShared Eigenschaft für das TextDisplayWebPart Steuerelement, und der Wert der Eigenschaft lautet true, da auf das Steuerelement im deklarativen Markup der Seite als statisches Steuerelement verwiesen wird.

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

Hinweise

Ein steuerelement für freigegebene Webparts ist für alle Benutzer einer Webseite sichtbar. Das Gegenteil eines freigegebenen Steuerelements ist ein benutzerspezifisches Steuerelement, das benutzerspezifisch ist und nur für den Benutzer sichtbar ist, der dieses Steuerelement zu einer Seite hinzugefügt hat.

Wenn ein dynamisches Steuerelement hinzugefügt wird, während ein Benutzer die Seite im Bereich der gemeinsamen Personalisierung anzeigt, wird das Steuerelement freigegeben. Wenn das Steuerelement hinzugefügt wird, während sich der Benutzer im Benutzerpersonalisierungsbereich befindet, lautet falseder IsShared Eigenschaftswert für dieses Steuerelement.

Weitere Informationen zu freigegebenen und benutzerspezifischen Steuerelementen finden Sie in der Übersicht über die Webparts-Personalisierung.

Gilt für:

Weitere Informationen