WebPartManager.IsAuthorized Método

public:
 bool IsAuthorized(System::Web::UI::WebControls::WebParts::WebPart ^ webPart);

public bool IsAuthorized(System.Web.UI.WebControls.WebParts.WebPart webPart);

member this.IsAuthorized : System.Web.UI.WebControls.WebParts.WebPart -> bool

Public Function IsAuthorized (webPart As WebPart) As Boolean

Parâmetros

Devoluções

Um valor booleano que indica se webPart pode ser adicionado a uma página.

Exceções

Exemplos

O exemplo de código seguinte demonstra como chamar o IsAuthorized(WebPart) método a partir do seu código para determinar se um controlo está autorizado a ser adicionado a uma página.

O exemplo de código tem três partes:

• Um controlo personalizado WebPartManager que sobrepõe o IsAuthorized método.

• Uma página Web que cria um filtro para um WebPart controlo.

• Uma explicação de como executar o exemplo do código.

Este exemplo de código utiliza um controlo personalizado WebPartManager que sobrepõe o IsAuthorized(Type, String, String, Boolean) método de sobrecarga para fornecer um tratamento personalizado da AuthorizationFilter propriedade. Este controlo verifica o valor de uma propriedade e admin , se o valor estiver presente, autoriza o controlo. Se um controlo tiver um valor diferente, não é autorizado; Controlos sem o valor da propriedade também são autorizados, pois presume-se que não fazem parte do cenário de filtragem.

Para que este exemplo de código seja executado, deve compilar este código-fonte. Pode compilar explicitamente e colocar o assembly resultante na pasta Bin do seu site ou na cache global assembly. Alternativamente, pode colocar o código-fonte na pasta App_Code do seu site, onde será compilado dinamicamente em tempo de execução. Este exemplo de código utiliza o método de compilação dinâmica. Para um guia que demonstra como compilar, consulte Guia: Desenvolvimento e Utilização de um Controlo de Servidor Web Personalizado.

using System;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;

namespace Samples.AspNet.CS.Controls
{
  public class MyManagerAuthorize : WebPartManager
  {
    public override bool IsAuthorized(Type type, string path, string authorizationFilter, bool isShared)
    {
      if (!String.IsNullOrEmpty(authorizationFilter))
      {
        if (authorizationFilter == "admin")
          return true;
        else
          return false;
      }
      else
            {
                return true;
            }
        }
  }
}

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 Class MyManagerAuthorize
    Inherits WebPartManager

    Public Overrides Function IsAuthorized(ByVal type As Type, _
      ByVal path As String, ByVal authorizationFilter As String, _
      ByVal isShared As Boolean) As Boolean

      If Not String.IsNullOrEmpty(authorizationFilter) Then
        If authorizationFilter = "admin" Then
          Return True
        Else
          Return False
        End If
      Else
        Return True
      End If

    End Function

  End Class

End Namespace

A segunda parte do exemplo de código cria um filtro que pode potencialmente excluir um controlo. A página Web seguinte contém três controlos de servidor ASP.NET num elemento <asp:webpartzone>. Note que o primeiro e o segundo controlos têm as suas AuthorizationFilter propriedades definidas com valores diferentes, e o terceiro não atribui essa propriedade. Este valor de autorização pode ser verificado em tempo de execução, e o controlo pode ser adicionado à página se o filtro corresponder aos critérios definidos pelo programador. Note também que, no Page_Load método, o código chama o IsAuthorized(WebPart) método para determinar se cada um dos controlos está autorizado e, em caso afirmativo, define a propriedade de ExportMode cada controlo.

<%@ Page Language="C#" %>
<%@ Register Namespace="Samples.AspNet.CS.Controls" 
    TagPrefix="aspSample"%>


<!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 Page_Load(object sender, EventArgs e)
  {
    foreach (WebPart part in mgr1.WebParts)
    {
      if (mgr1.IsAuthorized(part))
        part.ExportMode = WebPartExportMode.All;
    }
    
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <aspSample:MyManagerAuthorize ID="mgr1" runat="server"  />
      <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"
            AuthorizationFilter="user" />
          <asp:Calendar ID="Calendar1" runat="server"></asp:Calendar>
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <asp:Literal ID="Literal1" runat="server"></asp:Literal>
    </div>
    </form>
</body>
</html>

<%@ Page Language="vb" %>
<%@ Register Namespace="Samples.AspNet.VB.Controls" 
    TagPrefix="aspSample"%>


<!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 Page_Load(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    
    Dim part As WebPart
    For Each part In mgr1.WebParts
      If mgr1.IsAuthorized(part) Then
        part.ExportMode = WebPartExportMode.All
      End If
    Next
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <aspSample:MyManagerAuthorize ID="mgr1" runat="server"  />
      <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"
            AuthorizationFilter="user" />
          <asp:Calendar ID="Calendar1" runat="server"></asp:Calendar>
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <asp:Literal ID="Literal1" runat="server"></asp:Literal>
    </div>
    </form>
</body>
</html>

Note que, para o exemplo de código funcionar, deve adicionar uma definição no ficheiro Web.config para permitir a exportação de ficheiros de descrição de Web Parts. Certifique-se de que tem um ficheiro Web.config no mesmo diretório da página Web para este exemplo de código. Dentro da <system.web> secção, certifique-se de que existe um <webParts> elemento com um enableExport atributo definido como true, como na marcação seguinte.

<webParts enableExport="true">

...

</webParts>

Depois de carregar a página num navegador, note que o primeiro controlo é exibido, porque corresponde aos critérios do método sobreposto. O segundo controlo não é adicionado à página, porque é excluído pelo filtro. O terceiro controlo também é adicionado, porque não tem a sua AuthorizationFilter propriedade definida. Repare que, se clicar no ícone do menu verbos na barra de título de qualquer um dos controlos, ambos podem ser exportados porque os respetivos ExportMode valores de propriedade foram atribuídos.

Observações

O IsAuthorized método é o método inicial chamado pelo conjunto de controlos Web Parts para verificar a autorização de um WebPart controlo. Aceita webPart como parâmetro e inicia um processo que determina, em última análise, se o controlo será adicionado a uma página. Chame este método diretamente do seu código quando precisar de determinar se um determinado controlo está autorizado.

Este método executa as tarefas iniciais de determinar se o controlo herda da WebPart classe ou é um GenericWebPart controlo e, em caso afirmativo, que tipo de controlo filho contém. Para concluir a tarefa de autorização, chama o IsAuthorized(Type, String, String, Boolean) método de sobrecarga.

Notas para Chamadores

Este método é chamado diretamente do seu código. Se quiser obter maior controlo programático sobre o processo de autorização, pode sobrepor o IsAuthorized(Type, String, String, Boolean) método de sobrecarga.

Ver também

• AuthorizationFilter
• AuthorizeWebPart
• OnAuthorizeWebPart(WebPartAuthorizationEventArgs)
• ASP.NET Controlos de Web Parts

public:
 virtual bool IsAuthorized(Type ^ type, System::String ^ path, System::String ^ authorizationFilter, bool isShared);

public virtual bool IsAuthorized(Type type, string path, string authorizationFilter, bool isShared);

abstract member IsAuthorized : Type * string * string * bool -> bool
override this.IsAuthorized : Type * string * string * bool -> bool

Public Overridable Function IsAuthorized (type As Type, path As String, authorizationFilter As String, isShared As Boolean) As Boolean

Parâmetros

Devoluções

Um valor booleano que indica se um controlo está autorizado a ser adicionado a uma página.

Exceções

Exemplos

O exemplo de código seguinte demonstra como sobrescrever o IsAuthorized método para determinar se um controlo está autorizado a ser adicionado a uma página.

O primeiro passo é criar um filtro que possa potencialmente excluir um controlo. A página Web seguinte contém três controlos de servidor ASP.NET num elemento <asp:webpartzone>. Note que o primeiro e o segundo controlos têm as suas AuthorizationFilter propriedades definidas com valores diferentes, e o terceiro não atribui essa propriedade. Este valor de autorização pode ser verificado em tempo de execução, e o controlo pode ser adicionado à página se o filtro corresponder aos critérios definidos pelo programador.

<%@ Page Language="C#" %>
<%@ Register Namespace="Samples.AspNet.CS.Controls" 
    TagPrefix="aspSample"%>


<!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 Page_Load(object sender, EventArgs e)
  {
    foreach (WebPart part in mgr1.WebParts)
    {
      if (mgr1.IsAuthorized(part))
        part.ExportMode = WebPartExportMode.All;
    }
    
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <aspSample:MyManagerAuthorize ID="mgr1" runat="server"  />
      <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"
            AuthorizationFilter="user" />
          <asp:Calendar ID="Calendar1" runat="server"></asp:Calendar>
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <asp:Literal ID="Literal1" runat="server"></asp:Literal>
    </div>
    </form>
</body>
</html>

<%@ Page Language="vb" %>
<%@ Register Namespace="Samples.AspNet.VB.Controls" 
    TagPrefix="aspSample"%>


<!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 Page_Load(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    
    Dim part As WebPart
    For Each part In mgr1.WebParts
      If mgr1.IsAuthorized(part) Then
        part.ExportMode = WebPartExportMode.All
      End If
    Next
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <aspSample:MyManagerAuthorize ID="mgr1" runat="server"  />
      <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"
            AuthorizationFilter="user" />
          <asp:Calendar ID="Calendar1" runat="server"></asp:Calendar>
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <asp:Literal ID="Literal1" runat="server"></asp:Literal>
    </div>
    </form>
</body>
</html>

O segundo passo é sobrepor o IsAuthorized(Type, String, String, Boolean) método e criar tratamento personalizado para filtros de autorização. Note-se que o código verifica primeiro se a propriedade tem um valor, de modo que qualquer controlo que não atribua a AuthorizationFilter propriedade será adicionado automaticamente. Se um controlo tiver um filtro, o código retorna true apenas se o valor do filtro for igual a admin. Isto demonstra um mecanismo simples que pode usar para mostrar certos controlos a determinados utilizadores, dependendo do seu papel. Embora um exemplo completo usando papéis esteja fora do âmbito deste tópico, poderia usar a mesma lógica do método sobreposto neste exemplo de código, exceto que poderia verificar se o utilizador atual está numa função que corresponde ao valor do filtro de autorização, e depois adicionar o controlo apenas para esse utilizador. Isto permitiria criar páginas onde alguns utilizadores veriam todos os controlos, e outros apenas os controlos selecionados. É assim que a lógica que verifica o filtro pode parecer se usasse papéis:

If Roles.IsUserInRole(Page.User.Identity.Name, authorizationFilter) Then
  return True
Else
  return False
End If

if(Roles.IsUserInRole(Page.User.Identity.Name, authorizationFilter))
    return true;
else
    return false;

Para que o exemplo de código seja executado, tens de compilar este código-fonte. Pode compilar explicitamente e colocar o assembly resultante na pasta Bin do seu site ou na cache global assembly. Alternativamente, pode colocar o código-fonte na pasta App_Code do seu site, onde será compilado dinamicamente em tempo de execução. Este exemplo de código utiliza o método de compilação dinâmica. Para um guia que demonstra como compilar, consulte Guia: Desenvolvimento e Utilização de um Controlo de Servidor Web Personalizado.

using System;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;

namespace Samples.AspNet.CS.Controls
{
  public class MyManagerAuthorize : WebPartManager
  {
    public override bool IsAuthorized(Type type, string path, string authorizationFilter, bool isShared)
    {
      if (!String.IsNullOrEmpty(authorizationFilter))
      {
        if (authorizationFilter == "admin")
          return true;
        else
          return false;
      }
      else
            {
                return true;
            }
        }
  }
}

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 Class MyManagerAuthorize
    Inherits WebPartManager

    Public Overrides Function IsAuthorized(ByVal type As Type, _
      ByVal path As String, ByVal authorizationFilter As String, _
      ByVal isShared As Boolean) As Boolean

      If Not String.IsNullOrEmpty(authorizationFilter) Then
        If authorizationFilter = "admin" Then
          Return True
        Else
          Return False
        End If
      Else
        Return True
      End If

    End Function

  End Class

End Namespace

Depois de carregar a página num navegador, note que o primeiro controlo é exibido, porque corresponde aos critérios do método sobreposto. O segundo controlo não é adicionado à página, porque o seu valor de filtro é excluído. O terceiro controlo é adicionado, porque não tem a sua AuthorizationFilter propriedade definida. Se alterar o valor da propriedade no segundo controlo para corresponder ao do primeiro controlo, e depois executar a página novamente, o segundo controlo também é adicionado.

Observações

O IsAuthorized(Type, String, String, Boolean) método de sobrecarga executa os passos finais para determinar se um controlo está autorizado a ser adicionado a uma página. O método garante que type é um tipo válido, e que path só tem valor se o controlo verificado for de utilizador. Depois chama o método crítico OnAuthorizeWebPart , que eleva o AuthorizeWebPart evento.

Notas para Herdeiros

Este método pode ser ultrapassado ao herdar da WebPartManager classe, se quiser fornecer tratamento adicional ao verificar a autorização. Pode querer sobrescrever o método para verificar certos valores no authorizationFilter parâmetro e, com base no valor, devolver um valor booleano que determine se o controlo será adicionado a uma página.

Para os programadores de páginas que também querem verificar filtros de autorização e fornecer tratamento personalizado, existe uma opção para fazer isto inline numa página .aspx, ou num ficheiro code-behind, sem ter de herdar de nenhuma classe. Podes declarar um gestor de eventos alternativo na página para o OnAuthorizeWebPart(WebPartAuthorizationEventArgs) método do WebPartManager controlo. Para mais detalhes e um exemplo, consulte o OnAuthorizeWebPart(WebPartAuthorizationEventArgs) método.

Ver também

• AuthorizationFilter
• AuthorizeWebPart
• OnAuthorizeWebPart(WebPartAuthorizationEventArgs)
• ASP.NET Controlos de Web Parts