WebPartDisplayMode Klasse

Definition

Definiert eine Standardmenge von Eigenschaften für die verschiedenen Anzeigemodi, die eine Webpartsseite aufweisen kann.Defines a common set of properties for the several display modes that a Web Parts page can enter.

public ref class WebPartDisplayMode abstract
public abstract class WebPartDisplayMode
type WebPartDisplayMode = class
Public MustInherit Class WebPartDisplayMode
Vererbung
WebPartDisplayMode

Beispiele

Die folgenden Codebeispiele veranschaulichen die deklarative Verwendung der Anzeigemodi auf einer Webparts Seite.The following code examples demonstrate the declarative use of display modes on a Web Parts page. Jeder dieser Anzeigemodi, die vom Webparts-Steuerelement Satz implementiert werden, wird von der WebPartDisplayMode -Klasse abgeleitet.Each of these display modes, as implemented by the Web Parts control set, is derived from the WebPartDisplayMode class.

Dieses Codebeispiel besteht aus vier Teilen:This code example has four parts:

  • Ein Benutzer WebPart definiertes Steuerelement.A custom WebPart control.

  • Eine Webseite mit einer Zone zum Hosten des benutzerdefinierten Steuer Elements.A Web page with a zone to host the custom control.

  • Ein Benutzer Steuerelement, das es Benutzern ermöglicht, Anzeigemodi auf der Webseite zu ändern.A user control that enables users to change display modes on the Web page.

  • Eine Erläuterung der Funktionsweise der Seite in einem Browser.An explanation of how the page works in a browser.

Der erste Teil des Beispiels ist ein benutzerdefiniertes WebPart Steuerelement,. TextDisplayWebPartThe first part of the example is a custom WebPart control, TextDisplayWebPart. Damit das Codebeispiel ausgeführt werden kann, müssen Sie diesen Quellcode kompilieren.For the code example to run, you must compile this source code. Sie können Sie explizit kompilieren und die resultierende Assembly in den bin-Ordner der Website oder in den globalen Assemblycache einfügen.You can compile it explicitly and put the resulting assembly in your Web site's Bin folder or the global assembly cache. Alternativ dazu können Sie den Quellcode in den Ordner "App_Code" der Website einfügen, wo er zur Laufzeit dynamisch kompiliert wird.Alternatively, you can put the source code in your site's App_Code folder, where it will be dynamically compiled at run time. Eine Demonstration beider Kompilierungs Methoden finden Sie unter Exemplarische Vorgehensweise: Entwickeln und Verwenden eines benutzerdefinierten Webserver-Steuer Elements.For a demonstration of both methods of compiling, see Walkthrough: Developing and Using a Custom Web Server Control.

using System;
using System.Security.Permissions;
using System.Web;
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 TextDisplayWebPart : WebPart
  {
    private String _contentText = null;
    TextBox input;
    Label DisplayContent;
    const string _subTitle = "Contoso, Ltd";

    public TextDisplayWebPart()
    {
      this.AllowClose = false;
    }

    [
      Personalizable(PersonalizationScope.User, true),
      WebBrowsable()
    ]
    public String ContentText
    {
      get { return _contentText; }
      set { _contentText = value; }
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      DisplayContent.BackColor = 
        System.Drawing.Color.LightBlue;
      DisplayContent.Text = this.ContentText;
      this.Controls.Add(DisplayContent);
      input = new TextBox();
      this.Controls.Add(input);
      Button update = new Button();
      update.Text = "Set Label Content";
      update.Click += new EventHandler(this.submit_Click);
      this.Controls.Add(update);
      ChildControlsCreated = true;
    }

    private void submit_Click(object sender, EventArgs e)
    {
      // Update the label string.
      if (!string.IsNullOrEmpty(input.Text))
      {
        this.ContentText = Page.Server.HtmlEncode(input.Text) + @"<br />";
        // Clear the input textbox.
        input.Text = String.Empty;
        DisplayContent.Text = this.ContentText;
      }
    }
  }
}
Imports System.Security.Permissions
Imports System.Web
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 TextDisplayWebPart
    Inherits WebPart
    Private _contentText As String = Nothing
    Private input As TextBox
    Private DisplayContent As Label
    
    
    Public Sub New() 
      Me.AllowClose = False
    End Sub
    
    <Personalizable(), WebBrowsable()>  _
    Public Property ContentText() As String 
        Get
            Return _contentText
        End Get
        Set
            _contentText = value
        End Set
    End Property
     
    Protected Overrides Sub CreateChildControls() 
        Controls.Clear()
        DisplayContent = New Label()
        DisplayContent.Text = Me.ContentText
        DisplayContent.BackColor = _
          System.Drawing.Color.LightBlue
        Me.Controls.Add(DisplayContent)
        input = New TextBox()
        Me.Controls.Add(input)
        Dim update As New Button()
        update.Text = "Set Label Content"
        AddHandler update.Click, AddressOf Me.submit_Click
        Me.Controls.Add(update)
        ChildControlsCreated = True
    
    End Sub
    
    
    Private Sub submit_Click(ByVal sender As Object, _
                             ByVal e As EventArgs) 
        ' Update the label string.
        If input.Text <> String.Empty Then
            Me.ContentText = Page.Server.HtmlEncode(input.Text) + "<br />"
            ' Clear the input textbox.
            input.Text = String.Empty
            DisplayContent.Text = Me.ContentText
        End If
    
    End Sub
    
End Class

End Namespace

Der zweite Teil des Code Beispiels ist eine Webseite, die auf ein Standardmäßiges ASP.net Calendar -Steuerelement <asp:webpartzone> in einem-Element verweist, sodass das Steuerelement GenericWebPart zur Laufzeit mit einem-Steuerelement umschließt und grundlegende Webparts Funktionalität erhält.The second part of the code example is a Web page that references a standard ASP.NET Calendar control within an <asp:webpartzone> element, so that the control is wrapped with a GenericWebPart control and given basic Web Parts functionality at run time. Die Seite verweist auch auf TextDisplayWebPart das-Steuer <asp:catalogzone> Element in einem-Element, das die Möglichkeit des Endbenutzers zum Wechseln in den Katalog Modus und das Hinzufügen von Steuerelementen zur Seite veranschaulicht.The page also references the TextDisplayWebPart control within an <asp:catalogzone> element, which demonstrates the end user's ability to switch to catalog mode and add controls to the page. Die Seite enthält auch ein <asp:editorzone> -Element, mit dem Benutzer die in der <asp:webpartzone> enthaltenen Steuerelemente bearbeiten können, wenn sich die Seite im Bearbeitungsmodus befindet.The page also includes an <asp:editorzone> element, which enables users to edit the controls contained in the <asp:webpartzone> when the page is in edit mode. Im oberen Bereich der Seite finden Sie eine register -Direktive für das benutzerdefinierte Steuerelement und eine andere für das Benutzer Steuerelement.Near the top of the page are a register directive for the custom control and another one for the user control.

<%@ page language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ 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)
{
  WebPartManager1.DisplayMode = WebPartManager.CatalogDisplayMode;
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
  <title>Web Parts Display Modes</title>
</head>
<body>
  <form id="Form2" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server" BackImageUrl="~/MyImage.gif">
        <zonetemplate>
          <asp:Calendar 
            ID="Calendar1" 
            Runat="server" 
            Title="My Calendar" />
        </zonetemplate>
    </asp:webpartzone>
    <asp:WebPartZone ID="WebPartZone2" Runat="server">
    </asp:WebPartZone>
    <asp:EditorZone ID="editzone1" Runat="server">
      <ZoneTemplate>
        <asp:AppearanceEditorPart 
          ID="appearanceeditor1" 
          Runat="server" />
        <asp:LayoutEditorPart 
          ID="LayoutEditorPart1" 
          Runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <asp:CatalogZone ID="catalogzone1" Runat="server">
      <ZoneTemplate>
        <asp:DeclarativeCatalogPart 
          ID="declarativepart1" 
          Runat="server">
          <WebPartsTemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" AllowClose="true"/>  
          </WebPartsTemplate>
        </asp:DeclarativeCatalogPart>
      </ZoneTemplate>
    </asp:CatalogZone>
    <br />
    <asp:button
      id="button1"
      runat="server"
      text="Catalog Mode"
      OnClick="Button1_Click"
    />
  </form>
</body>
</html>
<%@ page language="VB" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<%@ 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 EventArgs)
  WebPartManager1.DisplayMode = WebPartManager.CatalogDisplayMode
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
  <title>Web Parts Display Modes</title>
</head>
<body>
  <form id="Form2" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server" BackImageUrl="~/MyImage.gif">
        <zonetemplate>
          <asp:Calendar 
            ID="Calendar1" 
            Runat="server" 
            Title="My Calendar" />
        </zonetemplate>
    </asp:webpartzone>
    <asp:WebPartZone ID="WebPartZone2" Runat="server">
    </asp:WebPartZone>
    <asp:EditorZone ID="editzone1" Runat="server">
      <ZoneTemplate>
        <asp:AppearanceEditorPart 
          ID="appearanceeditor1" 
          Runat="server" />
        <asp:LayoutEditorPart 
          ID="LayoutEditorPart1" 
          Runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <asp:CatalogZone ID="catalogzone1" Runat="server">
      <ZoneTemplate>
        <asp:DeclarativeCatalogPart 
          ID="declarativepart1" 
          Runat="server">
          <WebPartsTemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart"/>  
          </WebPartsTemplate>
        </asp:DeclarativeCatalogPart>
      </ZoneTemplate>
    </asp:CatalogZone>
    <br />
    <asp:button
      id="button1"
      runat="server"
      text="Catalog Mode"
      OnClick="Button1_Click"
    />
  </form>
</body>
</html>

Der dritte Teil des Code Beispiels ist ein Benutzer Steuerelement, das es Benutzern ermöglicht, Anzeigemodi auf einer Webseite zu wechseln.The third part of the code example is a user control that enables users to switch display modes on a Web page. Speichern Sie den Quellcode für dieses Steuerelement in einer Datei namens "displaymudemenucs. ascx" oder "displayjudemenuvb. ascx" (abhängig von der Sprache, die Sie für das Codebeispiel verwenden), und platzieren Sie Sie im gleichen Verzeichnis wie die Webseite.Save the source code for this control in a file named DisplayModeMenuCS.ascx or DisplayModeMenuVB.ascx (depending on which language you use for the code example), and put it in the same directory as the Web page. Weitere Informationen zu Anzeigemodi und eine Beschreibung des Quellcodes in diesem Steuerelement finden Sie im Thema Exemplarische Vorgehensweise: Ändern der Anzeigemodi auf einer WebpartsSeiteFor more details about display modes and a description of the source code in this control, see the topic Walkthrough: Changing Display Modes on a Web Parts Page.

<%@ control language="C#" classname="DisplayModeMenuCS"%>
<script runat="server">
  
 // Use a field to reference the current WebPartManager.
  WebPartManager _manager;

  void Page_Init(object sender, EventArgs e)
  {
    Page.InitComplete += new EventHandler(InitComplete);
  }  

  void InitComplete(object sender, System.EventArgs e)
  {
    _manager = WebPartManager.GetCurrentWebPartManager(Page);

    String browseModeName = WebPartManager.BrowseDisplayMode.Name;

    // Fill the dropdown with the names of supported display modes.
    foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
    {
      String modeName = mode.Name;
      // Make sure a mode is enabled before adding it.
      if (mode.IsEnabled(_manager))
      {
        ListItem item = new ListItem(modeName, modeName);
        DisplayModeDropdown.Items.Add(item);
      }
    }

    // If shared scope is allowed for this user, display the scope-switching
    // UI and select the appropriate radio button for the current user scope.
    if (_manager.Personalization.CanEnterSharedScope)
    {
      Panel2.Visible = true;
      if (_manager.Personalization.Scope == PersonalizationScope.User)
        RadioButton1.Checked = true;
      else
        RadioButton2.Checked = true;
    }
    
  }
 
  // Change the page to the selected display mode.
  void DisplayModeDropdown_SelectedIndexChanged(object sender, EventArgs e)
  {
    String selectedMode = DisplayModeDropdown.SelectedValue;

    WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
    if (mode != null)
      _manager.DisplayMode = mode;
  }

  // Set the selected item equal to the current display mode.
  void Page_PreRender(object sender, EventArgs e)
  {
    ListItemCollection items = DisplayModeDropdown.Items;
    int selectedIndex = 
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name));
    DisplayModeDropdown.SelectedIndex = selectedIndex;
  }

  // Reset all of a user's personalization data for the page.
  protected void LinkButton1_Click(object sender, EventArgs e)
  {
    _manager.Personalization.ResetPersonalizationState();
  }

  // If not in User personalization scope, toggle into it.
  protected void RadioButton1_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.Scope == PersonalizationScope.Shared)
      _manager.Personalization.ToggleScope();
  }

  // If not in Shared scope, and if user is allowed, toggle the scope.
  protected void RadioButton2_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.CanEnterSharedScope && 
        _manager.Personalization.Scope == PersonalizationScope.User)
      _manager.Personalization.ToggleScope();
  }
</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text="&nbsp;Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>
<%@ control language="vb" classname="DisplayModeMenuVB"%>
<script runat="server">
  ' Use a field to reference the current WebPartManager.
  Dim _manager As WebPartManager

  Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
    AddHandler Page.InitComplete, AddressOf InitComplete
  End Sub

  Sub InitComplete(ByVal sender As Object, ByVal e As System.EventArgs)
    _manager = WebPartManager.GetCurrentWebPartManager(Page)
      
    Dim browseModeName As String = WebPartManager.BrowseDisplayMode.Name
      
    ' Fill the dropdown with the names of supported display modes.
    Dim mode As WebPartDisplayMode
    For Each mode In _manager.SupportedDisplayModes
      Dim modeName As String = mode.Name
      ' Make sure a mode is enabled before adding it.
      If mode.IsEnabled(_manager) Then
        Dim item As New ListItem(modeName, modeName)
        DisplayModeDropdown.Items.Add(item)
      End If
    Next mode
      
    ' If shared scope is allowed for this user, display the scope-switching
    ' UI and select the appropriate radio button for the current user scope.
    If _manager.Personalization.CanEnterSharedScope Then
      Panel2.Visible = True
      If _manager.Personalization.Scope = PersonalizationScope.User Then
        RadioButton1.Checked = True
      Else
        RadioButton2.Checked = True
      End If
    End If
   
  End Sub

  ' Change the page to the selected display mode.
  Sub DisplayModeDropdown_SelectedIndexChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    Dim selectedMode As String = DisplayModeDropdown.SelectedValue   
    Dim mode As WebPartDisplayMode = _
      _manager.SupportedDisplayModes(selectedMode)
    If Not (mode Is Nothing) Then
      _manager.DisplayMode = mode
    End If

  End Sub
   
  ' Set the selected item equal to the current display mode.
  Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs)
    Dim items As ListItemCollection = DisplayModeDropdown.Items
    Dim selectedIndex As Integer = _
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name))
    DisplayModeDropdown.SelectedIndex = selectedIndex

  End Sub

  ' Reset all of a user's personalization data for the page.
  Protected Sub LinkButton1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    _manager.Personalization.ResetPersonalizationState()
    
  End Sub

  ' If not in User personalization scope, toggle into it.
  Protected Sub RadioButton1_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.Scope = PersonalizationScope.Shared Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub
   
  ' If not in Shared scope, and if user is allowed, toggle the scope.
  Protected Sub RadioButton2_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.CanEnterSharedScope AndAlso _
      _manager.Personalization.Scope = PersonalizationScope.User Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub

</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text="&nbsp;Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>

Wenn Sie die Seite in einem Browser laden, können Sie das Steuerelement Anzeigemodus -Dropdown Liste verwenden, um zu verschiedenen Anzeigemodi zu wechseln.When you load the page in a browser, you can use the Display Mode drop-down list control to switch to different display modes. Wählen Sie zum Bearbeiten von Steuerelementen im Dropdown Listen-Steuerelement die Option Bearbeiten aus.To edit controls, select Edit in the drop-down list control. Um ein bestimmtes Steuerelement zu bearbeiten, machen Sie das Verbenmenü verfügbar, indem Sie auf den Pfeil in der Titelleiste des Steuer Elements klicken und dann im Verbenmenü auf Bearbeiten klicken.To edit a specific control, expose its verbs menu by clicking the arrow in the control's title bar, and then clicking Edit in the verbs menu. Wenn sich ein Steuerelement im Bearbeitungsmodus befindet, können Sie mit den Bearbeitungs Steuerelementen, die dieser Seite hinzugefügt werden, die Darstellung und das Layout des bearbeiteten Steuer Elements ändern.When a control is in edit mode, the editing controls added to this page enable you to change the edited control's appearance and layout. Wenn Sie fertig sind, wählen Sie im Dropdown Listen-Steuerelement Anzeigemodus die Option Durchsuchen aus, um die Seite auf eine normale Ansicht zurückzusetzen.When you are finished, select Browse in the Display Mode drop-down list control to return the page to a normal view. Wechseln Sie zum Katalog Modus, um der Seite Steuerelemente hinzuzufügen.To add controls to the page, switch to catalog mode. Beachten Sie, dass Sie entweder das Dropdown Listen-Steuerelement Anzeigemodus verwenden können, oder klicken Sie auf die Schaltfläche am unteren Rand der Seite.Notice that you can either use the Display Mode drop-down list control, or click the button near the bottom of the page. Der Inline Code für die Button1_Click -Methode veranschaulicht, wie Anzeigemodi Programm gesteuert geändert werden.The inline code for the Button1_Click method demonstrates how to change display modes programmatically. Während Sie sich im Katalog Modus befinden, können Sie der Seite TextDisplayWebPart das benutzerdefinierte Steuerelement hinzufügen.While you are in catalog mode, you can add the custom TextDisplayWebPart control to the page.

Hinweise

Eine Webparts Seite kann mehrere verschiedene Anzeigemodi eingeben.A Web Parts page can enter several different display modes. In jedem Anzeigemodus werden bestimmte Elemente der Webparts-Benutzeroberfläche entweder ausgeblendet oder angezeigt, und bestimmte Arten von Benutzer Änderungen an einer Seite sind entweder aktiviert oder deaktiviert.In each display mode, certain elements of the Web Parts user interface (UI) are either hidden or displayed, and certain kinds of user modifications to a page are either enabled or disabled. Das WebPartManager -Steuerelement enthält die-Implementierung für die Anzeigemodi, die im Webparts Steuersatz verfügbar sind, und verwaltet die Anzeigemodi für eine Seite.The WebPartManager control contains the implementation for the display modes that are available in the Web Parts control set, and manages the display modes for a page.

In der folgenden Tabelle sind die Felder aufgeführt, die die verfügbaren Anzeigemodi darstellen.The following table lists fields that represent the available display modes.

AnzeigemodusDisplay mode BeschreibungDescription
BrowseDisplayMode Zeigt Webparts Steuerelemente und Benutzeroberflächen Elemente im normalen Modus an, in dem Endbenutzer eine Seite anzeigen.Displays Web Parts controls and UI elements in the normal mode in which end users view a page.
DesignDisplayMode Zeigt die Benutzeroberflächen Elemente der Zone an und ermöglicht es Benutzern, Webparts Steuerelemente zu ziehen, um das Layout einer Seite zu ändern.Displays zone UI elements and enables users to drag Web Parts controls to change the layout of a page.
EditDisplayMode Zeigt spezielle Benutzeroberflächen Elemente für die Bearbeitung an und ermöglicht es Endbenutzern, die Steuerelemente auf einer Seite zu bearbeiten.Displays special editing UI elements and enables end users to edit the controls on a page.
CatalogDisplayMode Zeigt spezielle Benutzeroberflächen Elemente für das Katalog an und ermöglicht Endbenutzern das Hinzufügen und Entfernen von Seiten Steuerelementen.Displays special catalog UI elements and enables end users to add and remove page controls.
ConnectDisplayMode Zeigt Benutzeroberflächen Elemente für besondere Verbindungen an und ermöglicht Endbenutzern das Herstellen einer Verbindung Webparts Steuerelementen.Displays special connections UI elements and enables end users to connect Web Parts controls.

Hinweise für Ausführende

Entwickler können von der WebPartDisplayMode -Klasse ableiten, um benutzerdefinierte Anzeigemodi zu erstellen.Developers can derive from the WebPartDisplayMode class to create custom display modes. Um einen benutzerdefinierten WebPartDisplayMode auf einer Webparts Seite verfügbar zu machen, müssen Sie auch von der WebPartManager -Klasse ableiten und die CreateDisplayModes() -Methode überschreiben.To make a custom WebPartDisplayMode available on a Web Parts page, you would also need to derive from the WebPartManager class, and override its CreateDisplayModes() method.

Konstruktoren

WebPartDisplayMode(String)

Initialisiert einen Wert für den Namen des Anzeigemodus.Initializes a value for the name of the display mode.

Eigenschaften

AllowPageDesign

Ruft einen Wert ab, der bestimmt, ob Benutzer das Layout einer Webpartsseite ändern können, wenn sich die Seite in einem bestimmten Anzeigemodus befindet.Gets a value that determines whether users can change the layout of a Web Parts page when the page is in a certain display mode.

AssociatedWithToolZone

Ruft einen Wert ab, der angibt, ob ein bestimmter Anzeigemodus einer Klasse zugeordnet ist, die von der ToolZone-Klasse abgeleitet ist.Gets a value that indicates whether a certain display mode is associated with a class that derives from the ToolZone class.

Name

Ruft den Namen eines Anzeigemodus ab.Gets the name of a display mode.

RequiresPersonalization

Ruft einen Wert ab, der angibt, ob für einen bestimmten Anzeigemodus die Personalisierung aktiviert sein muss.Gets a value that indicates whether a particular display mode requires personalization to be enabled.

ShowHiddenWebParts

Ruft einen Wert ab, der angibt, ob Steuerelemente angezeigt werden sollen, deren Hidden-Eigenschaft auf true festgelegt ist.Gets a value that indicates whether controls that have their Hidden property set to true should be displayed.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
IsEnabled(WebPartManager)

Ruft einen Wert ab, der angibt, ob Benutzer eine Seite personalisieren können, wenn sich die Seite in einem bestimmten Anzeigemodus befindet.Gets a value that indicates whether users can personalize a page while the page is in a certain display mode.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für:

Siehe auch