Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

WebPartManager.Personalization Propriedade

Obtém uma referência a um objeto que contém dados de personalização para uma página da Web.

Namespace:  System.Web.UI.WebControls.WebParts
Assembly:  System.Web (em System.Web. dll)

[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
public WebPartPersonalization Personalization { get; }

Valor da propriedade

Tipo: System.Web.UI.WebControls.WebParts.WebPartPersonalization

A WebPartPersonalization that contains personalization data.

The Personalization property provides a way to access the WebPartPersonalization object that is associated with a page through the WebPartManager control.Usando essa propriedade, você pode acessar os vários membros do objeto de personalização.For example, you can use the ToggleScope method to switch the page's personalization scope from shared to user scope, or vice versa.Você também pode localizar fora a atual escopo de personalização da página, se a personalização é mesmo Habilitado na página, o provedor está sendo usado para os dados de personalização e muito mais.

Note that the data referenced by the Personalization property is only the page-level personalization data that is tracked by the WebPartManager control.Control-specific personalization data, such as the values of personalizable properties on WebPart controls, is not part of the Personalization property.

Observação:

For more information on Web Parts personalization, see Visão geral sobre personalização de Web Parts.

The following code example demonstrates how to use the Personalization property programmatically.

The following Web page allows a user to enter edit mode to edit certain aspects of the Calendar control.The Toggle Scope button switches the page to user or shared personalization scope.The Edit Mode and Browse Mode buttons each switch the page into the appropriate display mode.Notice that in the <script> tag section of the file, two of the methods that handle events use the Personalization property to access useful members of the underlying object.Specifically, these methods use the ToggleScope method and the Scope property on the object accessed through the Personalization property.

<%@ Page Language= %>

<!DOCTYPE html PUBLIC "-
    "http:
<script runat=>

    Button1_Click(object sender, EventArgs e)
  {
     ((mgr1.Personalization.Scope == PersonalizationScope.User)
      && (mgr1.Personalization.CanEnterSharedScope))
    {
      mgr1.Personalization.ToggleScope();
    }
      (mgr1.Personalization.Scope ==
      PersonalizationScope.Shared)
    {
      mgr1.Personalization.ToggleScope();
    }
    
    {
      
      
    }
  }

    Button2_Click(object sender, EventArgs e)
  {
    mgr1.DisplayMode = WebPartManager.EditDisplayMode;
  }

    Button3_Click(object sender, EventArgs e)
  {
    mgr1.DisplayMode = WebPartManager.BrowseDisplayMode;
  }

    Page_Load(object sender, EventArgs e)
  {
    Label1.Text = 
      + mgr1.Personalization.Scope.ToString();
  }
</script>

<html xmlns="http:
<head id= runat=>
    <title>ASP.NET Example</title>
</head>
<body>
    <form id= runat=>
    <div>
      <asp:WebPartManager ID= runat= />
      <asp:WebPartZone ID= runat=>
        <ZoneTemplate>
          <asp:Calendar ID= runat= />
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:EditorZone ID= runat=>
        <ZoneTemplate>
          <asp:AppearanceEditorPart ID= 
            runat=  />
          <asp:BehaviorEditorPart ID= 
            runat= />
        </ZoneTemplate>
      </asp:EditorZone>
      <hr />
      <asp:Button ID= runat= Text= OnClick=  />
      <asp:Button ID= runat= Text= OnClick= />
      <asp:Button ID= runat= Text= OnClick= />
      <br />
      <asp:Label ID= runat= Text= />
     </div>
     </form>
</body>
</html>


Para que o exemplo de código executado, você também deve habilitar um usuário ou usuários personalizar páginas no escopo compartilhada.Add an entry to the Web.config file, within the <system.web> section, that looks like the following markup.

<webParts>
  <personalization>
    <authorization>
      <allow
        users="[Replace the text and brackets with a user name or 
           group.]"
        roles="admin" 
        verbs="enterSharedScope"  />
    </authorization>
  </personalization>
</webParts> 

After you load the page in a browser, click the Toggle Scope button, and notice that the page now says the scope is shared.Click Edit Mode to change the display mode, click the verbs menu on the visible control, and select Edit from the menu.Observe que a interface do usuário (UI) para ambos os controles de edição aparece.Now click Browse Mode to return to normal browsing.If the page says it is in shared scope, click Toggle Scope again to ensure the page is in user scope.Next, follow the same steps to edit the control again, but notice that now in the editing UI, the BehaviorEditorPart control does not appear.Que é porque este Controlarar só funciona quando a página está no escopo de personalização compartilhado.

Contribuições da comunidade

ADICIONAR
Mostrar: