WebPartManager.IsAuthorized Metodo

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

Parametri

Restituisce

Valore Boolean che indica se è possibile aggiungere webPart a una pagina.

Eccezioni

Esempio

Nell'esempio di codice seguente viene illustrato come chiamare il IsAuthorized(WebPart) metodo dal codice per determinare se un controllo è autorizzato ad essere aggiunto a una pagina.

L'esempio di codice include tre parti:

• Controllo personalizzato WebPartManager che esegue l'override del IsAuthorized metodo.

• Pagina Web che crea un filtro per un WebPart controllo.

• Spiegazione di come eseguire l'esempio di codice.

Questo esempio di codice usa un controllo personalizzato WebPartManager che esegue l'override del IsAuthorized(Type, String, String, Boolean) metodo di overload per fornire una gestione personalizzata della AuthorizationFilter proprietà. Questo controllo controlla il valore della proprietà e admin , se il valore è presente, autorizza il controllo. Se un controllo ha un valore diverso, non è autorizzato; anche i controlli senza il valore della proprietà sono autorizzati, poiché si presuppone che non facciano parte dello scenario di filtro.

Per eseguire questo esempio di codice, è necessario compilare questo codice sorgente. È possibile compilarlo in modo esplicito e inserire l'assembly risultante nella cartella Bin del sito Web o nella global assembly cache. In alternativa, è possibile inserire il codice sorgente nella cartella App_Code del sito, in cui verrà compilato dinamicamente in fase di esecuzione. Questo esempio di codice usa il metodo di compilazione dinamico. Per una procedura dettagliata che illustra come compilare, vedere Procedura dettagliata: Sviluppo e uso di un controllo server Web personalizzato.

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

La seconda parte dell'esempio di codice crea un filtro che può potenzialmente escludere un controllo. La pagina Web seguente contiene tre controlli server ASP.NET in un <asp:webpartzone> elemento. Si noti che i primi e i secondi controlli hanno le relative AuthorizationFilter proprietà impostate su valori diversi e il terzo non assegna la proprietà. Questo valore di autorizzazione può essere controllato in fase di esecuzione e il controllo può essere aggiunto alla pagina se il filtro corrisponde ai criteri impostati dallo sviluppatore. Si noti anche che nel Page_Load metodo il codice chiama il IsAuthorized(WebPart) metodo per determinare se ognuno dei controlli è autorizzato e, in caso affermativo, imposta la proprietà di ExportMode ogni controllo.

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

Si noti che per il funzionamento dell'esempio di codice è necessario aggiungere un'impostazione nel file Web.config per abilitare l'esportazione dei file di descrizione web part. Assicurarsi di avere un file Web.config nella stessa directory della pagina Web per questo esempio di codice. All'interno della <system.web> sezione assicurarsi che sia presente un elemento con un <webParts>enableExport attributo impostato su true, come nel markup seguente.

<webParts enableExport="true">

...

</webParts>

Dopo aver caricato la pagina in un browser, si noti che il primo controllo viene visualizzato, perché corrisponde ai criteri nel metodo sottoposto a override. Il secondo controllo non viene aggiunto alla pagina, perché è escluso dal filtro. Il terzo controllo viene aggiunto anche perché non ha il relativo AuthorizationFilter set di proprietà. Si noti che se si fa clic sull'icona del menu verbi nella barra del titolo di entrambi i controlli, è possibile esportare entrambi perché sono stati assegnati i rispettivi ExportMode valori di proprietà.

Commenti

Il IsAuthorized metodo è il metodo iniziale chiamato dal controllo Web part impostato per controllare l'autorizzazione per un WebPart controllo. webPart Accetta come parametro e inizia un processo che determina in definitiva se il controllo verrà aggiunto a una pagina. Chiamare questo metodo dal codice direttamente quando è necessario determinare se un determinato controllo è autorizzato.

Questo metodo esegue le attività iniziali per determinare se il controllo eredita dalla WebPart classe o è un GenericWebPart controllo e, in tal caso, quale tipo di controllo figlio contiene. Per completare l'attività di autorizzazione, chiama il IsAuthorized(Type, String, String, Boolean) metodo di overload.

Note per i chiamanti

Questo metodo viene chiamato direttamente dal codice. Se si vuole ottenere un maggiore controllo programmatico sul processo di autorizzazione, è possibile eseguire l'override del IsAuthorized(Type, String, String, Boolean) metodo di overload.

Vedi anche

• AuthorizationFilter
• AuthorizeWebPart
• OnAuthorizeWebPart(WebPartAuthorizationEventArgs)
• ASP.NET controlli web part

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

Parametri

Restituisce

Valore Boolean che indica se un controllo dispone dell'autorizzazione all'aggiunta a una pagina.

Eccezioni

Esempio

Nell'esempio di codice seguente viene illustrato come eseguire l'override del IsAuthorized metodo per determinare se un controllo è autorizzato a essere aggiunto a una pagina.

Il primo passaggio consiste nel creare un filtro che può potenzialmente escludere un controllo. La pagina Web seguente contiene tre controlli server ASP.NET in un <asp:webpartzone> elemento. Si noti che i primi e i secondi controlli hanno le relative AuthorizationFilter proprietà impostate su valori diversi e il terzo non assegna la proprietà. Questo valore di autorizzazione può essere controllato in fase di esecuzione e il controllo può essere aggiunto alla pagina se il filtro corrisponde ai criteri impostati dallo sviluppatore.

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

Il secondo passaggio consiste nell'eseguire l'override del IsAuthorized(Type, String, String, Boolean) metodo e creare una gestione personalizzata per i filtri di autorizzazione. Si noti che il codice verifica prima se la proprietà ha un valore, in modo che qualsiasi controllo che non assegna la AuthorizationFilter proprietà verrà aggiunto automaticamente. Se un controllo ha un filtro, il codice restituisce true solo se il valore del filtro è uguale a admin. In questo modo viene illustrato un meccanismo semplice che è possibile usare per visualizzare determinati controlli a determinati utenti, a seconda del proprio ruolo. Anche se un esempio completo che usa ruoli non rientra nell'ambito di questo argomento, è possibile usare la stessa logica del metodo sottoposto a override in questo esempio di codice, ad eccezione del fatto che è possibile verificare se l'utente corrente è in un ruolo corrispondente al valore del filtro di autorizzazione e quindi aggiungere il controllo solo per tale utente. In questo modo è possibile creare pagine in cui alcuni utenti visualizzerebbero tutti i controlli e altri utenti visualizzerebbero solo i controlli selezionati. Si tratta della logica che controlla il filtro potrebbe essere visualizzata se sono stati usati ruoli:

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;  

Per eseguire l'esempio di codice, è necessario compilare questo codice sorgente. È possibile compilarlo in modo esplicito e inserire l'assembly risultante nella cartella Bin del sito Web o nella global assembly cache. In alternativa, è possibile inserire il codice sorgente nella cartella App_Code del sito, in cui verrà compilato dinamicamente in fase di esecuzione. Questo esempio di codice usa il metodo di compilazione dinamico. Per una procedura dettagliata che illustra come compilare, vedere Procedura dettagliata: Sviluppo e uso di un controllo server Web personalizzato.

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

Dopo aver caricato la pagina in un browser, si noti che il primo controllo viene visualizzato, perché corrisponde ai criteri nel metodo sottoposto a override. Il secondo controllo non viene aggiunto alla pagina, perché il relativo valore di filtro è escluso. Il terzo controllo viene aggiunto, perché non ha il relativo AuthorizationFilter set di proprietà. Se si modifica il valore della proprietà nel secondo controllo in modo che corrisponda a quello del primo controllo e quindi si esegue di nuovo la pagina, viene aggiunto anche il secondo controllo.

Commenti

Il IsAuthorized(Type, String, String, Boolean) metodo di overload esegue i passaggi finali per determinare se un controllo è autorizzato ad essere aggiunto a una pagina. Il metodo garantisce che type sia un tipo valido e che path abbia un valore solo se il controllo controllato è un controllo utente. Chiama quindi il metodo critico OnAuthorizeWebPart , che genera l'evento AuthorizeWebPart .

Note per gli eredi

Questo metodo può essere sottoposto a override ereditando dalla classe, se si vuole fornire una gestione aggiuntiva durante il controllo dell'autorizzazione WebPartManager . È possibile eseguire l'override del metodo per verificare la presenza di determinati valori nel authorizationFilter parametro e in base al valore, restituire un valore booleano che determina se il controllo verrà aggiunto a una pagina.

Per gli sviluppatori di pagine che vogliono controllare anche i filtri di autorizzazione e fornire una gestione personalizzata, è possibile eseguire questa operazione inline in una pagina .aspx o in un file code-behind, senza dover ereditare da alcuna classe. È possibile dichiarare un gestore eventi alternativo nella pagina per il OnAuthorizeWebPart(WebPartAuthorizationEventArgs) metodo del WebPartManager controllo. Per altri dettagli e un esempio, vedere il OnAuthorizeWebPart(WebPartAuthorizationEventArgs) metodo .

Vedi anche

• AuthorizationFilter
• AuthorizeWebPart
• OnAuthorizeWebPart(WebPartAuthorizationEventArgs)
• ASP.NET controlli web part