WebPartManager.AuthorizeWebPart Händelse
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Inträffar när IsAuthorized metoden anropas för att avgöra om en eller serverkontroll WebPart kan läggas till på en sida.
public:
event System::Web::UI::WebControls::WebParts::WebPartAuthorizationEventHandler ^ AuthorizeWebPart;
public event System.Web.UI.WebControls.WebParts.WebPartAuthorizationEventHandler AuthorizeWebPart;
member this.AuthorizeWebPart : System.Web.UI.WebControls.WebParts.WebPartAuthorizationEventHandler
Public Custom Event AuthorizeWebPart As WebPartAuthorizationEventHandler
Händelsetyp
Exempel
Följande kodexempel visar hur du anger en anpassad händelsehanterare för AuthorizeWebPart händelsen, som automatiskt åsidosätter standardmetoden OnAuthorizeWebPart .
Koden i mgr1_AuthorizeWebPart metoden kontrollerar om kontrollerna på sidan har sina respektive AuthorizationFilter egenskapsvärden inställda på user och i så fall returnerar true, vilket innebär att de kommer att auktoriseras och läggas till på sidan. Detta förutsätter att standardmetoden är att tillåta användare att visa kontroller med en sida i användaranpassningsomfånget. Observera dock att i exemplet har en av kontrollerna dess egenskapsvärde AuthorizationFilter inställt på admin. Utvecklare kan placera det här filtret på en specialiserad kontroll som endast har utformats för administrativa användare att se. Den här kontrollen misslyckas med auktoriseringskontrollen under AuthorizeWebPart händelsen och visas inte. Observera att kontroller som inte har egenskapsuppsättningen också visas. de antas inte vara en del av ett filtreringsscenario eftersom deras AuthorizationFilter egenskaper inte har angetts.
<%@ 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 mgr1_AuthorizeWebPart(object sender,
WebPartAuthorizationEventArgs e)
{
if (!String.IsNullOrEmpty(e.AuthorizationFilter))
{
if (e.AuthorizationFilter == "user")
e.IsAuthorized = true;
else
e.IsAuthorized = false;
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Untitled Page</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:WebPartManager ID="mgr1" runat="server"
OnAuthorizeWebPart="mgr1_AuthorizeWebPart" />
<asp:WebPartZone ID="WebPartZone1" runat="server">
<ZoneTemplate>
<asp:BulletedList
ID="BulletedList1"
Runat="server"
DisplayMode="HyperLink"
Title="Favorite Links"
AuthorizationFilter="admin">
<asp:ListItem Value="http://msdn.microsoft.com">
MSDN
</asp:ListItem>
<asp:ListItem Value="http://www.asp.net">
ASP.NET
</asp:ListItem>
<asp:ListItem Value="http://www.msn.com">
MSN
</asp:ListItem>
</asp:BulletedList>
<asp:Label ID="Label1" runat="server"
Text="Hello World"
Title="Filter Test"
AuthorizationFilter="admin" />
<asp:Calendar ID="Calendar1" runat="server"
Title="My Calendar"/>
</ZoneTemplate>
</asp:WebPartZone>
</div>
</form>
</body>
</html>
<%@ 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 mgr1_AuthorizeWebPart(ByVal sender As Object, _
ByVal e As WebPartAuthorizationEventArgs)
If Not String.IsNullOrEmpty(e.AuthorizationFilter) Then
If e.AuthorizationFilter = "user" Then
e.IsAuthorized = True
Else
e.IsAuthorized = False
End If
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Untitled Page</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:WebPartManager ID="mgr1" runat="server"
OnAuthorizeWebPart="mgr1_AuthorizeWebPart" />
<asp:WebPartZone ID="WebPartZone1" runat="server">
<ZoneTemplate>
<asp:BulletedList
ID="BulletedList1"
Runat="server"
DisplayMode="HyperLink"
Title="Favorite Links"
AuthorizationFilter="admin">
<asp:ListItem Value="http://msdn.microsoft.com">
MSDN
</asp:ListItem>
<asp:ListItem Value="http://www.asp.net">
ASP.NET
</asp:ListItem>
<asp:ListItem Value="http://www.msn.com">
MSN
</asp:ListItem>
</asp:BulletedList>
<asp:Label ID="Label1" runat="server"
Text="Hello World"
Title="Filter Test"
AuthorizationFilter="admin" />
<asp:Calendar ID="Calendar1" runat="server"
Title="My Calendar"/>
</ZoneTemplate>
</asp:WebPartZone>
</div>
</form>
</body>
</html>
Kommentarer
Händelsen AuthorizeWebPart inträffar när en WebPart kontroll läggs till på en sida. Det finns ett antal vanliga scenarier där en kontroll kan läggas till på en sida. En fullständig beskrivning av dessa finns i avsnittet Anmärkningar för IsAuthorized metoden. När en kontroll läggs till måste den kontrolleras för att se om dess AuthorizationFilter egenskap har angetts och i så fall om kontrollen har behörighet att läggas till på sidan.
Utvecklare kan skapa händelsehanterare för händelsen för AuthorizeWebPart att tillhandahålla filtrering för kontroller. Om en kontrolls egenskapsvärde AuthorizationFilter inte uppfyller kriterierna i händelsehanterarkoden läggs kontrollen inte till på sidan.