Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Fungiert als zentrale Klasse der Webparts-Steuerelemente, die alle Webparts-Steuerelemente, Webparts-Funktionen und Webparts-Ereignisse verwaltet, die auf einer Webseite auftreten.
<asp:WebPartManager
CloseProviderWarning="string"
DeleteWarning="string"
EnableClientScript="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
ExportSensitiveDataWarning="string"
ID="string"
OnAuthorizeWebPart="AuthorizeWebPart event handler"
OnConnectionsActivated="ConnectionsActivated event handler"
OnConnectionsActivating="ConnectionsActivating event handler"
OnDataBinding="DataBinding event handler"
OnDisplayModeChanged="DisplayModeChanged event handler"
OnDisplayModeChanging="DisplayModeChanging event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnSelectedWebPartChanged="SelectedWebPartChanged event handler"
OnSelectedWebPartChanging="SelectedWebPartChanging event handler"
OnUnload="Unload event handler"
OnWebPartAdded="WebPartAdded event handler"
OnWebPartAdding="WebPartAdding event handler"
OnWebPartClosed="WebPartClosed event handler"
OnWebPartClosing="WebPartClosing event handler"
OnWebPartDeleted="WebPartDeleted event handler"
OnWebPartDeleting="WebPartDeleting event handler"
OnWebPartMoved="WebPartMoved event handler"
OnWebPartMoving="WebPartMoving event handler"
OnWebPartsConnected="WebPartsConnected event handler"
OnWebPartsConnecting="WebPartsConnecting event handler"
OnWebPartsDisconnected="WebPartsDisconnected event handler"
OnWebPartsDisconnecting="WebPartsDisconnecting event handler"
Personalization-Enabled="True|False"
Personalization-InitialScope="User|Shared"
Personalization-ProviderName="string"
runat="server"
SkinID="string"
>
<Personalization
Enabled="True|False"
InitialScope="User|Shared"
ProviderName="string" />
<StaticConnections>
<asp:WebPartConnection
ConsumerConnectionPointID="string"
ConsumerID="string"
ID="string"
ProviderConnectionPointID="string"
ProviderID="string" >
<asp:RowToFieldTransformer
FieldName="string" />
<asp:RowToParametersTransformer
ConsumerFieldNames="string"
ProviderFieldNames="string"/>
</asp:WebPartConnection>
</StaticConnections>
</asp:WebPartManager>
Hinweise
Das WebPartManager-Steuerelement fungiert als Hub oder Kontrollcenter einer Webparts-Anwendung. Auf jeder Seite, die Webparts-Steuerelemente verwendet, muss genau eine Instanz des WebPartManager-Steuerelements vorhanden sein, und sie muss vor allen Zonensteuerelementen platziert werden. Wie die meisten Funktionen in Webparts-Anwendungen kann das WebPartManager-Steuerelement nur von authentifizierten Benutzern verwendet werden. Außerdem sind seine Funktionen fast gänzlich mit Serversteuerelementen in Webparts-Zonen wirksam, die von der WebZone-Klasse erben. Serversteuerelemente, die sich auf einer Seite außerhalb dieser Zonen befinden, können sehr wenige Webparts-Funktionen oder geringe Interaktion mit dem WebPartManager-Steuerelement aufweisen.
Weitere Informationen zum WebPartManager-Steuerelement und zu Webparts-Steuerelementen finden Sie unter ASP.NET-Webparts-Steuerelemente.
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie das WebPartManager-Steuerelement mithilfe des Calendar-Steuerelements deklarativ in einem Webparts-Szenario verwendet wird. Mithilfe der Webseite können Benutzer zum Benutzermodus wechseln, um bestimmte Aspekte des Calendar-Steuerelements zu bearbeiten. Über die Schaltfläche Toggle Scope wird die Seite zwischen Benutzerpersonalisierungsbereich und freigegebenem Personalisierungsbereich hin- und hergeschaltet. Über die Schaltflächen Edit Mode und Browse Mode schalten Sie die Seite in den entsprechenden Anzeigemodus um. Im <script>-Tagabschnitt der Datei verwenden zwei der Methoden, die Ereignisse behandeln, die Personalization-Eigenschaft, um auf nützliche Member des zugrunde liegenden Objekts zuzugreifen. Diese Methoden verwenden speziell die ToggleScope-Methode und die Scope-Eigenschaft auf dem Objekt, auf das über die Personalization-Eigenschaft zugegriffen wird.
Damit das Codebeispiel ausgeführt werden kann, müssen Sie auch die Personalisierung von Seiten im freigegebenen Bereich aktivieren. Dazu muss der Datei Web.config in webParts-Element (ASP.NET-Einstellungsschema) ein Eintrag hinzugefügt werden.
<%@ Page Language="VB" %>
<!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 Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)
If ((mgr1.Personalization.Scope = PersonalizationScope.User) _
And (mgr1.Personalization.CanEnterSharedScope)) Then
mgr1.Personalization.ToggleScope()
ElseIf (mgr1.Personalization.Scope = PersonalizationScope.Shared) Then
mgr1.Personalization.ToggleScope()
Else
'If the user cannot enter shared scope you may want
' to notify them on the page.
End If
End Sub
Protected Sub Button2_Click(ByVal sender As Object, ByVal e As System.EventArgs)
mgr1.DisplayMode = WebPartManager.EditDisplayMode
End Sub
Protected Sub Button3_Click(ByVal sender As Object, ByVal e As System.EventArgs)
mgr1.DisplayMode = WebPartManager.BrowseDisplayMode
End Sub
Protected Sub Page_Load(ByVal sender As Object, ByVal e As CommandEventArgs)
Label1.Text = "Scope is: " _
+ mgr1.Personalization.Scope.ToString()
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
<title>Web Parts Declarative Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:LoginName id="LoginName1" runat="server" />
<asp:WebPartManager id="mgr1" runat="server">
<Personalization InitialScope="Shared" Enabled="True" />
</asp:WebPartManager>
<asp:WebPartZone id="WebPartZone1" runat="server">
<ZoneTemplate>
<asp:Calendar id="Calendar1" runat="server" />
</ZoneTemplate>
<CloseVerb Text="Close This Part" />
<MinimizeVerb Text="Minimize This Part" />
<EditVerb Text="Edit This Part" />
</asp:WebPartZone>
<asp:EditorZone id="EditorZone1" runat="server">
<ZoneTemplate>
<asp:LayoutEditorPart HorizontalAlign="Center" id="Layout1" runat="server" Title="My Custom Layout" />
<asp:AppearanceEditorPart id="AppearanceEditorPart1"
runat="server" BackColor="LightGray" />
<asp:BehaviorEditorPart id="BehaviorEditorPart1"
runat="server" />
</ZoneTemplate>
</asp:EditorZone>
<hr />
<asp:Button id="Button1" runat="server" Text="Toggle Scope" OnClick="Button1_Click" />
<asp:Button id="Button2" runat="server" Text="Edit Mode" OnClick="Button2_Click" />
<asp:Button id="Button3" runat="server" Text="Browse Mode" OnClick="Button3_Click" />
<br />
<asp:Label id="Label1" runat="server" Text="" />
</div>
</form>
</body>
</html>
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void Button1_Click(object sender, EventArgs e)
{
if ((mgr1.Personalization.Scope == PersonalizationScope.User)
&& (mgr1.Personalization.CanEnterSharedScope))
{
mgr1.Personalization.ToggleScope();
}
else if (mgr1.Personalization.Scope ==
PersonalizationScope.Shared)
{
mgr1.Personalization.ToggleScope();
}
else
{
// If the user cannot enter shared scope you may want
// to notify them on the page.
}
}
protected void Button2_Click(object sender, EventArgs e)
{
mgr1.DisplayMode = WebPartManager.EditDisplayMode;
}
protected void Button3_Click(object sender, EventArgs e)
{
mgr1.DisplayMode = WebPartManager.BrowseDisplayMode;
}
protected void Page_Load(object sender, EventArgs e)
{
Label1.Text = "Scope is: "
+ mgr1.Personalization.Scope.ToString();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
<title>Web Parts Declarative Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:LoginName id="LoginName1" runat="server" />
<asp:WebPartManager id="mgr1" runat="server">
<Personalization InitialScope="Shared" Enabled="True" />
</asp:WebPartManager>
<asp:WebPartZone id="WebPartZone1" runat="server">
<ZoneTemplate>
<asp:Calendar id="Calendar1" runat="server" />
</ZoneTemplate>
<CloseVerb Text="Close This Part" />
<MinimizeVerb Text="Minimize This Part" />
<EditVerb Text="Edit This Part" />
</asp:WebPartZone>
<asp:EditorZone id="EditorZone1" runat="server">
<ZoneTemplate>
<asp:LayoutEditorPart HorizontalAlign="Center" id="Layout1" runat="server" Title="My Custom Layout" />
<asp:AppearanceEditorPart id="AppearanceEditorPart1"
runat="server" BackColor="LightGray" />
<asp:BehaviorEditorPart id="BehaviorEditorPart1"
runat="server" />
</ZoneTemplate>
</asp:EditorZone>
<hr />
<asp:Button id="Button1" runat="server" Text="Toggle Scope" OnClick="Button1_Click" />
<asp:Button id="Button2" runat="server" Text="Edit Mode" OnClick="Button2_Click" />
<asp:Button id="Button3" runat="server" Text="Browse Mode" OnClick="Button3_Click" />
<br />
<asp:Label id="Label1" runat="server" Text="" />
</div>
</form>
</body>
</html>