WebPartDisplayModeCollection.Add(WebPartDisplayMode) Methode

Definition

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

Fügt der Auflistung ein WebPartDisplayMode Objekt hinzu.

public:
 int Add(System::Web::UI::WebControls::WebParts::WebPartDisplayMode ^ value);
public int Add(System.Web.UI.WebControls.WebParts.WebPartDisplayMode value);
member this.Add : System.Web.UI.WebControls.WebParts.WebPartDisplayMode -> int
Public Function Add (value As WebPartDisplayMode) As Integer

Parameter

value
WebPartDisplayMode

A WebPartDisplayMode , das der Auflistung hinzugefügt werden soll.

Gibt zurück

Int32

Ein ganzzahliger Wert, der angibt, wo die WebPartDisplayMode Auflistung eingefügt wurde.

Beispiele

In diesem Codebeispiel wird die Verwendung der WebPartDisplayModeCollection Klasse veranschaulicht. Den vollständigen Code und die zum Ausführen des Beispiels erforderlichen Anweisungen finden Sie im Abschnitt "Beispiel" der WebPartDisplayModeCollection Klassenübersicht.

Der folgende Codeabschnitt tritt in einer abgeleiteten WebPartManager Klasse auf, die die CreateDisplayModes Methode überschreibt und der Auflistung einen benutzerdefinierten Anzeigemodus hinzufügt.

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

Hinweise

Mit der Add Methode können Sie einem vorhandenen WebPartDisplayMode Objekt neue WebPartDisplayModeCollection Objekte hinzufügen.

Ein Beispiel für ein Szenario, in dem Sie dies tun würden, ist das Erstellen einer benutzerdefinierten WebPartDisplayMode Klasse, und Sie möchten es der Auflistung der unterstützten Anzeigemodi auf einer Seite hinzufügen. Dazu müssen Sie von der WebPartManager Klasse erben und deren CreateDisplayModes Methode überschreiben, zuerst die Basismethode aufrufen und dann die Add Methode verwenden, um der Auflistung den benutzerdefinierten Anzeigemodus hinzuzufügen.

Gilt für:

Weitere Informationen