WebPartDisplayModeCollection Classe

Referência

Definição

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

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Contém uma coleção de objetos WebPartDisplayMode . Essa classe não pode ser herdada.

public ref class WebPartDisplayModeCollection sealed : System::Collections::CollectionBase

public sealed class WebPartDisplayModeCollection : System.Collections.CollectionBase

type WebPartDisplayModeCollection = class
    inherit CollectionBase

Public NotInheritable Class WebPartDisplayModeCollection
Inherits CollectionBase

Herança: Object

CollectionBase
WebPartDisplayModeCollection

Exemplos

O exemplo de código a seguir demonstra como trabalhar com a WebPartDisplayModeCollection classe . O ponto chave é que você deve herdar da WebPartManager classe e substituir o CreateDisplayModes método para adicionar um objeto personalizado WebPartDisplayMode à WebPartDisplayModeCollection coleção criada pelo WebPartManager controle .

Este exemplo de código tem cinco partes:

Um controle de usuário que permite alterar os modos de exibição em uma página de Web Parts.
Uma página da Web que hospeda os outros controles.
Um controle de usuário que reside em uma WebPartZone zona na página da Web e permite que você insira e exiba texto em um rótulo.
Um arquivo de código-fonte que contém dois controles. Um é um controle personalizado WebPartManager ; o outro é um objeto personalizado WebPartDisplayMode a ser adicionado aos modos de exibição padrão da página.
Uma explicação de como o exemplo funciona.

O código-fonte da primeira parte do exemplo de código, o controle de usuário que permite alterar os modos de exibição, vem de outro tópico. Para que este exemplo de código funcione, você precisa obter o arquivo .ascx para o controle de usuário do tópico Passo a passo : alterar modos de exibição em uma página de Web Parts e colocar o arquivo na mesma pasta que a página .aspx neste exemplo de código.

A segunda parte do exemplo é a página da Web. Ele contém dois WebPartZone controles, ambos controles de usuário e o controle personalizado WebPartManager . Observe as Register diretivas na parte superior da página para referenciar os controles de usuário e o namespace dos controles compilados.

<%@ Page Language="C#" %>
<%@ Register Src="TextDisplaycs.ascx" 
    TagName="TextDisplay" 
    TagPrefix="uc2" %>
<%@ Register Src="DisplayModeMenuCS.ascx" 
    TagName="DisplayModeMenuCS" 
    TagPrefix="uc1" %>
<%@ Register Namespace="Samples.AspNet.CS.Controls" 
    TagPrefix="sample" 
    Assembly="CustomDisplayModeCS"  %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <uc1:DisplayModeMenuCS id="menu1" runat="server" />
    <div>
    <sample:NewWebPartManager runat="server" ID="wpgm1" />
    <br />
    <table style="width: 100%">
      <tr valign="top" align="center" >
        <td style="width: 100px; height: 123px">
          <asp:WebPartZone ID="WebPartZone1" runat="server">
            <ZoneTemplate>
              <uc2:TextDisplay ID="TextDisplay1" runat="server" />
            </ZoneTemplate>
          </asp:WebPartZone>
        </td>
        <td style="width: 100px; height: 123px">
          <asp:WebPartZone ID="WebPartZone2" runat="server" />
        </td>
      </tr>
    </table>
    <br />
    </div>
    </form>
</body>
</html>

<%@ Page Language="vb" %>
<%@ Register Src="TextDisplayvb.ascx" 
    TagName="TextDisplay" 
    TagPrefix="uc2" %>
<%@ Register Src="DisplayModeMenuVB.ascx" 
    TagName="DisplayModeMenuVB" 
    TagPrefix="uc1" %>
<%@ Register Namespace="Samples.AspNet.VB.Controls" 
    TagPrefix="sample" 
    Assembly="CustomDisplayModeVB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <uc1:DisplayModeMenuVB id="menu1" runat="server" />
    <div>
    <sample:NewWebPartManager runat="server" ID="wpgm1" />
    <br />
    <table style="width: 100%">
      <tr valign="top" align="center" >
        <td style="width: 100px; height: 123px">
          <asp:WebPartZone ID="WebPartZone1" runat="server">
            <ZoneTemplate>
              <uc2:TextDisplay ID="TextDisplay1" runat="server" />
            </ZoneTemplate>
          </asp:WebPartZone>
        </td>
        <td style="width: 100px; height: 123px">
          <asp:WebPartZone ID="WebPartZone2" runat="server" />
        </td>
      </tr>
    </table>
    <br />
    </div>
    </form>
</body>
</html>

A terceira parte do exemplo é o controle de usuário para inserir e exibir texto. Observe que ele usa um MultiView controle para criar várias exibições da interface do usuário. Um modo de exibição é exibido com o botão , o outro sem. Observe que no método substituído OnPreRender , o código verifica se a página está atualmente no modo de exibição personalizado e, em caso afirmativo, exibe a primeira exibição do controle de usuário, que inclui o botão. Se a página não estiver no modo de exibição personalizado (por exemplo, se a página estiver no modo de navegação ou design), o botão ficará oculto.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma possível ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos html ou script. Para obter mais informações, consulte Visão geral de explorações de script.

<%@ Control Language="C#" %>
<%@ Import Namespace="Samples.AspNet.CS.Controls" %>
    
<script runat="server">
  private string textContent;

  [Personalizable]
  public string TextContent
  {
    get { return textContent; }
    set { textContent = value; }
  }

  protected override void OnPreRender(EventArgs e)
  {
    Label1.Text = this.textContent;
    int viewIndex = 0;

    WebPartManager wpmg = 
      WebPartManager.GetCurrentWebPartManager(this.Page);
    NewWebPartManager myNewWpmg = wpmg as NewWebPartManager;
    if (myNewWpmg != null)
    {
      WebPartDisplayMode mode = 
        myNewWpmg.SupportedDisplayModes[myNewWpmg.InLineEditDisplayMode.Name];
      if (mode != null && myNewWpmg.DisplayMode == mode)
      {
        viewIndex = 1;
      }
    }
    this.MultiView1.ActiveViewIndex = viewIndex;

  }

  protected void Button1_Click(object sender, EventArgs e)
  {
    this.TextContent = TextBox1.Text;

    WebPartManager wpmg = 
      WebPartManager.GetCurrentWebPartManager(this.Page);
    WebPartDisplayMode mode = 
      wpmg.SupportedDisplayModes[WebPartManager.BrowseDisplayMode.Name];
    if (mode != null)
      wpmg.DisplayMode = mode;
  }
  
</script>
<asp:MultiView ID="MultiView1" runat="server">
    <asp:View ID="View1" runat="server">
        <asp:Label ID="Label1" runat="server" Text="Label" />
    </asp:View>
    <asp:View ID="View2" runat="server">
        <asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
        <asp:Button ID="Button1" OnClick="Button1_Click" 
          runat="server" Text="Button" />
    </asp:View>
</asp:MultiView>

<%@ Control Language="vb" %>
<%@ Import Namespace="Samples.AspNet.VB.Controls" %>
    
<script runat="server">

  Private _textContent As String

  <Personalizable()> _
  Public Property TextContent() As String
    Get
      Return _textContent
    End Get
    Set(ByVal value As String)
      _textContent = Value
    End Set
  End Property
 
  Protected Overrides Sub OnPreRender(ByVal e As EventArgs)
    Label1.Text = Me.TextContent
    Dim viewIndex As Integer = 0
      
    Dim wpmg As WebPartManager = _
      WebPartManager.GetCurrentWebPartManager(Me.Page)
    Dim myNewWpmg As NewWebPartManager = _
      CType(wpmg, NewWebPartManager)
    If Not (myNewWpmg Is Nothing) Then
      Dim mode As WebPartDisplayMode = _
        myNewWpmg.SupportedDisplayModes(myNewWpmg.InLineEditDisplayMode.Name)
      If Not (mode Is Nothing) AndAlso _
        myNewWpmg.DisplayMode Is mode Then
        viewIndex = 1
      End If
    End If
    Me.MultiView1.ActiveViewIndex = viewIndex

  End Sub

  Protected Sub Button1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    Me.TextContent = TextBox1.Text
    Dim wpmg As WebPartManager = _
      WebPartManager.GetCurrentWebPartManager(Me.Page)
    Dim mode As WebPartDisplayMode = _
      wpmg.SupportedDisplayModes(WebPartManager.BrowseDisplayMode.Name)
    If Not (mode Is Nothing) Then
      wpmg.DisplayMode = mode
    End If

  End Sub
  
</script>
<asp:MultiView ID="MultiView1" runat="server">
    <asp:View ID="View1" runat="server">
        <asp:Label ID="Label1" runat="server" Text="Label" />
    </asp:View>
    <asp:View ID="View2" runat="server">
        <asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
        <asp:Button ID="Button1" OnClick="Button1_Click" 
          runat="server" Text="Button" />
    </asp:View>
</asp:MultiView>

A quarta parte do exemplo é o arquivo de origem para as duas classes personalizadas. Observe que a classe personalizada WebPartManager substitui o CreateDisplayModes método , chama o método base para adicionar todos os modos de exibição padrão e adiciona o modo de exibição personalizado. A classe de modo de exibição personalizado, InLineEditDisplayMode, simplesmente herda de WebPartDisplayMode, define o nome do modo de exibição no construtor e substitui um número das propriedades base para estabelecer as características da exibição personalizada.

Para que o exemplo de código seja executado, você deve compilar esse código-fonte. Você pode compilá-lo explicitamente e colocar o assembly resultante na pasta Bin do site ou no cache de assembly global. Como alternativa, você pode colocar o código-fonte na pasta App_Code do site, na qual ele será compilado dinamicamente em tempo de execução. Para obter um passo a passo que demonstra como compilar, consulte Passo a passo : desenvolvendo e usando um controle de servidor Web personalizado.

using System;
using System.Collections.Generic;
using System.Configuration;
using System.Web;
using System.Web.Security;
using System.Security.Permissions;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand,
  Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class NewWebPartManager : WebPartManager 
  {
    private static readonly WebPartDisplayMode _inLineEditDisplayMode =
      new InlineWebPartEditDisplayMode();

    public NewWebPartManager() {}

    protected override WebPartDisplayModeCollection CreateDisplayModes() 
    {
      WebPartDisplayModeCollection displayModes = 
        base.CreateDisplayModes();
      displayModes.Add(_inLineEditDisplayMode);
      return displayModes;
    }

    public WebPartDisplayMode InLineEditDisplayMode
    {
      get { return _inLineEditDisplayMode; }
    }

    private sealed class InlineWebPartEditDisplayMode : WebPartDisplayMode
    {
      public InlineWebPartEditDisplayMode()
        : base("Inline Edit Display")
      {
      }
      public override bool AllowPageDesign
      {
        get { return true; }
      }
      public override bool RequiresPersonalization
      {
        get { return true; }
      }
      public override bool ShowHiddenWebParts
      {
        get { return false; }
      }
      public override bool AssociatedWithToolZone
      {
        get { return false; }
      }
      public override bool IsEnabled(WebPartManager webPartManager)
      {
        return true;
      }
    }
  }
}

Imports System.Collections.Generic
Imports System.Configuration
Imports System.Web
Imports System.Web.Security
Imports System.Security.Permissions
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class NewWebPartManager
    Inherits WebPartManager
    Private Shared _inLineEditDisplayMode As WebPartDisplayMode = _
      New InlineWebPartEditDisplayMode()

    Public Sub New()
    End Sub

    Protected Overrides Function CreateDisplayModes() As WebPartDisplayModeCollection
      Dim displayModes As WebPartDisplayModeCollection = MyBase.CreateDisplayModes()
      displayModes.Add(_inLineEditDisplayMode)
      Return displayModes

    End Function 

    Public ReadOnly Property InLineEditDisplayMode() As WebPartDisplayMode
        Get
            Return _inLineEditDisplayMode
        End Get
    End Property

    Private NotInheritable Class InlineWebPartEditDisplayMode
      Inherits WebPartDisplayMode

      Public Sub New()
        MyBase.New("Inline Edit Display")
      End Sub

      Public Overrides ReadOnly Property AllowPageDesign() As Boolean
        Get
          Return True
        End Get
      End Property

      Public Overrides ReadOnly Property RequiresPersonalization() _
        As Boolean
        Get
          Return True
        End Get
      End Property

      Public Overrides ReadOnly Property ShowHiddenWebParts() As Boolean
        Get
          Return False
        End Get
      End Property

      Public Overrides ReadOnly Property AssociatedWithToolZone() _
        As Boolean
        Get
          Return False
        End Get
      End Property

      Public Overrides Function IsEnabled(ByVal webPartManager _
        As WebPartManager) As Boolean

        Return True

      End Function

    End Class

  End Class

End Namespace

Para executar o exemplo de código, carregue a página em um navegador. Observe que a página está atualmente no modo de navegação e nenhum botão está visível. Usando o controle de lista suspensa Modo de Exibição , altere a página para Modo de Exibição de Edição Embutida e observe que agora o botão está visível no controle de usuário inferior. Adicione algum texto e clique no botão para atualizar o controle. Observe que a exibição da página é retornada para o modo de navegação, o texto inserido agora é exibido e o botão está novamente oculto porque a página não está no modo de exibição personalizado.

Comentários

A WebPartDisplayModeCollection classe foi projetada para conter uma coleção de WebPartDisplayMode objetos . Ele é usado principalmente pelo WebPartManager controle para gerenciar coleções de WebPartDisplayMode objetos.

Um modo de exibição é uma exibição especial de uma página da Web que aparece quando é atribuída como o modo de exibição atual na WebPartManager.DisplayMode propriedade . Os modos de exibição são usados no conjunto de controle de Web Parts para criar exibições de página nas quais os usuários podem realizar tarefas especiais, como editar controles ou reorganizar o layout de uma página. O WebPartManager controle define vários modos de exibição, incluindo BrowseDisplayMode, DesignDisplayMode, EditDisplayMode, CatalogDisplayModee ConnectDisplayMode. A coleção de modos de exibição é referenciada pela WebPartManager.DisplayModes propriedade .

Em qualquer página da Web específica que usa controles de Web Parts, apenas determinados modos de exibição estão disponíveis. O modo de navegação padrão e o modo de design estão quase sempre disponíveis, mas os outros modos de exibição só estarão disponíveis se seus tipos de zona correspondentes estiverem presentes na página. Para obter mais informações, consulte a visão geral da WebPartDisplayMode classe.

O WebPartManager controle controla os modos de exibição disponíveis em uma página com sua SupportedDisplayModes propriedade . Essa propriedade faz referência a um WebPartDisplayModeCollection objeto que contém todos os modos de exibição com suporte.

A WebPartDisplayModeCollection classe não tem um construtor exposto, portanto, você não pode criar sua própria nova instância dele. Se você criar um objeto personalizado WebPartDisplayMode e quiser que ele faça parte da coleção de modos de exibição com suporte no controle , você deverá herdar da WebPartManager classe , substituir o CreateDisplayModes método , chamar o método base para criar a coleção e, em WebPartManager seguida, adicionar todos os modos de exibição personalizados à coleção usando seu Add método .

A WebPartDisplayModeCollection classe tem duas propriedades públicas. A IsReadOnly propriedade é uma propriedade somente leitura que indica se a coleção é somente leitura. A propriedade sobrecarregada Item[] fornece acesso aos membros da coleção.

A WebPartDisplayModeCollection classe também tem vários métodos. O Add método, já mencionado, permite adicionar WebPartDisplayMode objetos à coleção. O Contains método determina se existe um modo de exibição específico na coleção. O CopyTo método copia a coleção para uma matriz de objetos . O IndexOf método retorna o índice de um modo de exibição específico dentro da coleção. Por fim, o Insert método permite que você insira um objeto de modo de exibição em um índice específico na coleção.

Propriedades

Capacity	Obtém ou define o número de elementos que o CollectionBase pode conter. (Herdado de CollectionBase)
Count	Obtém o número de elementos contidos na instância de CollectionBase. Essa propriedade não pode ser substituída. (Herdado de CollectionBase)
InnerList	Obtém uma ArrayList que contém a lista de elementos na instância de CollectionBase. (Herdado de CollectionBase)
IsReadOnly	Obtém um valor que indica se a coleção é somente leitura.
Item[Int32]	Obtém um membro específico da coleção de acordo com seu índice.
Item[String]	Obtém um membro específico da coleção de acordo com um identificador exclusivo.
List	Obtém uma IList que contém a lista de elementos na instância de CollectionBase. (Herdado de CollectionBase)

Métodos

Add(WebPartDisplayMode)	Adiciona um objeto de WebPartDisplayMode à coleção.
Clear()	Remove todos os objetos da instância CollectionBase. Esse método não pode ser substituído. (Herdado de CollectionBase)
Contains(WebPartDisplayMode)	Retorna um valor que indica se um objeto WebPartDisplayMode específico existe na coleção.
CopyTo(WebPartDisplayMode[], Int32)	Copia a coleção para uma matriz de objetos de WebPartDisplayMode.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetEnumerator()	Retorna um enumerador que itera pela instância CollectionBase. (Herdado de CollectionBase)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IndexOf(WebPartDisplayMode)	Retorna a posição de um membro específico da coleção.
Insert(Int32, WebPartDisplayMode)	Insere um objeto WebPartDisplayMode na coleção na posição de índice especificada.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnClear()	Executa processos personalizados adicionais ao limpar o conteúdo da instância CollectionBase. (Herdado de CollectionBase)
OnClearComplete()	Executa processos adicionais personalizados após limpar o conteúdo da instância CollectionBase. (Herdado de CollectionBase)
OnInsert(Int32, Object)	Executa os processos personalizados adicionais antes de inserir um novo elemento na instância CollectionBase. (Herdado de CollectionBase)
OnInsertComplete(Int32, Object)	Executa processos personalizados adicionais após inserir um novo elemento na instância de CollectionBase. (Herdado de CollectionBase)
OnRemove(Int32, Object)	Executa processos personalizados adicionais ao remover um elemento da instância CollectionBase. (Herdado de CollectionBase)
OnRemoveComplete(Int32, Object)	Executa processos personalizados adicionais após remover um elemento da instância de CollectionBase. (Herdado de CollectionBase)
OnSet(Int32, Object, Object)	Executa processos personalizados adicionais antes de definir um valor na instância CollectionBase. (Herdado de CollectionBase)
OnSetComplete(Int32, Object, Object)	Executa processos personalizados adicionais após configurar um valor na instância de CollectionBase. (Herdado de CollectionBase)
OnValidate(Object)	Executa processos personalizados adicionais ao validar um valor. (Herdado de CollectionBase)
RemoveAt(Int32)	Remove o elemento no índice especificado da instância CollectionBase. Este método não é substituível. (Herdado de CollectionBase)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

ICollection.CopyTo(Array, Int32)	Copia todo o CollectionBase em um Array unidimensional compatível, começando no índice especificado da matriz de destino. (Herdado de CollectionBase)
ICollection.IsSynchronized	Obtém um valor que indica se o acesso à CollectionBase é sincronizado (thread-safe). (Herdado de CollectionBase)
ICollection.SyncRoot	Obtém um objeto que pode ser usado para sincronizar o acesso ao CollectionBase. (Herdado de CollectionBase)
IList.Add(Object)	Adiciona um objeto ao final do CollectionBase. (Herdado de CollectionBase)
IList.Contains(Object)	Determina se o CollectionBase contém um elemento específico. (Herdado de CollectionBase)
IList.IndexOf(Object)	Pesquisa o Object especificado e retorna o índice de base zero da primeira ocorrência dentro de todo o CollectionBase. (Herdado de CollectionBase)
IList.Insert(Int32, Object)	Insere um elemento no CollectionBase, no índice especificado. (Herdado de CollectionBase)
IList.IsFixedSize	Obtém um valor que indica se o CollectionBase tem um tamanho fixo. (Herdado de CollectionBase)
IList.IsReadOnly	Obtém um valor que indica se o CollectionBase é somente leitura. (Herdado de CollectionBase)
IList.Item[Int32]	Obtém ou define o elemento no índice especificado. (Herdado de CollectionBase)
IList.Remove(Object)	Remove a primeira ocorrência de um objeto específico do CollectionBase. (Herdado de CollectionBase)

Métodos de Extensão

Cast<TResult>(IEnumerable)	Converte os elementos de um IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)	Filtra os elementos de um IEnumerable com base em um tipo especificado.
AsParallel(IEnumerable)	Habilita a paralelização de uma consulta.
AsQueryable(IEnumerable)	Converte um IEnumerable em um IQueryable.

Aplica-se a

Compartilhar via