Freigeben über

WebPart.IsShared Eigenschaft

  • Referenz

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 Webparts-Seite 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 WebPart-Steuerelement für alle Benutzer einer Webseite sichtbar ist, andernfalls false. Der Standardwert ist false.

Attribute
BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung der IsShared -Eigenschaft für ein benutzerdefiniertes Webparts-Steuerelement veranschaulicht. In diesem Beispiel wird davon ausgegangen, dass ein benutzerdefiniertes Steuerelement verwendet wird, TextDisplayWebPartdas im Abschnitt Beispiel 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 des TextDisplayWebPart Steuerelements, und der Wert der -Eigenschaft ist 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 freigegebenes Webparts-Steuerelement ist für alle Benutzer einer Webseite sichtbar. Das Gegenteil eines freigegebenen Steuerelements ist ein Benutzersteuerelement, das benutzerspezifisch ist und nur für den Benutzer sichtbar ist, der dieses Steuerelement einer Seite hinzugefügt hat.

Wenn ein dynamisches Steuerelement hinzugefügt wird, während ein Benutzer die Seite im freigegebenen Personalisierungsbereich 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 unter Übersicht über die Personalisierung von Webparts.

Gilt für:

Weitere Informationen