WebPartManager.AuthorizeWebPart Событие

  • Ссылка

Определение

Пространство имен:
System.Web.UI.WebControls.WebParts
Сборка:
System.Web.dll

Происходит при вызове метода IsAuthorized для определения, можно ли добавить на страницу объект WebPart или серверный элемент управления.

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

Тип события

WebPartAuthorizationEventHandler

Примеры

В следующем примере кода показано, как задать настраиваемый обработчик событий для AuthorizeWebPart события, который автоматически переопределяет метод по умолчанию OnAuthorizeWebPart .

Код в методе mgr1_AuthorizeWebPart проверяет, имеют ли элементы управления на странице соответствующие AuthorizationFilter значения user свойств , и, если да, возвращает true, то есть они будут авторизованы и добавлены на страницу. Предполагается, что по умолчанию пользователи могут просматривать элементы управления со страницей в область персонализации пользователя. Обратите внимание, однако, что в примере одного из элементов управления AuthorizationFilter свойство имеет adminзначение . Разработчики могут поместить этот фильтр в специализированный элемент управления, предназначенный для просмотра только пользователями с правами администратора. Этот элемент управления не сможет проверка авторизации во время AuthorizeWebPart события и не будет отображаться. Обратите внимание, что также отображаются элементы управления, для которых не задано свойство ; Предполагается, что они не являются частью сценария фильтрации, так как их AuthorizationFilter свойства не заданы.

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

Комментарии

Это AuthorizeWebPart событие возникает при каждом добавлении WebPart элемента управления на страницу. Существует ряд распространенных сценариев, в которых элемент управления можно добавить на страницу. Полное описание см. в разделе Примечания для IsAuthorized метода . При добавлении элемента управления его необходимо проверить, задано ли его AuthorizationFilter свойство и, если да, авторизован ли элемент управления для добавления на страницу.

Разработчики могут создавать обработчики событий для AuthorizeWebPart события, чтобы обеспечить фильтрацию элементов управления. Если значение свойства элемента управления AuthorizationFilter не соответствует критериям в коде обработчика событий, элемент управления не добавляется на страницу.

Применяется к

См. также раздел