WebPartManager Klasse

Definition

Dient als zentrale Klasse des Webparts-Steuerelementsatzes und verwaltet alle Webparts-Steuerelemente, -Funktionen und -Ereignisse, die auf einer Webseite auftreten.

public ref class WebPartManager : System::Web::UI::Control, System::Web::UI::INamingContainer, System::Web::UI::WebControls::WebParts::IPersonalizable
[System.ComponentModel.Bindable(false)]
public class WebPartManager : System.Web.UI.Control, System.Web.UI.INamingContainer, System.Web.UI.WebControls.WebParts.IPersonalizable
[<System.ComponentModel.Bindable(false)>]
type WebPartManager = class
    inherit Control
    interface INamingContainer
    interface IPersonalizable
Public Class WebPartManager
Inherits Control
Implements INamingContainer, IPersonalizable
Vererbung
WebPartManager
Attribute
Implementiert

Beispiele

Im folgenden Codebeispiel wird sowohl die deklarative als auch die programmgesteuerte Verwendung des Steuerelements WebPartManager veranschaulicht.

Das Codebeispiel umfasst vier Teile:

  • Ein Benutzersteuerelement, mit dem Sie die Anzeigemodi auf einer Webpartseite ändern können.

  • Eine Webseite, die zwei benutzerdefinierte WebPart Steuerelemente enthält, die verbunden werden können, und ein <asp:webpartmanager> Element.

  • Eine Quellcodedatei, die zwei benutzerdefinierte WebPart Steuerelemente und eine benutzerdefinierte Schnittstelle enthält.

  • Eine Erklärung, wie das Beispiel in einem Browser funktioniert.

Das Benutzersteuerelement verfügt über ein Dropdownlistensteuerelement, das die möglichen Anzeigemodi auf einer Seite anzeigt, wenn die Webparts-Steuerelemente auf der Seite vorhanden sind. Auf der Webseite für dieses Codebeispiel wird dieses Benutzersteuerelement direkt unterhalb des WebPartManager Elements im Markup der Seite deklariert, und es gibt eine Register Direktive am oberen Rand der Webseite, um das Steuerelement zu registrieren. Ausführliche Informationen zu Anzeigemodi und eine Beschreibung des Quellcodes in diesem Steuerelement finden Sie unter Exemplarische Vorgehensweise: Ändern von Anzeigemodi auf einer Webpartseite.

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

Das deklarative Markup für die Webseite enthält Register Anweisungen sowohl für das Benutzersteuerelement als auch für die benutzerdefinierten Steuerelemente. Es gibt ein <asp:webpartmanager> Element, ein <asp:webpartzone> Element, das die benutzerdefinierten Steuerelemente enthalten soll, und ein <asp:connectionszone> Element. Die Seite enthält auch Inlinecode, der verbindungsbezogene Ereignisse für das WebPartManager Steuerelement verarbeitet. Sie können die Auswirkungen dieses Codes sehen, wenn Sie Steuerelemente verbinden und trennen.

<%@ Page Language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="ConnectionSampleCS" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
 
  private void UpdateLabelData(int wpCount, int connCount)
  {
    Label1.Text = "WebPart Control Count:  " + wpCount.ToString();
    Label2.Text = "Connections Count: " + connCount.ToString();
  }

  protected void WebPartManager1_WebPartsConnected(object sender, WebPartConnectionsEventArgs e)
  {
    UpdateLabelData(WebPartManager1.WebParts.Count,
      WebPartManager1.Connections.Count);
  }

  protected void WebPartManager1_WebPartsDisconnected(object sender, WebPartConnectionsEventArgs e)
  {
    UpdateLabelData(WebPartManager1.WebParts.Count,
      WebPartManager1.Connections.Count);
  }
  
</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">
      <!-- Reference the WebPartManager control. -->
      <asp:WebPartManager ID="WebPartManager1" runat="server"  
        OnWebPartsConnected="WebPartManager1_WebPartsConnected" 
        OnWebPartsDisconnected="WebPartManager1_WebPartsDisconnected" />
    <div>
      <uc1:DisplayModeMenuCS ID="displaymode1" runat="server" />
      <!-- Reference consumer and provider controls in a zone. -->
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:ZipCodeWebPart ID="zip1" 
            runat="server" 
            Title="Zip Code Control"/>
          <aspSample:WeatherWebPart ID="weather1" 
            runat="server" 
            Title="Weather Control" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <asp:Label ID="Label1" runat="server" Text=""></asp:Label>
      <br />
      <asp:Label ID="Label2" runat="server" Text=""></asp:Label>
      <!-- Add a ConnectionsZone so users can connect controls. -->
      <asp:ConnectionsZone ID="ConnectionsZone1" runat="server" />
    </div>
    </form>
</body>
</html>
<%@ Page Language="vb" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.VB.Controls" 
  Assembly="ConnectionSampleVB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  Protected Sub WebPartManager1_WebPartsConnected( _
    ByVal sender As Object, _
    ByVal e As System.Web.UI.WebControls.WebParts.WebPartConnectionsEventArgs)
    
    UpdateLabelData(WebPartManager1.WebParts.Count, _
      WebPartManager1.Connections.Count)
    
  End Sub

  Protected Sub WebPartManager1_WebPartsDisconnected( _
    ByVal sender As Object, _
    ByVal e As System.Web.UI.WebControls.WebParts.WebPartConnectionsEventArgs)
    
    UpdateLabelData(WebPartManager1.WebParts.Count, _
      WebPartManager1.Connections.Count)
    
  End Sub
  
  Private Sub UpdateLabelData(ByVal wpCount As Integer, _
    ByVal connCount As Integer)
    
    Label1.Text = "WebPart Control Count:  " & wpCount.ToString()
    Label2.Text = "Connections Count: " & connCount.ToString()
    
  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <!-- Reference the WebPartManager control. -->
      <asp:WebPartManager ID="WebPartManager1" runat="server" OnWebPartsConnected="WebPartManager1_WebPartsConnected" OnWebPartsDisconnected="WebPartManager1_WebPartsDisconnected" />
    <div>
      <uc1:DisplayModeMenuVB ID="displaymode1" runat="server" />
      <!-- Reference consumer and provider controls in a zone. -->
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:ZipCodeWebPart ID="zip1" 
            runat="server" 
            Title="Zip Code Control"/>
          <aspSample:WeatherWebPart ID="weather1" 
            runat="server" 
            Title="Weather Control" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <asp:Label ID="Label1" runat="server" Text=""></asp:Label>
      <br />
      <asp:Label ID="Label2" runat="server" Text=""></asp:Label>
      <!-- Add a ConnectionsZone so users can connect controls. -->
      <asp:ConnectionsZone ID="ConnectionsZone1" runat="server" />
    </div>
    </form>
</body>
</html>

Der dritte Teil des Beispiels ist der Quellcode für die Steuerelemente. Beachten Sie, dass es eine Schnittstelle mit dem Namen gibt IZipCodeund diese Schnittstelle in der ZipCodeWebPart -Klasse implementiert ist. Diese Klasse verfügt über eine spezielle Rückrufmethode namens ProvideIZipCode , die als Anbieter fungiert. Der andere Typ namens WeatherWebPartwird ebenfalls mit einer speziellen Methode namens GetIZipCodeimplementiert, die es dem Steuerelement ermöglicht, als Consumer des anderen Steuerelements zu fungieren.

Damit das Codebeispiel ausgeführt werden kann, müssen Sie diesen Quellcode kompilieren. Sie können sie explizit kompilieren und die resultierende Assembly im Ordner Bin ihrer Website oder im globalen Assemblycache ablegen. Alternativ können Sie den Quellcode im App_Code Ordner Ihrer Website ablegen, wo er zur Laufzeit dynamisch kompiliert wird. In diesem Codebeispiel wird davon ausgegangen, dass Sie die Quelle zu einer Assembly kompiliert haben, und die Register Direktive auf der Webseite verweist auf den Assemblynamen. Eine exemplarische Vorgehensweise, die das Kompilieren veranschaulicht, finden Sie unter Exemplarische Vorgehensweise: Entwickeln und Verwenden eines benutzerdefinierten Webserversteuerelements.

namespace Samples.AspNet.CS.Controls
{
  using System;
  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;

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public interface IZipCode
  {
    string ZipCode { get; set;}
  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class ZipCodeWebPart : WebPart, IZipCode
  {
    string zipCodeText = String.Empty;
    TextBox input;
    Button send;

    public ZipCodeWebPart()
    {
    }

    // Make the implemented property personalizable to save 
    // the Zip Code between browser sessions.
    [Personalizable()]
    public virtual string ZipCode
    {
      get { return zipCodeText; }
      set { zipCodeText = value; }
    }

    // This is the callback method that returns the provider.
    [ConnectionProvider("Zip Code")]
    public IZipCode ProvideIZipCode()
    {
      return this;
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      input = new TextBox();
      this.Controls.Add(input);
      send = new Button();
      send.Text = "Enter 5-digit Zip Code";
      send.Click += new EventHandler(this.submit_Click);
      this.Controls.Add(send);
    }

    private void submit_Click(object sender, EventArgs e)
    {
      if (!string.IsNullOrEmpty(input.Text))
      {
        zipCodeText = Page.Server.HtmlEncode(input.Text);
        input.Text = String.Empty;
      }
    }
  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class WeatherWebPart : WebPart
  {
    private IZipCode _provider;
    string _zipSearch;
    Label DisplayContent;

    // This method is identified by the ConnectionConsumer 
    // attribute, and is the mechanism for connecting with 
    // the provider. 
    [ConnectionConsumer("Zip Code")]
    public void GetIZipCode(IZipCode Provider)
    {
      _provider = Provider;
    }
    
    protected override void OnPreRender(EventArgs e)
    {
      EnsureChildControls();

      if (this._provider != null)
      {
        _zipSearch = _provider.ZipCode.Trim();
        DisplayContent.Text = "My Zip Code is:  " + _zipSearch;
      }
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      this.Controls.Add(DisplayContent);
    }
  }
}
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 Interface IZipCode

    Property ZipCode() As String

  End Interface

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class ZipCodeWebPart
    Inherits WebPart
    Implements IZipCode
    Private zipCodeText As String = String.Empty
    Private input As TextBox
    Private send As Button

    Public Sub New()
    End Sub

    ' Make the implemented property personalizable to save 
    ' the Zip Code between browser sessions.
    <Personalizable()> _
    Public Property ZipCode() As String _
      Implements IZipCode.ZipCode

      Get
        Return zipCodeText
      End Get
      Set(ByVal value As String)
        zipCodeText = value
      End Set
    End Property

    ' This is the callback method that returns the provider.
    <ConnectionProvider("Zip Code")> _
    Public Function ProvideIZipCode() As IZipCode
      Return Me
    End Function


    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      input = New TextBox()
      Me.Controls.Add(input)
      send = New Button()
      send.Text = "Enter 5-digit Zip Code"
      AddHandler send.Click, AddressOf Me.submit_Click
      Me.Controls.Add(send)

    End Sub


    Private Sub submit_Click(ByVal sender As Object, _
      ByVal e As EventArgs)

      If input.Text <> String.Empty Then
        zipCodeText = Page.Server.HtmlEncode(input.Text)
        input.Text = String.Empty
      End If

    End Sub

  End Class

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class WeatherWebPart
    Inherits WebPart
    Private _provider As IZipCode
    Private _zipSearch As String
    Private DisplayContent As Label

    ' This method is identified by the ConnectionConsumer 
    ' attribute, and is the mechanism for connecting with 
    ' the provider. 
    <ConnectionConsumer("Zip Code")> _
    Public Sub GetIZipCode(ByVal Provider As IZipCode)
      _provider = Provider
    End Sub


    Protected Overrides Sub OnPreRender(ByVal e As EventArgs)
      EnsureChildControls()

      If Not (Me._provider Is Nothing) Then
        _zipSearch = _provider.ZipCode.Trim()
    DisplayContent.Text = "My Zip Code is:  " + _zipSearch
      End If

    End Sub

    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      DisplayContent = New Label()
      Me.Controls.Add(DisplayContent)

    End Sub

  End Class

End Namespace

Nachdem Sie die Webseite in einem Browser geladen haben, klicken Sie auf das Dropdown-Listensteuerelement Anzeigemodus , und wählen Sie Verbinden aus, um die Seite in den Verbindungsmodus zu wechseln. Im Verbindungsmodus wird das <asp:connectionszone> -Element verwendet, damit Sie Verbindungen zwischen Steuerelementen erstellen können. Klicken Sie im Verbindungsmodus auf den Abwärtspfeil in der Titelleiste des POSTLEITZAHL-Steuerelements , um das Menü "Verben" zu aktivieren, und klicken Sie dann auf Verbinden. Nachdem die Verbindungsoberfläche angezeigt wurde, klicken Sie auf den Link Erstellen einer Verbindung mit einem Consumer . Es wird eine Zelle angezeigt, die über ein Dropdownlistensteuerelement verfügt. Wählen Sie in der Dropdownliste Wettersteuerung aus, und klicken Sie dann auf Verbinden , um die Verbindung der beiden Steuerelemente abzuschließen. Klicken Sie auf Schließen, und verwenden Sie dann die Dropdownliste Anzeigemodus , um die Seite in den normalen Suchmodus zurückzugeben. Sie können eine Postleitzahl eingeben, und das Consumersteuerelement wird mit dem von Ihnen eingegebenen Wert aktualisiert. Da die ZipCode Eigenschaft mit dem Personalizable Attribut im Quellcode markiert wurde, bleibt dieser Eigenschaftswert über Browsersitzungen hinweg erhalten, wodurch der von einem Benutzer eingegebene Wert gespeichert wird. Eine komplexere Verbrauchersteuerung könnte die Postleitzahlinformationen übernehmen, Wetterinformationen basierend auf dem Code nachschlagen und sie einem Benutzer anzeigen.

Hinweise

Das WebPartManager Steuerelement fungiert als Hub oder Kontrollzentrum einer Webpartanwendung. Auf jeder Seite, die Webpart-Steuerelemente verwendet, muss nur eine - und nur eine -WebPartManager Steuerelementinstanz vorhanden sein. Wie bei den meisten Aspekten von Webpartanwendungen funktioniert das WebPartManager Steuerelement nur mit authentifizierten Benutzern. Darüber hinaus funktioniert die Funktionalität fast ausschließlich mit Serversteuerelementen, die sich in Webpartzonen befinden, die von der -Klasse erben WebZone . Serversteuerelemente, die sich auf einer Seite außerhalb dieser Zonen befinden, können sehr wenig Webparts-Funktionalität oder Interaktion mit dem WebPartManager Steuerelement aufweisen.

Als Hub für Webparts-Funktionen auf einer Seite führt das WebPartManager Steuerelement die in der folgenden Tabelle beschriebenen Aufgabenarten aus.

Aufgabenkategorie Funktionsweise des Steuerelements
Nachverfolgen von Webparts-Steuerelementen Verfolgt die vielen verschiedenen Arten von Steuerelementen auf einer Seite, die Webpartfeatures bereitstellen, einschließlich WebPart Steuerelementen, Verbindungen, Zonen und anderen.
Hinzufügen und Entfernen von Webpartsteuerelementen Stellt die Methoden zum Hinzufügen, Löschen und Schließen WebPart von Steuerelementen auf einer Seite bereit.
Verwalten von Verbindungen Erstellt Verbindungen zwischen Steuerelementen und überwacht die Verbindungen sowie die Prozesse zum Hinzufügen und Entfernen dieser Steuerelemente.
Personalisierung von Steuerelementen und Seiten Ermöglicht Benutzern das Verschieben von Steuerelementen an verschiedene Speicherorte auf einer Seite und startet die Ansichten, in denen Benutzer die Darstellung, die Eigenschaften und das Verhalten von Steuerelementen bearbeiten können. Verwaltet benutzerspezifische Personalisierungseinstellungen auf jeder Seite.
Umschalten zwischen verschiedenen Seitenansichten Wechselt eine Seite zwischen verschiedenen spezialisierten Ansichten der Seite, sodass Benutzer bestimmte Aufgaben ausführen können, z. B. das Ändern des Seitenlayouts oder das Bearbeiten von Steuerelementen.
Auslösen von Webparts-Lebenszyklusereignissen Definiert, löst und ermöglicht Entwicklern die Behandlung von Lebenszyklusereignissen von Webparts-Steuerelementen, z. B. wenn Steuerelemente hinzugefügt, verschoben, verbunden oder gelöscht werden.
Aktivieren des Importierens und Exportierens von Steuerelementen Exportiert XML-Datenströme, die den Zustand der Eigenschaften von WebPart Steuerelementen enthalten, und ermöglicht es Benutzern, die Dateien zu importieren, um komplexe Steuerelemente auf anderen Seiten oder Websites zu personalisieren.

Die WebPartManager -Klasse verfügt über einen großen Satz von Eigenschaften. In Übereinstimmung mit der WebPartManager Rolle der Nachverfolgung anderer Steuerelemente verfügt es über eine Reihe von Eigenschaften, die auf Sammlungen von Webparts-Steuerelementen oder anderen speziellen Webparts-Objekten verweisen. Die AvailableTransformersEigenschaften , ControlsConnections, DisplayModes, , DynamicConnections, WebPartsSupportedDisplayModes, und Zones sind alle Sammlungen, die WebPartManager vom Steuerelement für die Nachverfolgung und andere Verwaltungsaufgaben verwendet werden.

Eine weitere Gruppe von Eigenschaften enthält anpassbare Warnungen, die in bestimmten Szenarien gelten, die in einer Webparts-Anwendung auftreten. Dazu gehören die CloseProviderWarningEigenschaften , DeleteWarningund .ExportSensitiveDataWarning

Die WebPartManager -Klasse überschreibt einige ihrer geerbten Basiseigenschaften, die von vielen Webserversteuerelementen verwendet werden. Dazu gehören die EnableThemingEigenschaften , SkinIDund Visible .

Schließlich gibt es eine Gruppe von Eigenschaften, die für den Zugriff auf den aktuellen Zustand der Anwendung nützlich sind. Die DisplayMode -Eigenschaft gibt den aktuellen Anzeigemodus an, in dem sich eine Seite befindet. Die EnableClientScript -Eigenschaft gibt an, ob ein Steuerelement clientseitige Skripts rendern darf, was in Situationen relevant ist, in denen Benutzer Browser mit unterschiedlichen Funktionen haben oder die Skripterstellung deaktiviert haben. Die Internals -Eigenschaft ist nützlich, um auf eine Hilfsprogrammklasse zu verweisen, die die Aufrufe einer Reihe wichtiger Webparts-Methoden enthält, die für Erweiterbarkeitsfälle verwendet werden. Durch das Ausblenden der Aufrufe dieser Methoden in einer separaten Klasse (der WebPartManagerInternals -Klasse) wird die eigene API der WebPartManager Klasse vereinfacht. Die Personalization -Eigenschaft bietet Zugriff auf die Personalisierungsobjekte, die die Personalisierungseinstellungen der Benutzer speichern und diese Daten dauerhaft speichern. Die SelectedWebPart -Eigenschaft gibt an, welches WebPart Steuerelement auf einer Seite derzeit vom Benutzer oder der Anwendung ausgewählt wird. Die IPersonalizable.IsDirty -Eigenschaft gibt an, ob sich benutzerdefinierte Personalisierungsdaten für ein WebPart Steuerelement geändert haben.

Das WebPartManager Steuerelement enthält fünf integrierte Anzeigemodi oder Ansichten einer Webseite. Entwickler können dieses Feature erweitern und benutzerdefinierte Anzeigemodi erstellen, indem sie Typen wie die WebZone -Klasse oder die ToolZone -Klasse erweitern. Benutzer können eine Seite in die verschiedenen Anzeigemodi wechseln, vorausgesetzt, dass die richtige Art von Steuerelementen, die einem bestimmten Anzeigemodus entsprechen, auf einer Seite vorhanden sind.

Hinweis

Es ist möglich, dieses Feature zu erweitern, sodass Benutzer in einen benutzerdefinierten Anzeigemodus wechseln können, ohne eine entsprechende Zone auf der Seite zu haben. Das Standardverhalten ist jedoch, dass Anzeigemodi Zonen entsprechen.

Die Standardanzeigemodi werden durch öffentliche Felder in der WebPartManager -Klasse dargestellt. In der folgenden Tabelle sind die Felder und die Anzeigemodi zusammengefasst, auf die sie sich beziehen. Auf den aktuellen Anzeigemodus einer Seite wird, wie oben erwähnt, immer in der DisplayMode -Eigenschaft verwiesen, und der Satz von Anzeigemodi, die auf einer bestimmten Seite möglich sind, ist in der -Eigenschaft enthalten, wenn die Art von Zonen auf der SupportedDisplayModes Seite vorhanden ist.

Feld Details zum Anzeigemodus
BrowseDisplayMode Die normale Benutzeransicht einer Webseite; der standard- und am häufigsten verwendete Anzeigemodus.
DesignDisplayMode Die Ansicht, in der Benutzer Steuerelemente neu anordnen oder löschen können, um das Seitenlayout zu ändern.
EditDisplayMode Die Ansicht, in der eine Bearbeitungs-Benutzeroberfläche (UI) sichtbar wird; Benutzer können die Darstellung, die Eigenschaften und das Verhalten der Steuerelemente bearbeiten, die im normalen Browsermodus angezeigt werden.
CatalogDisplayMode Die Ansicht, in der eine Katalog-Benutzeroberfläche sichtbar wird; Benutzer können einer Seite Steuerelemente aus Katalogen verfügbarer Steuerelemente hinzufügen.
ConnectDisplayMode Die Ansicht, in der eine Verbindungs-Benutzeroberfläche sichtbar wird; Benutzer können Verbindungen zwischen Steuerelementen herstellen, verwalten oder trennen.

Das WebPartManager -Steuerelement enthält auch eine Reihe von Ereignissen, die im Lebenszyklus von Webparts-Seiten und -Steuerelementen kritisch sind. Diese Ereignisse bieten eine präzise programmgesteuerte Steuerung des Verhaltens von Webparts-Steuerelementen. Die meisten Methoden beziehen sich direkt auf WebPart Steuerelemente (oder andere Server- oder Benutzersteuerelemente, die in WebPartZoneBase Zonen platziert werden, sodass sie sich als WebPart Steuerelemente verhalten können). Einige Ereignisse beziehen sich jedoch auf den Zustand der Seite oder der Verbindungen auf der Seite. In der folgenden Tabelle sind die verfügbaren Ereignisse und deren Zwecke zusammengefasst.

Hinweis

In allen Fällen in der folgenden Tabelle bezieht sich das Wort "control" auf ein WebPart Steuerelement oder ein Serversteuerelement, das sich in einer Zone befindet und zur Laufzeit mit einem GenericWebPart -Objekt umschlossen wird.

Ereignis BESCHREIBUNG
AuthorizeWebPart Tritt kurz vor dem Hinzufügen eines Steuerelements zu einer Seite auf, um zu überprüfen, ob es autorisiert ist.
ConnectionsActivated Tritt auf, nachdem alle Verbindungen auf einer Seite aktiviert wurden.
ConnectionsActivating Tritt unmittelbar vor dem Aktivieren aller Verbindungen auf einer Seite auf.
DisplayModeChanged Tritt auf, nachdem sich der aktuelle Anzeigemodus einer Seite geändert hat.
DisplayModeChanging Tritt unmittelbar vor dem Ändern des Anzeigemodus einer Seite auf.
SelectedWebPartChanged Tritt auf, nachdem die Auswahl eines Steuerelements abgebrochen wurde.
SelectedWebPartChanging Tritt unmittelbar vor dem Abbrechen der Auswahl eines Steuerelements auf.
WebPartAdded Tritt auf, nachdem einer Zone ein Steuerelement hinzugefügt wurde.
WebPartAdding Tritt unmittelbar vor dem Hinzufügen eines Steuerelements zu einer Zone auf.
WebPartClosed Tritt auf, nachdem ein Steuerelement geschlossen (von einer Seite entfernt) wurde.
WebPartClosing Tritt unmittelbar vor dem Schließen eines Steuerelements auf.
WebPartDeleted Tritt auf, nachdem eine Instanz eines dynamischen Steuerelements (eines, das programmgesteuert erstellt oder aus einem Katalog hinzugefügt wurde) endgültig gelöscht wurde.
WebPartDeleting Tritt unmittelbar vor dem Löschen eines dynamischen Steuerelements auf.
WebPartMoved Tritt auf, nachdem ein Steuerelement innerhalb seiner Zone oder in eine andere Zone verschoben wurde.
WebPartMoving Tritt unmittelbar vor dem Verschieben eines Steuerelements auf.
WebPartsConnected Tritt auf, nachdem zwei Steuerelemente, die für die Teilnahme an einer Verbindung ausgewählt wurden, die Verbindung hergestellt haben.
WebPartsConnecting Tritt unmittelbar vor dem Verbindungsvorgang zweier Steuerelemente auf.
WebPartsDisconnected Tritt auf, nachdem zwei verbundene Steuerelemente getrennt wurden.
WebPartsDisconnecting Tritt kurz vor dem Trennen von zwei Steuerelementen auf.

Das WebPartManager -Steuerelement verfügt über zahlreiche Methoden zum Verwalten von Webparts-Seiten. Ein großer Satz der Methoden, die hier nicht aufgeführt sind, sind Methoden, deren Namen die Form OnEventName annehmen. Diese Methoden lösen in der Regel das zugeordnete Ereignis aus und stellen das Ereignis mit einem Handler vom Typ WebPartEventHandlerbereit. Die meisten dieser Methoden können von Entwicklern überschrieben werden, die von der WebPartManager -Klasse erben. Außerdem können Seitenentwickler benutzerdefinierte Handler für die Ereignisse bereitstellen, die diesen Methoden zugeordnet sind. Im Fall des Ereignisses WebPartAdded könnte ein Seitenentwickler dem Element im Markup einer Webseite beispielsweise ein OnWebPartAdded Attribut <asp:webpartmanager> hinzufügen und dem Attribut dann einen benutzerdefinierten Methodennamen zuweisen, um eine benutzerdefinierte Behandlung für das Ereignis bereitzustellen. Das -Attribut entspricht der OnWebPartAdded -Methode, und dieses grundlegende Muster der Ereignisbehandlung funktioniert für die meisten Webparts-Ereignisse und die zugehörigen Methoden.

Darüber hinaus verfügt das Steuerelement über Methoden, die WebPartManager speziell für die Verwaltung WebPart von Steuerelementen (und Server- oder Benutzersteuerelemente, die als WebPart Steuerelemente verwendet werden) verwendet werden. Zu diesen Methoden gehören AddWebPart, AuthorizeWebPart, CloseWebPart, CopyWebPart, CreateWebPart, DeleteWebPart, BeginWebPartEditingGetGenericWebPartEndWebPartEditingDisconnectWebPartExportWebPart, ImportWebPart, , IsAuthorizedund .MoveWebPart

Ein weiterer Satz von Methoden ist auf Verbindungen spezialisiert. Dazu gehören Methoden wie ActivateConnections, , BeginWebPartConnecting, CanConnectWebParts, ConnectWebPartsCreateAvailableTransformers, EndWebPartConnectingGetConsumerConnectionPointsDisconnectWebPartDisconnectWebPartsund .GetProviderConnectionPoints

Schließlich konzentrieren sich einige WebPartManager Methoden auf Personalisierungsfunktionen. Dies waren CreatePersonalization, LoadControlState, SaveCustomPersonalizationState, SetPersonalizationDirty, IPersonalizable.Load, IPersonalizable.Save und SaveControlState.

Weitere Informationen zu anderen WebPartManager Methoden, auf die über die Internals -Eigenschaft zugegriffen werden kann, finden Sie in der Dokumentation für die WebPartManagerInternals -Klasse.

Hinweise für Vererber

Das WebPartManager Steuerelement ist so konzipiert, dass es erweitert werden kann. Da dies für Webpartanwendungen so zentral ist, müssen Sie in vielen Fällen auch die WebPartManager Klasse erweitern, wenn Sie einen bestimmten Typ oder ein Bestimmtes Steuerelement im Webpart-Steuerelementsatz erweitern möchten, da es wahrscheinlich über eine Eigenschaft oder Methode verfügt, die erforderlich ist, damit Ihr benutzerdefinierter Typ im Kontext einer Webpart-Anwendung funktioniert. In der Webpart-Referenzdokumentation (siehe System.Web.UI.WebControls.WebParts) wird häufig erläutert, wie ein Webparttyp erweitert werden kann, was ebenfalls zum Erweitern der WebPartManager Klasse getan werden muss, oder in einem Codebeispiel wird gezeigt, wie sie erweitert werden kann.

Konstruktoren

WebPartManager()

Initialisiert eine neue Instanz der WebPartManager-Klasse.

Felder

BrowseDisplayMode

Stellt den Standardanzeigemodus für Seiten dar, die Webparts-Steuerelemente enthalten. Dieses Feld ist schreibgeschützt.

CatalogDisplayMode

Stellt den Anzeigemodus dar, in dem Serversteuerelemente aus einem Katalog von Steuerelementen einer Seite hinzugefügt werden. Dieses Feld ist schreibgeschützt.

ConnectDisplayMode

Stellt den Anzeigemodus dar, in dem eine spezielle Benutzeroberfläche dargestellt wird, in der Benutzer Verbindungen zwischen WebPart-Steuerelementen verwalten. Dieses Feld ist schreibgeschützt.

DesignDisplayMode

Stellt den Anzeigemodus dar, in dem das Layout von Webseiten mit Webparts-Steuerelementen geändert wird. Dieses Feld ist schreibgeschützt.

EditDisplayMode

Stellt den Anzeigemodus dar, in dem Endbenutzer Serversteuerelemente bearbeiten können. Dieses Feld ist schreibgeschützt.

Eigenschaften

Adapter

Ruft den browserspezifischen Adapter für das Steuerelement ab.

(Geerbt von Control)
AppRelativeTemplateSourceDirectory

Ruft das anwendungsrelative virtuelle Verzeichnis des Page-Objekts oder des UserControl-Objekt ab, das dieses Steuerelement enthält, oder legt dieses Verzeichnis fest.

(Geerbt von Control)
AvailableTransformers

Ruft eine Auflistung von WebPartTransformer-Objekten ab, die zum Erstellen von Webparts-Verbindungen zwischen Serversteuerelementen zur Verfügung stehen.

BindingContainer

Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält.

(Geerbt von Control)
ChildControlsCreated

Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden.

(Geerbt von Control)
ClientID

Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird.

(Geerbt von Control)
ClientIDMode

Ruft den Algorithmus ab, mit dem der Wert der ClientID-Eigenschaft generiert wird, oder legt diesen fest.

(Geerbt von Control)
ClientIDSeparator

Ruft einen Zeichenwert ab, der das in der ClientID-Eigenschaft verwendete Trennzeichen darstellt.

(Geerbt von Control)
CloseProviderWarning

Ruft eine Warnung ab, die angezeigt wird, wenn ein Benutzer ein Steuerelement schließt, das als Anbieter für andere Steuerelemente in einer Verbindung fungiert, oder legt diese Warnung fest.

Connections

Ruft einen Verweis auf die Auflistung aller aktuellen Verbindungen auf einer Webseite ab.

Context

Ruft das dem Serversteuerelement für die aktuelle Webanforderung zugeordnete HttpContext-Objekt ab.

(Geerbt von Control)
Controls

Ruft die Auflistung aller WebPart-Steuerelemente, Serversteuerelemente oder Benutzersteuerelemente ab, die in WebPartZoneBase-Zonen auf einer Webseite enthalten sind und vom WebPartManager-Steuerelement verwaltet werden.

DataItemContainer

Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataItemContainer implementiert wird.

(Geerbt von Control)
DataKeysContainer

Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataKeysControl implementiert wird.

(Geerbt von Control)
DeleteWarning

Ruft eine benutzerdefinierte Warnmeldung ab oder legt diese fest, die angezeigt wird, wenn Endbenutzer ein Steuerelement löschen.

DesignMode

Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird.

(Geerbt von Control)
DisplayMode

Ruft den aktiven Anzeigemodus für eine Webseite ab, die Webparts-Steuerelemente enthält, oder legt diesen fest.

DisplayModes

Ruft eine schreibgeschützte Auflistung aller Anzeigemodi ab, die einem WebPartManager-Steuerelement zugeordnet sind.

DynamicConnections

Ruft die Auflistung aller dynamischen Verbindungen ab, die auf einer Webseite derzeit vorhanden sind.

EnableClientScript

Ruft einen Wert ab oder legt ihn fest, der bestimmt, ob auf einer Webseite mit einem WebPartManager-Steuerelement clientseitige Skripts aktiviert sind.

EnableTheming

Ruft einen Wert ab, der angibt, dass die Verwendung von Designs auf einer Webseite aktiviert ist.

EnableViewState

Ruft einen Wert ab, der dem anfordernden Client angibt, ob das Serversteuerelement seinen Ansichtszustand sowie den Ansichtszustand von jedem enthaltenen untergeordneten Steuerelement beibehält, oder legt diesen fest.

(Geerbt von Control)
Events

Ruft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt.

(Geerbt von Control)
ExportSensitiveDataWarning

Ruft den Text einer Warnmeldung ab, die angezeigt wird, wenn versucht wird, vertrauliche Zustandsdaten aus einem WebPart-Steuerelement zu exportieren, oder legt diesen Text fest.

HasChildViewState

Ruft einen Wert ab, der angibt, ob in den untergeordneten Steuerelementen des aktuellen Serversteuerelements gespeicherte Einstellungen für den Ansichtszustand vorhanden sind.

(Geerbt von Control)
ID

Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest.

(Geerbt von Control)
IdSeparator

Ruft das als Trennzeichen für Steuerelementbezeichner verwendete Zeichen ab.

(Geerbt von Control)
Internals

Ruft einen Verweis auf die WebPartManagerInternals-Klasse ab, die verwendet wird, um einen Satz von Methoden zu kombinieren und aufzuteilen, die eigentlich in der WebPartManager-Klasse implementiert sind, aber vor allem für Steuerelemententwickler nützlich sind.

IsChildControlStateCleared

Ruft einen Wert ab, der angibt, ob in diesem Steuerelements enthaltene Steuerelemente über einen Steuerelementzustand verfügen.

(Geerbt von Control)
IsCustomPersonalizationStateDirty

Ruft einen Wert ab, der angibt, ob Personalisierungsänderungen vorgenommen wurden, die Personalisierungsdetails auf der Seitenebene betreffen, die durch das WebPartManager-Steuerelement gesteuert werden.

IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen des Ansichtszustands speichert.

(Geerbt von Control)
IsViewStateEnabled

Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist.

(Geerbt von Control)
LoadViewStateByID

Ruft einen Wert ab, der angibt, ob das Steuerelement seinen Ansichtszustand über ID anstatt über den Index lädt.

(Geerbt von Control)
MediumPermissionSet

Ruft ein PermissionSet-Objekt ab, das nur die Execution-Berechtigung und die Medium-Berechtigung gewährt.

MinimalPermissionSet

Ruft ein PermissionSet-Objekt ab, das nur die Execution-Berechtigung und die Minimal-Berechtigung gewährt.

NamingContainer

Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace erstellt, damit zwischen Serversteuerelementen mit demselben ID-Eigenschaftswert unterschieden werden kann.

(Geerbt von Control)
Page

Ruft einen Verweis auf die Page-Instanz ab, die das Serversteuerelement enthält.

(Geerbt von Control)
Parent

Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Steuerelementhierarchie der Seite ab.

(Geerbt von Control)
Personalization

Ruft einen Verweis auf ein Objekt ab, das Personalisierungsdaten für eine Webseite enthält.

RenderingCompatibility

Ruft einen Wert ab, der die ASP.NET-Version angibt, mit der gerenderte HTML-Objekte kompatibel sind.

(Geerbt von Control)
SelectedWebPart

Ruft einen Verweis auf ein WebPart-Steuerelement oder sonstiges Serversteuerelement ab, das derzeit zur Bearbeitung oder zum Erstellen einer Verbindung mit einem anderen Steuerelement ausgewählt ist.

Site

Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostet, wenn es auf einer Entwurfsoberfläche gerendert wird.

(Geerbt von Control)
SkinID

Ruft eine leere Zeichenfolge ("") ab oder liegt diese fest, sodass keine Skin auf das WebPartManager-Steuerelement angewendet werden kann.

StaticConnections

Ruft einen Verweis auf die Auflistung aller als statische Verbindungen definierten WebPartConnection-Objekte auf einer Webseite ab.

SupportedDisplayModes

Ruft eine schreibgeschützte Auflistung aller Anzeigemodi ab, die auf einer bestimmten Webseite verfügbar sind.

TemplateControl

Ruft einen Verweis auf die Vorlage ab, die dieses Steuerelement enthält, oder legt den Verweis fest.

(Geerbt von Control)
TemplateSourceDirectory

Ruft das virtuelle Verzeichnis der Page oder des UserControl ab, in dem das aktuelle Serversteuerelement enthalten ist.

(Geerbt von Control)
UniqueID

Ruft den eindeutigen, hierarchisierten Bezeichner für das Serversteuerelement ab.

(Geerbt von Control)
ValidateRequestMode

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben des Browser auf gefährliche Werte überprüft.

(Geerbt von Control)
ViewState

Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können.

(Geerbt von Control)
ViewStateIgnoresCase

Ruft einen Wert ab, der angibt, ob bei dem StateBag-Objekt die Groß- und Kleinschreibung nicht berücksichtigt wird.

(Geerbt von Control)
ViewStateMode

Ruft den Ansichtszustandsmodus des Steuerelements ab oder legt ihn fest.

(Geerbt von Control)
Visible

Ruft einen Wert ab, mit dessen Hilfe untergeordnete Steuerelemente sichtbar sein können.

WebParts

Ruft einen Verweis auf alle vom WebPart-Steuerelement auf einer Webseite nachverfolgten WebPartManager-Steuerelemente ab.

Zones

Ruft einen Verweis auf eine Auflistung aller WebPartZoneBase-Zonen auf einer Webseite ab.

Methoden

ActivateConnections()

Aktiviert alle derzeit inaktiven Verbindungen auf einer Webseite.

AddedControl(Control, Int32)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement zur Controls-Auflistung des Control-Objekts hinzugefügt wurde.

(Geerbt von Control)
AddParsedSubObject(Object)

Benachrichtigt das Serversteuerelement, dass entweder ein XML-Element oder HTML-Element analysiert wurde, und fügt das Element dem ControlCollection-Objekt des Serversteuerelements hinzu.

(Geerbt von Control)
AddWebPart(WebPart, WebPartZoneBase, Int32)

Stellt die programmgesteuerte Standardmethode zum Hinzufügen von WebPart-Steuerelementen auf einer Webseite bereit.

ApplyStyleSheetSkin(Page)

Übernimmt die im Stylesheet der Seite definierten Stileigenschaften für das Steuerelement.

(Geerbt von Control)
BeginRenderTracing(TextWriter, Object)

Startet die Entwurfszeitablaufverfolgung des Renderns von Daten.

(Geerbt von Control)
BeginWebPartConnecting(WebPart)

Startet den Prozess, mit dem zwei WebPart-Steuerelemente miteinander verbunden werden.

BeginWebPartEditing(WebPart)

Startet den Prozess der Bearbeitung eines WebPart-Steuerelements.

BuildProfileTree(String, Boolean)

Sammelt Informationen zum Serversteuerelement und übermittelt sie an die Trace-Eigenschaft, sodass diese angezeigt werden, wenn die Ablaufverfolgung für die Seite aktiviert ist.

(Geerbt von Control)
CanConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint)

Prüft die WebPart-Steuerelemente, die an einer Verbindung teilnehmen sollen, um zu bestimmen, ob diese verbunden werden können, falls das Consumer- und Anbietersteuerelement über kompatible Schnittstellen verfügen und kein WebPartTransformer-Objekt erforderlich ist.

CanConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartTransformer)

Prüft die WebPart-Steuerelemente, die an einer Verbindung teilnehmen sollen, um zu bestimmen, ob diese verbunden werden können, und erstellt mithilfe eines WebPartTransformer-Objekts eine Verbindung zwischen einem nicht kompatiblen Consumer und Anbieter.

CheckRenderClientScript()

Prüft die Funktionen des Browsers, von dem die Anforderung stammt, sowie den Wert der EnableClientScript-Eigenschaft, um festzustellen, ob Clientskripts wiedergegeben werden sollen.

ClearCachedClientID()

Legt den zwischengespeicherten ClientID-Wert auf null fest.

(Geerbt von Control)
ClearChildControlState()

Löscht die Informationen zum Steuerelementzustand für die untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
ClearChildState()

Löscht die Informationen zum Ansichtszustand sowie zum Steuerelementzustand für alle untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
ClearChildViewState()

Löscht die Informationen über den Ansichtszustand für alle untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
ClearEffectiveClientIDMode()

Legt die ClientIDMode-Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit fest.

(Geerbt von Control)
CloseWebPart(WebPart)

Schließt ein WebPart-Steuerelement, sodass es auf einer Webseite zwar nicht wiedergegeben wird, aber erneut geöffnet werden kann.

ConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint)

Erstellt nur mithilfe der Verweise auf die Steuerelemente und ihre angegebenen WebPart-Objekte eine Verbindung zwischen zwei GenericWebPart-Steuerelementen oder ConnectionPoint-Steuerelementen.

ConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartTransformer)

Erstellt mithilfe der Verweise auf die Steuerelemente, ihre angegebenen WebPart-Objekte und ein GenericWebPart-Objekt eine Verbindung zwischen zwei ConnectionPoint-Steuerelementen oder WebPartTransformer-Steuerelementen.

CopyWebPart(WebPart)

Wird vom Webparts-Steuerelementsatz verwendet, um eine Kopie eines WebPart-Steuerelements oder Serversteuerelements anzulegen und diese dem Steuerelement auf einer Webseite hinzuzufügen.

CreateAvailableTransformers()

Erstellt einen Satz von in der Konfigurationsdatei einer Website angegebenen Transformatoren und fügt sie der Auflistung der Transformatoren hinzu, auf die die AvailableTransformers-Eigenschaft verweist.

CreateChildControls()

Wird durch das ASP.NET-Seitenframework aufgerufen, um Serversteuerelemente anzuweisen, die eine kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie in Vorbereitung auf ein Postback oder Rendering enthalten.

(Geerbt von Control)
CreateControlCollection()

Gibt die Auflistung aller Steuerelemente zurück, die vom WebPartManager-Steuerelement auf einer Webseite verwaltet werden. Diese Klasse kann nicht vererbt werden.

CreateDisplayModes()

Erstellt den Satz aller möglichen Anzeigemodi für eine Webparts-Anwendung.

CreateDynamicConnectionID()

Ruft einen eindeutigen Wert ab, der als ID für eine dynamische Verbindung verwendet wird.

CreateDynamicWebPartID(Type)

Generiert eine eindeutige ID für ein dynamisches WebPart-Steuerelement.

CreateErrorWebPart(String, String, String, String, String)

Erstellt ein spezielles Steuerelement, das auf eine Seite eingefügt wird und das für Endbenutzer angezeigt wird, wenn der Versuch fehlschlägt, ein dynamisches WebPart-Steuerelement zu laden oder zu erstellen.

CreatePersonalization()

Gibt ein Personalisierungsobjekt zurück, das die Personalisierungsdaten eines Benutzers für die aktuelle Webseite enthält.

CreateWebPart(Control)

Umschließt ein Serversteuerelement, das kein WebPart-Steuerelement ist, mit einem GenericWebPart-Objekt, sodass das Steuerelement über Webparts-Funktionen verfügt.

DataBind()

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente.

(Geerbt von Control)
DataBind(Boolean)

Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit der Option, das DataBinding-Ereignis auszulösen.

(Geerbt von Control)
DataBindChildren()

Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
DeleteWebPart(WebPart)

Löscht eine dynamische Instanz eines WebPart-Steuerelements unwiderruflich von einer Webseite.

DisconnectWebPart(WebPart)

Entfernt ein WebPart-Steuerelement oder Serversteuerelement, das geschlossen oder gelöscht wird, aus allen Verbindungen, an denen es beteiligt ist.

DisconnectWebParts(WebPartConnection)

Führt den Prozess des Trennens von auf einer Webseite verbundenen Serversteuerelementen aus.

Dispose()

Ermöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor es aus dem Speicher freigegeben wird.

(Geerbt von Control)
EndRenderTracing(TextWriter, Object)

Beendet die Entwurfszeitablaufverfolgung des Renderns von Daten.

(Geerbt von Control)
EndWebPartConnecting()

Schließt den Prozess ab, mit dem eine Verbindung zwischen einem WebPart-Steuerelement und einem anderen Steuerelement erstellt wird.

EndWebPartEditing()

Schließt den Prozess der Bearbeitung eines WebPart-Steuerelements ab.

EnsureChildControls()

Stellt fest, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn das nicht der Fall ist, werden untergeordnete Steuerelemente erstellt.

(Geerbt von Control)
EnsureID()

Erstellt einen Bezeichner für Steuerelemente, die nicht über einen zugewiesenen Bezeichner verfügen.

(Geerbt von Control)
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
ExportWebPart(WebPart, XmlWriter)

Erstellt eine XML-Beschreibungsdatei, die Zustands- und Eigenschaftendaten für ein Serversteuerelement enthält.

FindControl(String)

Durchsucht den aktuellen Benennungscontainer nach dem angegebenen Serversteuerelement mit dem angegebenen id-Parameter.

(Geerbt von Control)
FindControl(String, Int32)

Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen id und einer ganzen Zahl, die im pathOffset-Parameter angegeben ist, der die Suche unterstützt. Sie sollten diese Version der FindControl-Methode nicht überschreiben.

(Geerbt von Control)
Focus()

Überschrieben, um zu verhindern, dass der Fokus auf das WebPartManager-Steuerelement gesetzt wird, weil dieses keine Benutzeroberfläche besitzt.

GetConsumerConnectionPoints(WebPart)

Ruft eine Auflistung von ConsumerConnectionPoint-Objekten ab, die als Verbindungspunkte von einem Serversteuerelement verwendet werden können, das als Consumer in einer Webparts-Verbindung fungiert.

GetCurrentWebPartManager(Page)

Ruft einen Verweis auf die aktuelle Instanz des WebPartManager-Steuerelements auf einer Seite ab.

GetDesignModeState()

Ruft die Entwurfszeitdaten für ein Steuerelement ab.

(Geerbt von Control)
GetDisplayTitle(WebPart)

Ruft eine Zeichenfolge ab, die den Wert für die DisplayTitle-Eigenschaft eines WebPart-Steuerelements enthält.

GetExportUrl(WebPart)

Ruft den relativen virtuellen Pfad und die Abfragezeichenfolge ab, die bei dem Versuch, ein WebPart-Steuerelement zu exportieren, Teil der Anforderung sind.

GetGenericWebPart(Control)

Ruft einen Verweis auf die Instanz des GenericWebPart-Steuerelements ab, die ein Serversteuerelement enthält.

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetProviderConnectionPoints(WebPart)

Ruft eine Auflistung von ProviderConnectionPoint-Objekten ab, die als Verbindungspunkte von einem Serversteuerelement verwendet werden können, das als Anbieter in einer Webparts-Verbindung fungiert.

GetRouteUrl(Object)

Ruft die URL ab, die einem Satz von Routenparametern entspricht.

(Geerbt von Control)
GetRouteUrl(RouteValueDictionary)

Ruft die URL ab, die einem Satz von Routenparametern entspricht.

(Geerbt von Control)
GetRouteUrl(String, Object)

Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht.

(Geerbt von Control)
GetRouteUrl(String, RouteValueDictionary)

Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht.

(Geerbt von Control)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
GetUniqueIDRelativeTo(Control)

Gibt den mit einem Präfix versehenen Abschnitt der UniqueID-Eigenschaft des angegebenen Steuerelements zurück.

(Geerbt von Control)
HasControls()

Ermittelt, ob das Serversteuerelement untergeordnete Steuerelemente enthält.

(Geerbt von Control)
HasEvents()

Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder für untergeordnete Steuerelemente registriert werden.

(Geerbt von Control)
ImportWebPart(XmlReader, String)

Importiert eine XML-Beschreibungsdatei, die Zustands- und Eigenschaftendaten für ein WebPart-Steuerelement enthält, und wendet die Daten auf das Steuerelement an.

IsAuthorized(Type, String, String, Boolean)

Führt die letzten Schritte des Prozesses aus, mit dem bestimmt wird, ob für das Steuerelement eine Autorisierung vorhanden ist und es einer Seite hinzugefügt werden darf.

IsAuthorized(WebPart)

Führt die ersten Schritte des Prozesses aus, mit dem bestimmt wird, ob für das Steuerelement eine Autorisierung vorhanden ist und es einer Seite hinzugefügt werden darf.

IsLiteralContent()

Ermittelt, ob das Serversteuerelement nur literalen Inhalt enthält.

(Geerbt von Control)
LoadControlState(Object)

Lädt Daten zum Steuerelementzustand, die bei einer vorherigen Seitenanforderung gespeichert wurden und bei einer nachfolgenden Anforderung wiederhergestellt werden müssen.

LoadCustomPersonalizationState(PersonalizationDictionary)

Speichert die benutzerdefinierten Personalisierungsdaten, die zur späteren Verwendung im Initialisierungsprozess von den Personalisierungsobjekten an das WebPartManager-Steuerelement übergeben wurden.

LoadViewState(Object)

Stellt die Informationen über den Ansichtszustand aus einer früheren Seitenanforderung wieder her, die mit der SaveViewState()-Methode gespeichert wurden.

(Geerbt von Control)
MapPathSecure(String)

Ruft den physikalischen Pfad ab, auf den ein absoluter bzw. relativer virtueller Pfad verweist.

(Geerbt von Control)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
MoveWebPart(WebPart, WebPartZoneBase, Int32)

Verschiebt ein WebPart-Steuerelement oder ein Serversteuerelement aus einer WebPartZoneBase-Zone in eine andere Zone oder an eine neue Position innerhalb derselben Zone.

OnAuthorizeWebPart(WebPartAuthorizationEventArgs)

Löst das AuthorizeWebPart-Ereignis aus und ruft, falls vorhanden, einen Handler für das Ereignis auf.

OnBubbleEvent(Object, EventArgs)

Bestimmt, ob das Ereignis für das Serversteuerelement in der UI-Serversteuerelementhierarchie der Seite nach oben übergeben wird.

(Geerbt von Control)
OnConnectionsActivated(EventArgs)

Löst das ConnectionsActivated-Ereignis aus, das anzeigt, dass eine Seite und ihre Steuerelemente geladen sind und dass die Verbindungen auf der Seite aktiviert wurden, um mit dem Austausch von Daten zu beginnen.

OnConnectionsActivating(EventArgs)

Löst das ConnectionsActivating-Ereignis aus, das anzeigt, dass eine Seite und ihre Steuerelemente geladen wurden und dass mit dem Aktivieren von Verbindungen begonnen werden kann.

OnDataBinding(EventArgs)

Löst das DataBinding-Ereignis aus.

(Geerbt von Control)
OnDisplayModeChanged(WebPartDisplayModeEventArgs)

Löst das DisplayModeChanged-Ereignis aus, um anzuzeigen, dass das WebPartManager-Steuerelement auf einer Webseite den Prozess des Umschaltens von einem Anzeigemodus in einen anderen abgeschlossen hat.

OnDisplayModeChanging(WebPartDisplayModeCancelEventArgs)

Löst das DisplayModeChanging-Ereignis aus, um anzuzeigen, dass das WebPartManager-Steuerelement auf einer Webseite gerade von einem Anzeigemodus in einen anderen umgeschaltet wird.

OnInit(EventArgs)

Löst das Init-Ereignis aus, das das erste Ereignis im Lebenszyklus des WebPartManager-Steuerelements ist.

OnLoad(EventArgs)

Löst das Load-Ereignis aus.

(Geerbt von Control)
OnPreRender(EventArgs)

Löst das PreRender-Ereignis aus, das unmittelbar vor der Wiedergabe eines WebPartManager-Steuerelements auf einer Webseite eintritt.

OnSelectedWebPartChanged(WebPartEventArgs)

Löst das SelectedWebPartChanged-Ereignis aus, das eintritt, nachdem ein WebPart-Steuerelement entweder neu ausgewählt wurde oder seine Auswahl aufgehoben wurde.

OnSelectedWebPartChanging(WebPartCancelEventArgs)

Löst das SelectedWebPartChanging-Ereignis aus, das während des Prozesses eintritt, bei dem das derzeit ausgewählte WebPart-Steuerelement geändert wird.

OnUnload(EventArgs)

Löst das Unload-Basisereignis aus und löscht die WebPartManager-Instanz von einer Webseite.

OnWebPartAdded(WebPartEventArgs)

Löst das WebPartAdded-Ereignis aus, das eintritt, nachdem einer Seite ein WebPart-Steuerelement hinzugefügt wurde.

OnWebPartAdding(WebPartAddingEventArgs)

Löst das WebPartAdding-Ereignis aus, das eintritt, während einer WebPart-Zone ein WebPartZoneBase-Steuerelement (oder ein Server- bzw. Benutzersteuerelement) hinzugefügt wird.

OnWebPartClosed(WebPartEventArgs)

Löst das WebPartClosed-Ereignis aus, um anzuzeigen, dass ein Steuerelement von einer Seite entfernt worden ist.

OnWebPartClosing(WebPartCancelEventArgs)

Löst das WebPartClosing-Ereignis aus, das eintritt, während ein WebPart-Steuerelement oder ein Serversteuerelement von einer Seite entfernt wird.

OnWebPartDeleted(WebPartEventArgs)

Löst das WebPartDeleted-Ereignis aus, das eintritt, nachdem ein WebPart-Steuerelement unwiderruflich von einer Seite gelöscht wurde.

OnWebPartDeleting(WebPartCancelEventArgs)

Löst das WebPartDeleting-Ereignis aus, das anzeigt, dass gerade ein dynamisches WebPart-Steuerelement (oder ein Server- bzw. Benutzersteuerelement in einer WebPartZoneBase-Zone) gelöscht wird.

OnWebPartMoved(WebPartEventArgs)

Löst das WebPartMoved-Ereignis aus, das eintritt, nachdem ein WebPart-Steuerelement an eine andere Position auf einer Seite verschoben wurde.

OnWebPartMoving(WebPartMovingEventArgs)

Löst das WebPartMoving-Ereignis aus, das anzeigt, dass gerade ein dynamisches WebPart-Steuerelement oder ein Server- bzw. Benutzersteuerelement in einer WebPartZoneBase-Zone verschoben wird.

OnWebPartsConnected(WebPartConnectionsEventArgs)

Löst das WebPartsConnected-Ereignis aus, das auftritt, nachdem eine Verbindung zwischen WebPart-Steuerelementen erstellt wurde.

OnWebPartsConnecting(WebPartConnectionsCancelEventArgs)

Löst das WebPartsConnecting-Ereignis aus, das eintritt, während eine Verbindung zwischen zwei WebPart-Steuerelementen oder Server- bzw. Benutzersteuerelementen in einer WebPartZoneBase-Zone erstellt wird.

OnWebPartsDisconnected(WebPartConnectionsEventArgs)

Löst das WebPartsDisconnected-Ereignis aus, das auftritt, nachdem eine Verbindung zwischen WebPart-Steuerelementen getrennt wurde.

OnWebPartsDisconnecting(WebPartConnectionsCancelEventArgs)

Löst das WebPartsDisconnecting-Ereignis aus, das anzeigt, dass gerade eine Verbindung zwischen zwei WebPart-Steuerelementen oder Server- bzw. Benutzersteuerelementen in einer WebPartZoneBase-Zone beendet wird.

OpenFile(String)

Ruft einen Stream zum Lesen einer Datei ab.

(Geerbt von Control)
RaiseBubbleEvent(Object, EventArgs)

Weist dem übergeordneten Element des Steuerelements alle Ereignisquellen und zugehörige Informationen zu.

(Geerbt von Control)
RegisterClientScript()

Ermöglicht dem WebPartManager-Steuerelement die Ausgabe von clientseitigen Skripts, die für verschiedene Personalisierungsfeatures verwendet werden, z. B. zum Ziehen von WebPart-Steuerelementen auf einer Webseite.

RemovedControl(Control)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls-Auflistung des Control-Objekts entfernt wurde.

(Geerbt von Control)
Render(HtmlTextWriter)

Überschrieben, um zu verhindern, dass das WebPartManager-Steuerelement Inhalt wiedergibt.

RenderChildren(HtmlTextWriter)

Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt aus, das den auf dem Client zu rendernden Inhalt schreibt.

(Geerbt von Control)
RenderControl(HtmlTextWriter)

Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist.

(Geerbt von Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten HtmlTextWriter-Objekts an ein bereitgestelltes ControlAdapter-Objekt aus.

(Geerbt von Control)
ResolveAdapter()

Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist.

(Geerbt von Control)
ResolveClientUrl(String)

Ruft eine URL ab, die vom Browser verwendet werden kann.

(Geerbt von Control)
ResolveUrl(String)

Konvertiert eine URL in eine vom anfordernden Client verwendbare URL.

(Geerbt von Control)
SaveControlState()

Speichert Zustandsdaten für das WebPartManager-Steuerelement, sodass die Daten bei einer späteren Anforderung an die Webseite, die das Steuerelement enthält, wiederhergestellt werden können.

SaveCustomPersonalizationState(PersonalizationDictionary)

Speichert benutzerdefinierte Personalisierungszustandsdaten, die vom WebPartManager-Steuerelement verwaltet werden, sodass diese Daten bei jedem erneuten Laden der Seite neu geladen werden können.

SaveViewState()

Speichert alle Ansichtszustandsänderungen des Serversteuerelements, die seit dem Zeitpunkt aufgetreten sind, zu dem die Seite an den Server zurückgesendet wurde.

(Geerbt von Control)
SetDesignModeState(IDictionary)

Legt die Entwurfszeitdaten für ein Steuerelement fest.

(Geerbt von Control)
SetPersonalizationDirty()

Legt ein Flag fest, das angibt, dass benutzerdefinierte Personalisierungsdaten für das WebPartManager-Steuerelement geändert wurden.

SetRenderMethodDelegate(RenderMethod)

Beauftragt einen Ereignishandlerdelegaten, das Serversteuerelement und seinen Inhalt im übergeordneten Steuerelement zu rendern.

(Geerbt von Control)
SetSelectedWebPart(WebPart)

Legt den Wert der SelectedWebPart-Eigenschaft auf das derzeit ausgewählte WebPart-Steuerelement oder Serversteuerelement fest.

SetTraceData(Object, Object)

Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest.

(Geerbt von Control)
SetTraceData(Object, Object, Object)

Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des verfolgten Objekts, des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest.

(Geerbt von Control)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
TrackViewState()

Wendet Personalisierungszustandsdaten auf das WebPartManager-Steuerelement an und ruft die Basismethode auf, um die Nachverfolgung von Änderungen an Ansichtszustandsdaten für das Steuerelement zu aktivieren.

Ereignisse

AuthorizeWebPart

Tritt ein, wenn die IsAuthorized-Methode aufgerufen wird, um zu bestimmen, ob einer Seite ein WebPart-Steuerelement oder Serversteuerelement hinzugefügt werden kann.

ConnectionsActivated

Tritt ein, nachdem nicht nur alle aktuellen Webparts-Verbindungen auf einer Seite verbunden wurden, sondern diese auch begonnen haben, Daten aktiv zwischen den an den einzelnen Verbindungen beteiligten Consumer- und Anbietersteuerelementen auszutauschen.

ConnectionsActivating

Tritt ein, während alle erstellten Webparts-Verbindungen auf einer Webseite aktiviert werden.

DataBinding

Tritt ein, wenn das Serversteuerelement eine Bindung an eine Datenquelle durchführt.

(Geerbt von Control)
DisplayModeChanged

Tritt ein, nachdem sich der aktuelle Anzeigemodus auf einer Webparts-Seite geändert wurde.

DisplayModeChanging

Tritt ein, wenn ein Benutzer auf einer Webseite auf ein Verb klickt, das den Prozess des Umschaltens in einen anderen Anzeigemodus startet.

Disposed

Tritt ein, wenn ein Serversteuerelement im Speicher freigegeben wird. Dies ist die letzte Stufe des Lebenszyklus des Serversteuerelements bei der Anforderung einer ASP.NET-Seite.

(Geerbt von Control)
Init

Tritt bei der Initialisierung des Serversteuerelements ein. Dies ist der erste Schritt in dessen Lebenszyklus.

(Geerbt von Control)
Load

Tritt ein, wenn das Serversteuerelement in das Page-Objekt geladen wird.

(Geerbt von Control)
PreRender

Tritt nach dem Laden des Control-Objekts, jedoch vor dem Rendern ein.

(Geerbt von Control)
SelectedWebPartChanged

Tritt ein, nachdem auf einer Webseite die Auswahl eines WebPart-Steuerelements aufgehoben und auf ein anderes Steuerelement übertragen wurde.

SelectedWebPartChanging

Tritt während des Prozesses ein, mit dem das auf der Webseite derzeit ausgewählte WebPart-Steuerelement oder Serversteuerelement geändert wird.

Unload

Tritt ein, wenn das Serversteuerelement aus dem Speicher entladen wird.

(Geerbt von Control)
WebPartAdded

Tritt ein, nachdem ein dynamisches WebPart-Steuerelement oder sonstiges Serversteuerelement einer WebPartZoneBase-Zone hinzugefügt wurde, um anzuzeigen, dass das Steuerelement erfolgreich hinzugefügt wurde.

WebPartAdding

Tritt ein, während einer WebPart-Zone ein dynamisches WebPartZoneBase-Steuerelement oder ein anderes Serversteuerelement hinzugefügt wird.

WebPartClosed

Tritt ein, wenn ein WebPart-Steuerelement (oder Server- bzw. Benutzersteuerelement) von einer Seite entfernt wird.

WebPartClosing

Tritt ein, während ein WebPart-Steuerelement (oder ein Server- bzw. Benutzersteuerelement) von einer Seite entfernt wird.

WebPartDeleted

Tritt ein, nachdem ein WebPart-Steuerelement oder sonstiges Serversteuerelement aus einer WebPartZoneBase-Zone gelöscht wurde.

WebPartDeleting

Tritt ein, während eine Instanz eines dynamischen WebPart-Steuerelements oder eines anderen Serversteuerelements dauerhaft aus einer WebPartZoneBase-Zone gelöscht wird.

WebPartMoved

Tritt ein, nachdem ein WebPart-Steuerelement oder Serversteuerelement an eine andere Position auf einer Webseite verschoben wurde.

WebPartMoving

Tritt ein, während ein in einer WebPart-Zone enthaltenes WebPartZoneBase-Steuerelement oder ein anderes Serversteuerelement verschoben wird.

WebPartsConnected

Tritt ein, nachdem eine bestimmte Verbindung zwischen WebPart-Steuerelementen (bzw. Server- oder Benutzersteuerelementen) erstellt wurde.

WebPartsConnecting

Tritt ein, während eine Verbindung zwischen WebPart-Steuerelementen (oder in einer WebPartZoneBase-Zone platzierten Server- bzw. Benutzersteuerelementen) erstellt wird.

WebPartsDisconnected

Tritt ein, nachdem eine Verbindung zwischen zwei WebPart-Steuerelementen oder Serversteuerelementen beendet wurde.

WebPartsDisconnecting

Tritt ein, während die Verbindung zwischen zuvor verbundenen WebPart-Steuerelementen oder Serversteuerelementen beendet wird.

Explizite Schnittstellenimplementierungen

IControlBuilderAccessor.ControlBuilder

Eine Beschreibung dieses Elements finden Sie unter ControlBuilder.

(Geerbt von Control)
IControlDesignerAccessor.GetDesignModeState()

Eine Beschreibung dieses Elements finden Sie unter GetDesignModeState().

(Geerbt von Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Eine Beschreibung dieses Elements finden Sie unter SetDesignModeState(IDictionary).

(Geerbt von Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Eine Beschreibung dieses Elements finden Sie unter SetOwnerControl(Control).

(Geerbt von Control)
IControlDesignerAccessor.UserData

Eine Beschreibung dieses Elements finden Sie unter UserData.

(Geerbt von Control)
IDataBindingsAccessor.DataBindings

Eine Beschreibung dieses Elements finden Sie unter DataBindings.

(Geerbt von Control)
IDataBindingsAccessor.HasDataBindings

Eine Beschreibung dieses Elements finden Sie unter HasDataBindings.

(Geerbt von Control)
IExpressionsAccessor.Expressions

Eine Beschreibung dieses Elements finden Sie unter Expressions.

(Geerbt von Control)
IExpressionsAccessor.HasExpressions

Eine Beschreibung dieses Elements finden Sie unter HasExpressions.

(Geerbt von Control)
IParserAccessor.AddParsedSubObject(Object)

Eine Beschreibung dieses Elements finden Sie unter AddParsedSubObject(Object).

(Geerbt von Control)
IPersonalizable.IsDirty

Ruft einen Wert ab, der angibt, ob mit dem WebPartManager-Steuerelement verwaltete benutzerdefinierte Personalisierungszustandsdaten auf einer Webseite geändert wurden.

IPersonalizable.Load(PersonalizationDictionary)

Gibt zuvor gespeicherte benutzerdefinierte Personalisierungszustandsdaten zurück, die in das WebPartManager-Steuerelement geladen werden müssen.

IPersonalizable.Save(PersonalizationDictionary)

Speichert benutzerdefinierte Personalisierungszustandsdaten, die vom WebPartManager-Steuerelement verwaltet werden.

Erweiterungsmethoden

FindDataSourceControl(Control)

Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist.

FindFieldTemplate(Control, String)

Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück.

FindMetaTable(Control)

Gibt das Metatabellenobjekt für das enthaltende Datensteuerelement zurück.

GetDefaultValues(INamingContainer)

Ruft die Auflistung der Standardwerte für das angegebene Datensteuerelement ab.

GetMetaTable(INamingContainer)

Ruft die Tabellenmetadaten für das angegebene Datensteuerelement ab.

SetMetaTable(INamingContainer, MetaTable)

Legt die Tabellenmetadaten für das angegebene Datensteuerelement fest.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Legt die Zuordnung für Tabellenmetadaten und Standardwerte für das angegebene Datensteuerelement fest.

SetMetaTable(INamingContainer, MetaTable, Object)

Legt die Zuordnung für Tabellenmetadaten und Standardwerte für das angegebene Datensteuerelement fest.

TryGetMetaTable(INamingContainer, MetaTable)

Bestimmt, ob Tabellenmetadaten verfügbar sind.

EnableDynamicData(INamingContainer, Type)

Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement

EnableDynamicData(INamingContainer, Type, Object)

Aktiviert das Verhalten dynamischer Daten für das angegebene Datensteuerelement

Gilt für:

Weitere Informationen