WebPart.IsShared Propriété

Référence

Définition

Espace de noms:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient une valeur qui indique si un contrôle WebPart est partagé, ce qui signifie qu'il est visible par tous les utilisateurs d'une page 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

Valeur de propriété

Boolean

true si le contrôle WebPart a une visibilité utilisateur partagée sur une page Web ; sinon, false. La valeur par défaut est false.

Attributs: BrowsableAttribute

Exemples

L’exemple de code suivant illustre l’utilisation de la IsShared propriété pour un contrôle WebPart personnalisé. Cet exemple suppose l’utilisation d’un contrôle personnalisé, TextDisplayWebPart, créé dans la section Exemple de la vue d’ensemble de la WebPart classe.

Lorsque vous chargez la page Web dans un navigateur et cliquez sur le bouton Vérifier le partage, le code vérifie la IsShared propriété sur le TextDisplayWebPart contrôle et la valeur de la propriété est true, car le contrôle est référencé en tant que contrôle statique dans le balisage déclaratif de la page.

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

Remarques

Un contrôle De composants WebPart partagé est visible par tous les utilisateurs d’une page Web. L’opposé d’un contrôle partagé est un contrôle par utilisateur, qui est spécifique à l’utilisateur et n’est visible que par l’utilisateur qui a ajouté ce contrôle à une page.

Si un contrôle dynamique est ajouté alors qu’un utilisateur affiche la page dans l’étendue de personnalisation partagée, le contrôle est partagé. Si le contrôle est ajouté alors que l’utilisateur se trouve dans l’étendue de personnalisation de l’utilisateur, la valeur de propriété IsShared de ce contrôle est false.

Pour plus d’informations sur les contrôles partagés et par utilisateur, consultez Vue d’ensemble de la personnalisation des composants WebPart.

S’applique à

Partager via