Partage via

UnauthorizedWebPart Classe

Définition

Espace de noms:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Permet de créer un objet d’espace réservé chaque fois que la WebPartManager méthode du IsAuthorized contrôle retourne false un WebPart contrôle. Cette classe ne peut pas être héritée.

public ref class UnauthorizedWebPart sealed : System::Web::UI::WebControls::WebParts::ProxyWebPart
public sealed class UnauthorizedWebPart : System.Web.UI.WebControls.WebParts.ProxyWebPart
type UnauthorizedWebPart = class
    inherit ProxyWebPart
Public NotInheritable Class UnauthorizedWebPart
Inherits ProxyWebPart
Héritage
Object
Control
WebControl
Panel
Part
WebPart
ProxyWebPart
UnauthorizedWebPart

Exemples

L’exemple de code suivant illustre l’utilisation du UnauthorizedWebPart contrôle.

La première partie de l’exemple de code est un contrôle personnalisé WebPartManager qui remplace la IsAuthorized(WebPart) méthode pour créer des critères d’autorisation personnalisés. Tout WebPart contrôle dont la AuthorizationFilter propriété est définie sur une valeur spécifique, ou tout contrôle qui n’a aucune valeur affectée à la propriété, sera autorisé et les contrôles qui ne répondent pas à ces critères ne seront pas autorisés.

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 deuxième partie de l’exemple de code est la page Web qui héberge le contrôle personnalisé WebPartManager . Trois contrôles serveur statiques sont déclarés dans l’élément <asp:webpartzone> . Bien que ces contrôles ne soient pas réellement WebPart des contrôles, ils seront encapsulés avec un GenericWebPart objet au moment de l’exécution. Vous pouvez donc les traiter comme WebPart des contrôles et donc affecter des valeurs à leurs AuthorizationFilter propriétés. Notez que le BulletedList contrôle a son filtre défini sur la valeur qui doit lui permettre d’être autorisé, en fonction des critères du contrôle personnalisé WebPartManager . Le Label contrôle a une valeur de filtre qui doit ne pas être autorisée. Le Calendar contrôle n’affecte pas de valeur à la propriété. Par défaut, il doit être autorisé.

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

<!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;
    }
   
  }

  protected void Button1_Click(object sender, EventArgs e)
  {
    Label2.Text = String.Empty;
    
    foreach (WebPart part in mgr1.WebParts)
      Label2.Text += part.ID + "<br />";
  }
</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:Button ID="Button1" runat="server" 
        Text="List WebPart Controls" OnClick="Button1_Click" />
      <br />
      <asp:Label ID="Label2" runat="server" 
        Text="" />
    </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

  Protected Sub Button1_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    
    Label2.Text = String.Empty
    Dim part As WebPart
    
    For Each part In mgr1.WebParts
      Label2.Text += part.ID & "<br />"
    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:Button ID="Button1" runat="server" 
        Text="List WebPart Controls" OnClick="Button1_Click" />
      <br />
      <asp:Label ID="Label2" runat="server" 
        Text="" />
    </div>
    </form>
</body>
</html>

La troisième partie de l’exemple de code est un paramètre que vous devez ajouter dans le fichier Web.config pour permettre l’exportation de fichiers de description de composants WebPart. Vérifiez que vous disposez d’un fichier Web.config dans le même répertoire que la page Web pour cet exemple de code. Dans la <system.web> section, vérifiez qu’il existe un élément avec un <webParts>enableExport attribut défini truesur , comme dans le balisage suivant.

<webParts enableExport="true">

...

</webParts>

Chargez la page dans un navigateur et notez que les contrôles et Calendar les BulletedList contrôles sont rendus comme prévu, mais que le Label contrôle n’est pas rendu, car il n’a pas été autorisé. En cliquant sur le bouton Répertorier les contrôles WebPart , le WebPartManager contrôle répertorie les ID de tous les contrôles de sa WebParts collection. Notez que l’ID du Label contrôle est répertorié, ce qui prouve qu’un UnauthorizedWebPart contrôle a été ajouté à l’arborescence de contrôle de page pour conserver sa place, même si l’étiquette n’est pas affichée dans la page.

Remarques

Le jeu de contrôles WebPart fournit un mécanisme d’autorisation pour déterminer si des contrôles individuels WebPart peuvent être ajoutés à une page. Les développeurs peuvent éventuellement affecter une chaîne arbitraire à la AuthorizationFilter propriété sur un WebPart contrôle. Lorsque le WebPartManager contrôle ajoute des contrôles à une page, il vérifie cette valeur de filtre par rapport aux critères définis par le développeur, à l’aide de la IsAuthorized méthode et retourne false si un contrôle n’est pas autorisé.

Note

Ce mécanisme fonctionne également avec les contrôles serveur et les contrôles utilisateur placés dans WebPartZoneBase des zones, car ces contrôles sont encapsulés avec un GenericWebPart objet au moment de l’exécution, et cet objet hérite de la AuthorizationFilter propriété.

Lorsqu’un WebPart contrôle n’est pas autorisé, le WebPartManager contrôle insère un UnauthorizedWebPart contrôle dans l’arborescence de contrôle de la page à la place du contrôle non autorisé. Un UnauthorizedWebPart contrôle dans l’arborescence de contrôle réserve la position du contrôle non autorisé dans la page et empêche toute donnée de personnalisation qu’un utilisateur a pu appliquer précédemment au WebPart contrôle d’être perdu.

Le UnauthorizedWebPart contrôle n’est jamais affiché sur une page dans laquelle il est inséré, ni dans le code source de la page rendue. Les développeurs peuvent vérifier sa présence dans l’arborescence des contrôles de page en vérifiant la WebParts propriété du WebPartManager contrôle.

Constructeurs

Nom Description
UnauthorizedWebPart(String, String, String, String)

Initialise une nouvelle instance d’un UnauthorizedWebPart contrôle, appelée lorsqu’un contrôle dynamique WebPart (ou serveur ou contrôle utilisateur) échoue.
UnauthorizedWebPart(WebPart)

Initialise une nouvelle instance d’un UnauthorizedWebPart contrôle, appelée lorsqu’un contrôle statique WebPart (ou serveur ou contrôle utilisateur) échoue.

Propriétés

Nom Description
AccessKey

Obtient ou définit la clé d’accès qui vous permet d’accéder rapidement au contrôle serveur Web.

(Hérité de WebControl)
Adapter

Obtient l’adaptateur spécifique au navigateur pour le contrôle.

(Hérité de Control)
AllowClose

Obtient ou définit une valeur indiquant si un utilisateur final peut fermer un WebPart contrôle sur une page Web.

(Hérité de WebPart)
AllowConnect

Obtient ou définit une valeur qui indique si le WebPart contrôle autorise d’autres contrôles à former des connexions avec celui-ci.

(Hérité de WebPart)
AllowEdit

Obtient ou définit une valeur indiquant si un utilisateur final peut modifier un WebPart contrôle via l’interface utilisateur fournie par un ou plusieurs EditorPart contrôles.

(Hérité de WebPart)
AllowHide

Obtient ou définit une valeur indiquant si les utilisateurs finaux sont autorisés à masquer un WebPart contrôle.

(Hérité de WebPart)
AllowMinimize

Obtient ou définit une valeur indiquant si les utilisateurs finaux peuvent réduire un WebPart contrôle.

(Hérité de WebPart)
AllowZoneChange

Obtient ou définit une valeur indiquant si un utilisateur peut déplacer un WebPart contrôle entre WebPartZoneBase des zones.

(Hérité de WebPart)
AppRelativeTemplateSourceDirectory

Obtient ou définit le répertoire virtuel relatif à l’application du ou UserControl de l’objet Page qui contient ce contrôle.

(Hérité de Control)
Attributes

Obtient la collection d’attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas aux propriétés du contrôle.

(Hérité de WebControl)
AuthorizationFilter

Obtient ou définit une chaîne arbitraire pour déterminer si un WebPart contrôle est autorisé à être ajouté à une page.

(Hérité de WebPart)
BackColor

Obtient ou définit la couleur d’arrière-plan du contrôle serveur Web.

(Hérité de WebControl)
BackImageUrl

Obtient ou définit l’URL de l’image d’arrière-plan pour le contrôle du panneau.

(Hérité de Panel)
BindingContainer

Obtient le contrôle qui contient la liaison de données de ce contrôle.

(Hérité de Control)
BorderColor

Obtient ou définit la couleur de bordure du contrôle Web.

(Hérité de WebControl)
BorderStyle

Obtient ou définit le style de bordure du contrôle serveur Web.

(Hérité de WebControl)
BorderWidth

Obtient ou définit la largeur de bordure du contrôle serveur Web.

(Hérité de WebControl)
CatalogIconImageUrl

Obtient ou définit l’URL d’une image qui représente un contrôle WebPart dans un catalogue de contrôles.

(Hérité de WebPart)
ChildControlsCreated

Obtient une valeur qui indique si les contrôles enfants du contrôle serveur ont été créés.

(Hérité de Control)
ChromeState

Obtient ou définit si un contrôle de composant est dans un état réduit ou normal.

(Hérité de WebPart)
ChromeType

Obtient ou définit le type de bordure qui trame un contrôle WebPart.

(Hérité de WebPart)
ClientID

Obtient l’ID de contrôle pour le balisage HTML généré par ASP.NET.

(Hérité de Control)
ClientIDMode

Obtient ou définit l’algorithme utilisé pour générer la valeur de la ClientID propriété.

(Hérité de Control)
ClientIDSeparator

Obtient une valeur de caractère représentant le caractère séparateur utilisé dans la ClientID propriété.

(Hérité de Control)
ConnectErrorMessage

Obtient un message d’erreur à afficher aux utilisateurs si des erreurs se produisent pendant le processus de connexion.

(Hérité de WebPart)
Context

Obtient l’objet HttpContext associé au contrôle serveur pour la requête Web actuelle.

(Hérité de Control)
Controls

Obtient un ControlCollection objet qui contient les contrôles enfants d’un contrôle serveur spécifié dans la hiérarchie de l’interface utilisateur.

(Hérité de Part)
ControlStyle

Obtient le style du contrôle serveur Web. Cette propriété est principalement utilisée par les développeurs de contrôles.

(Hérité de WebControl)
ControlStyleCreated

Obtient une valeur indiquant si un Style objet a été créé pour la ControlStyle propriété. Cette propriété est principalement utilisée par les développeurs de contrôles.

(Hérité de WebControl)
CssClass

Obtient ou définit la classe Feuille de style en cascade (CSS) rendue par le contrôle serveur Web sur le client.

(Hérité de WebControl)
DataItemContainer

Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataItemContainernoms implémente .

(Hérité de Control)
DataKeysContainer

Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataKeysControlnoms implémente .

(Hérité de Control)
DefaultButton

Obtient ou définit l’identificateur du bouton par défaut contenu dans le Panel contrôle.

(Hérité de Panel)
Description

Obtient ou définit une brève expression qui résume ce que fait le contrôle de composant, à utiliser dans les info-bulles et les catalogues de contrôles de composants.

(Hérité de WebPart)
DesignMode

Obtient une valeur indiquant si un contrôle est utilisé sur une surface de conception.

(Hérité de Control)
Direction

Obtient ou définit la direction horizontale que le contenu circule dans le contrôle.

(Hérité de WebPart)
DisplayTitle

Obtient une chaîne qui contient le texte de titre intégral réellement affiché dans la barre de titre d’une WebPart instance de contrôle.

(Hérité de WebPart)
Enabled

Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé.

(Hérité de WebControl)
EnableTheming

Obtient ou définit une valeur indiquant si les thèmes s’appliquent à ce contrôle.

(Hérité de WebControl)
EnableViewState

Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage et l’état d’affichage des contrôles enfants qu’il contient, au client demandeur.

(Hérité de Control)
Events

Obtient une liste de délégués de gestionnaire d’événements pour le contrôle. Cette propriété est en lecture seule.

(Hérité de Control)
ExportMode

Obtient ou définit si toutes, certaines ou aucune des propriétés d’un WebPart contrôle ne peuvent être exportées.

(Hérité de WebPart)
Font

Obtient les propriétés de police associées au contrôle serveur Web.

(Hérité de WebControl)
ForeColor

Obtient ou définit la couleur de premier plan (généralement la couleur du texte) du contrôle serveur Web.

(Hérité de WebControl)
GenericWebPartID

Obtient la valeur de la ID propriété à partir du contrôle de composants WebPart générique remplacé par un contrôle de composants WebPart proxy.

(Hérité de ProxyWebPart)
GroupingText

Obtient ou définit la légende du groupe de contrôles contenus dans le contrôle du panneau.

(Hérité de Panel)
HasAttributes

Obtient une valeur indiquant si le contrôle a des attributs définis.

(Hérité de WebControl)
HasChildViewState

Obtient une valeur indiquant si les contrôles enfants du contrôle serveur actuel ont des paramètres d’état d’affichage enregistrés.

(Hérité de Control)
HasSharedData

Obtient une valeur qui indique si un WebPart contrôle a des données de personnalisation partagées associées.

(Hérité de WebPart)
HasUserData

Obtient une valeur qui indique si un WebPart contrôle a des données de personnalisation utilisateur associées.

(Hérité de WebPart)
Height

Obtient ou définit la hauteur d’une zone.

(Hérité de WebPart)
HelpMode

Obtient ou définit le type d’interface utilisateur utilisé pour afficher le contenu d’aide d’un WebPart contrôle.

(Hérité de WebPart)
HelpUrl

Obtient ou définit l’URL vers un fichier d’aide pour un WebPart contrôle.

(Hérité de WebPart)
Hidden

Obtient ou définit une valeur indiquant si un WebPart contrôle est affiché sur une page Web.

(Hérité de WebPart)
HorizontalAlign

Obtient ou définit l’alignement horizontal du contenu dans le panneau.

(Hérité de Panel)
ID

Obtient ou définit l’identificateur programmatique affecté au contrôle WebPart.

(Hérité de ProxyWebPart)
IdSeparator

Obtient le caractère utilisé pour séparer les identificateurs de contrôle.

(Hérité de Control)
ImportErrorMessage

Obtient ou définit un message d’erreur utilisé si des erreurs se produisent lorsqu’un WebPart contrôle est importé.

(Hérité de WebPart)
IsChildControlStateCleared

Obtient une valeur indiquant si les contrôles contenus dans ce contrôle ont un état de contrôle.

(Hérité de Control)
IsClosed

Obtient une valeur qui indique si un WebPart contrôle est actuellement fermé sur une page de composants WebPart.

(Hérité de WebPart)
IsEnabled

Obtient une valeur indiquant si le contrôle est activé.

(Hérité de WebControl)
IsShared

Obtient une valeur qui indique si un WebPart contrôle est partagé, ce qui signifie qu’il est visible pour tous les utilisateurs d’une page de composants WebPart.

(Hérité de WebPart)
IsStandalone

Obtient une valeur qui indique si un WebPart contrôle est autonome, ce qui signifie qu’il n’est pas contenu dans une WebPartZoneBase zone.

(Hérité de WebPart)
IsStatic

Obtient une valeur qui indique si un WebPart contrôle est un contrôle statique, ce qui signifie que le contrôle est déclaré dans le balisage d’une page de composants WebPart et non ajouté à la page par programmation.

(Hérité de WebPart)
IsTrackingViewState

Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d’affichage.

(Hérité de Control)
IsViewStateEnabled

Obtient une valeur indiquant si l’état d’affichage est activé pour ce contrôle.

(Hérité de Control)
LoadViewStateByID

Obtient une valeur indiquant si le contrôle participe au chargement de son état d’affichage ID au lieu de l’index.

(Hérité de Control)
NamingContainer

Obtient une référence au conteneur d’affectation de noms du contrôle serveur, qui crée un espace de noms unique pour la différenciation entre les contrôles serveur avec la même ID valeur de propriété.

(Hérité de Control)
OriginalID

Obtient le ID contrôle des composants WebPart remplacé par le contrôle de composants WebPart proxy.

(Hérité de ProxyWebPart)
OriginalPath

Obtient le chemin d’accès au contrôle utilisateur en cours de remplacement.

(Hérité de ProxyWebPart)
OriginalTypeName

Obtient le Type contrôle des composants WebPart remplacé par le contrôle de composants WebPart proxy.

(Hérité de ProxyWebPart)
Page

Obtient une référence à l’instance Page qui contient le contrôle serveur.

(Hérité de Control)
Parent

Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de page.

(Hérité de Control)
RenderingCompatibility

Obtient une valeur qui spécifie la version ASP.NET avec laquelle le code HTML rendu est compatible.

(Hérité de Control)
ScrollBars

Obtient ou définit la visibilité et la position des barres de défilement dans un Panel contrôle.

(Hérité de Panel)
Site

Obtient des informations sur le conteneur qui héberge le contrôle actuel lors du rendu sur une surface de conception.

(Hérité de Control)
SkinID

Obtient ou définit la peau à appliquer au contrôle.

(Hérité de WebControl)
Style

Obtient une collection d’attributs de texte qui seront rendus en tant qu’attribut de style sur la balise externe du contrôle serveur Web.

(Hérité de WebControl)
Subtitle

Obtient une chaîne concaténée avec la valeur de propriété Title pour former un titre complet pour un WebPart contrôle.

(Hérité de WebPart)
SupportsDisabledAttribute

Obtient une valeur qui indique si le contrôle doit définir l’attribut disabled de l’élément HTML rendu sur « disabled » lorsque la propriété du IsEnabled contrôle est false.

(Hérité de Panel)
TabIndex

Obtient ou définit l’index de tabulation du contrôle serveur Web.

(Hérité de WebControl)
TagKey

Obtient la HtmlTextWriterTag valeur qui correspond à ce contrôle de serveur Web. Cette propriété est principalement utilisée par les développeurs de contrôles.

(Hérité de WebControl)
TagName

Obtient le nom de la balise de contrôle. Cette propriété est principalement utilisée par les développeurs de contrôles.

(Hérité de WebControl)
TemplateControl

Obtient ou définit une référence au modèle qui contient ce contrôle.

(Hérité de Control)
TemplateSourceDirectory

Obtient le répertoire virtuel du PageUserControl ou qui contient le contrôle serveur actuel.

(Hérité de Control)
Title

Obtient ou définit le titre d’un contrôle de composant.

(Hérité de WebPart)
TitleIconImageUrl

Obtient ou définit l’URL d’une image utilisée pour représenter un contrôle WebPart dans la barre de titre du contrôle.

(Hérité de WebPart)
TitleUrl

Obtient ou définit une URL pour obtenir des informations supplémentaires sur un WebPart contrôle.

(Hérité de WebPart)
ToolTip

Obtient ou définit le texte affiché lorsque le pointeur de la souris pointe sur le contrôle serveur Web.

(Hérité de WebControl)
UniqueID

Obtient l’identificateur unique qualifié hiérarchiquement pour le contrôle serveur.

(Hérité de Control)
ValidateRequestMode

Obtient ou définit une valeur qui indique si le contrôle vérifie l’entrée du client à partir du navigateur pour obtenir des valeurs potentiellement dangereuses.

(Hérité de Control)
Verbs

Obtient une collection de verbes personnalisés associés à un WebPart contrôle.

(Hérité de WebPart)
ViewState

Obtient un dictionnaire d’informations d’état qui vous permet d’enregistrer et de restaurer l’état d’affichage d’un contrôle serveur sur plusieurs requêtes pour la même page.

(Hérité de Control)
ViewStateIgnoresCase

Obtient une valeur qui indique si l’objet ne respecte pas la StateBag casse.

(Hérité de Control)
ViewStateMode

Obtient ou définit le mode d’état d’affichage de ce contrôle.

(Hérité de Control)
Visible

Obtient ou définit une valeur qui indique si un contrôle serveur est rendu en tant qu’interface utilisateur sur la page.

(Hérité de Control)
WebBrowsableObject

Obtient une référence au WebPart contrôle pour lui permettre d’être modifié par des contrôles personnalisés EditorPart .

(Hérité de WebPart)
WebPartManager

Obtient une référence au WebPartManager contrôle associé à une WebPart instance de contrôle.

(Hérité de WebPart)
Width

Obtient ou définit la largeur du contrôle serveur Web.

(Hérité de WebPart)
Wrap

Obtient ou définit une valeur indiquant si le contenu est encapsulé dans le panneau.

(Hérité de Panel)
Zone

Obtient la WebPartZoneBase zone qui contient actuellement un WebPart contrôle.

(Hérité de WebPart)
ZoneIndex

Obtient la position d’index d’un WebPart contrôle dans sa zone.

(Hérité de WebPart)

Méthodes

Nom Description
AddAttributesToRender(HtmlTextWriter)

Ajoute des informations sur l’image d’arrière-plan, l’alignement, l’habillage et la direction à la liste des attributs à afficher.

(Hérité de Panel)
AddedControl(Control, Int32)

Appelé après l’ajout d’un contrôle enfant à la Controls collection de l’objet Control .

(Hérité de Control)
AddParsedSubObject(Object)

Avertit le contrôle serveur qu’un élément, XML ou HTML, a été analysé et ajoute l’élément à l’objet du ControlCollection contrôle serveur.

(Hérité de Control)
ApplyStyle(Style)

Copie tous les éléments non vides du style spécifié dans le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par les développeurs de contrôles.

(Hérité de WebControl)
ApplyStyleSheetSkin(Page)

Applique les propriétés de style définies dans la feuille de style de page au contrôle.

(Hérité de Control)
BeginRenderTracing(TextWriter, Object)

Commence le suivi au moment du design des données de rendu.

(Hérité de Control)
BuildProfileTree(String, Boolean)

Collecte des informations sur le contrôle serveur et le remet à la Trace propriété à afficher lorsque le suivi est activé pour la page.

(Hérité de Control)
ClearCachedClientID()

Définit la valeur mise en ClientID cache sur null.

(Hérité de Control)
ClearChildControlState()

Supprime les informations d’état du contrôle pour les contrôles enfants du contrôle serveur.

(Hérité de Control)
ClearChildState()

Supprime les informations d’état d’affichage et d’état de contrôle pour tous les contrôles enfants du contrôle serveur.

(Hérité de Control)
ClearChildViewState()

Supprime les informations d’état d’affichage de tous les contrôles enfants du contrôle serveur.

(Hérité de Control)
ClearEffectiveClientIDMode()

Définit la ClientIDMode propriété de l’instance de contrôle actuelle et de tous les contrôles enfants sur Inherit.

(Hérité de Control)
CopyBaseAttributes(WebControl)

Copie les propriétés non encapsulées par l’objet Style du contrôle serveur Web spécifié vers le contrôle serveur Web à partir duquel cette méthode est appelée. Cette méthode est principalement utilisée par les développeurs de contrôles.

(Hérité de WebControl)
CreateChildControls()

Appelé par l’infrastructure de page ASP.NET pour notifier les contrôles serveur qui utilisent l’implémentation basée sur la composition pour créer les contrôles enfants qu’ils contiennent en préparation de la publication ou du rendu.

(Hérité de Control)
CreateControlCollection()

Crée un ControlCollection objet pour contenir les contrôles enfants (littéral et serveur) du contrôle serveur.

(Hérité de Control)
CreateControlStyle()

Crée un objet de style utilisé en interne par le Panel contrôle pour implémenter toutes les propriétés associées au style.

(Hérité de Panel)
CreateEditorParts()

Retourne une collection de contrôles personnalisés EditorPart qui peuvent être utilisés pour modifier un WebPart contrôle lorsqu’il est en mode édition.

(Hérité de WebPart)
DataBind()

Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants.

(Hérité de Part)
DataBind(Boolean)

Lie une source de données au contrôle serveur appelé et à tous ses contrôles enfants avec une option pour déclencher l’événement DataBinding .

(Hérité de Control)
DataBindChildren()

Lie une source de données aux contrôles enfants du contrôle serveur.

(Hérité de Control)
Dispose()

Permet à un contrôle de serveur d’effectuer le nettoyage final avant de libérer de la mémoire.

(Hérité de Control)
EndRenderTracing(TextWriter, Object)

Met fin au suivi au moment du design des données de rendu.

(Hérité de Control)
EnsureChildControls()

Détermine si le contrôle serveur contient des contrôles enfants. Si ce n’est pas le cas, il crée des contrôles enfants.

(Hérité de Control)
EnsureID()

Crée un identificateur pour les contrôles qui n’ont pas d’identificateur affecté.

(Hérité de Control)
Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
FindControl(String, Int32)

Recherche dans le conteneur d’affectation de noms actuel un contrôle serveur avec l’entier spécifié id et spécifié dans le pathOffset paramètre, ce qui facilite la recherche. Vous ne devez pas remplacer cette version de la FindControl méthode.

(Hérité de Control)
FindControl(String)

Recherche le conteneur d’affectation de noms actuel pour un contrôle serveur avec le paramètre spécifié id .

(Hérité de Control)
Focus()

Définit le focus d’entrée sur un contrôle.

(Hérité de Control)
GetDesignModeState()

Obtient les données au moment du design pour un contrôle.

(Hérité de Control)
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetRouteUrl(Object)

Obtient l’URL qui correspond à un ensemble de paramètres de routage.

(Hérité de Control)
GetRouteUrl(RouteValueDictionary)

Obtient l’URL qui correspond à un ensemble de paramètres de routage.

(Hérité de Control)
GetRouteUrl(String, Object)

Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et à un nom d’itinéraire.

(Hérité de Control)
GetRouteUrl(String, RouteValueDictionary)

Obtient l’URL qui correspond à un ensemble de paramètres d’itinéraire et à un nom d’itinéraire.

(Hérité de Control)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
GetUniqueIDRelativeTo(Control)

Retourne la partie préfixée de la UniqueID propriété du contrôle spécifié.

(Hérité de Control)
HasControls()

Détermine si le contrôle serveur contient des contrôles enfants.

(Hérité de Control)
HasEvents()

Retourne une valeur indiquant si les événements sont inscrits pour le contrôle ou les contrôles enfants.

(Hérité de Control)
IsLiteralContent()

Détermine si le contrôle serveur contient uniquement du contenu littéral.

(Hérité de Control)
LoadControlState(Object)

Remplace pour LoadControlState(Object) empêcher le chargement de l’état précédemment enregistré pour un ProxyWebPart objet.

(Hérité de ProxyWebPart)
LoadViewState(Object)

Substitue LoadViewState(Object) pour empêcher le chargement de l’état d’affichage précédemment enregistré pour un ProxyWebPart objet.

(Hérité de ProxyWebPart)
MapPathSecure(String)

Récupère le chemin d’accès physique auquel un chemin virtuel, absolu ou relatif, est mappé.

(Hérité de Control)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
MergeStyle(Style)

Copie tous les éléments non vides du style spécifié dans le contrôle Web, mais n’écrasera aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par les développeurs de contrôles.

(Hérité de WebControl)
OnBubbleEvent(Object, EventArgs)

Détermine si l’événement pour le contrôle serveur est transmis à la hiérarchie de contrôle du serveur d’interface utilisateur de la page.

(Hérité de Control)
OnClosing(EventArgs)

Permet aux classes dérivées de fournir une gestion personnalisée lorsqu’un WebPart contrôle est fermé sur une page de composants WebPart.

(Hérité de WebPart)
OnConnectModeChanged(EventArgs)

Permet aux classes dérivées de fournir une gestion personnalisée lorsqu’un WebPart contrôle commence ou termine le processus de connexion à d’autres contrôles.

(Hérité de WebPart)
OnDataBinding(EventArgs)

Déclenche l’événement DataBinding.

(Hérité de Control)
OnDeleting(EventArgs)

Permet aux classes dérivées de fournir une gestion personnalisée lorsqu’un WebPart contrôle est définitivement supprimé d’une page de composants WebPart.

(Hérité de WebPart)
OnEditModeChanged(EventArgs)

Permet aux classes dérivées de fournir une gestion personnalisée lorsqu’un WebPart contrôle entre ou quitte le mode d’édition.

(Hérité de WebPart)
OnInit(EventArgs)

Déclenche l’événement Init.

(Hérité de Control)
OnLoad(EventArgs)

Déclenche l’événement Load.

(Hérité de Control)
OnPreRender(EventArgs)

Déclenche l’événement PreRender.

(Hérité de Control)
OnUnload(EventArgs)

Déclenche l’événement Unload.

(Hérité de Control)
OpenFile(String)

Obtient un Stream élément utilisé pour lire un fichier.

(Hérité de Control)
RaiseBubbleEvent(Object, EventArgs)

Affecte toutes les sources de l’événement et ses informations au parent du contrôle.

(Hérité de Control)
RemovedControl(Control)

Appelé après la suppression d’un contrôle enfant de la Controls collection de l’objet Control .

(Hérité de Control)
Render(HtmlTextWriter)

Restitue le contrôle au writer HTML spécifié.

(Hérité de WebControl)
RenderBeginTag(HtmlTextWriter)

Restitue la balise d’ouverture HTML du Panel contrôle au writer spécifié.

(Hérité de Panel)
RenderChildren(HtmlTextWriter)

Génère le contenu des enfants d’un contrôle serveur dans un objet fourni HtmlTextWriter , qui écrit le contenu à restituer sur le client.

(Hérité de Control)
RenderContents(HtmlTextWriter)

Restitue le contenu du contrôle au writer spécifié. Cette méthode est principalement utilisée par les développeurs de contrôles.

(Hérité de WebControl)
RenderControl(HtmlTextWriter, ControlAdapter)

Génère le contenu du contrôle serveur sur un objet fourni HtmlTextWriter à l’aide d’un objet fourni ControlAdapter .

(Hérité de Control)
RenderControl(HtmlTextWriter)

Génère le contenu du contrôle serveur dans un objet fourni HtmlTextWriter et stocke les informations de suivi sur le contrôle si le suivi est activé.

(Hérité de Control)
RenderEndTag(HtmlTextWriter)

Affiche la balise de fermeture HTML du Panel contrôle dans l’enregistreur spécifié.

(Hérité de Panel)
ResolveAdapter()

Obtient l’adaptateur de contrôle responsable du rendu du contrôle spécifié.

(Hérité de Control)
ResolveClientUrl(String)

Obtient une URL qui peut être utilisée par le navigateur.

(Hérité de Control)
ResolveUrl(String)

Convertit une URL en une URL utilisable sur le client demandeur.

(Hérité de Control)
SaveControlState()

Enregistre les modifications d’état de contrôle du serveur qui se sont produites depuis la publication de la page sur le serveur.

(Hérité de ProxyWebPart)
SaveViewState()

Enregistre tout état modifié après l’appel de la TrackViewState() méthode.

(Hérité de ProxyWebPart)
SetDesignModeState(IDictionary)

Définit les données au moment du design pour un contrôle.

(Hérité de Control)
SetPersonalizationDirty()

Définit un indicateur indiquant que les données de personnalisation ont changé pour l’instance de contrôle actuelle WebPart .

(Hérité de WebPart)
SetRenderMethodDelegate(RenderMethod)

Affecte un délégué de gestionnaire d’événements pour restituer le contrôle serveur et son contenu dans son contrôle parent.

(Hérité de Control)
SetTraceData(Object, Object, Object)

Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de l’objet suivi, de la clé de données de trace et de la valeur des données de trace.

(Hérité de Control)
SetTraceData(Object, Object)

Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de la clé de données de trace et de la valeur des données de trace.

(Hérité de Control)
ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)
TrackViewState()

Provoque le suivi des modifications apportées à son état d’affichage afin qu’ils puissent être stockés dans la propriété de l’objet ViewState .

(Hérité de WebPart)

Événements

Nom Description
DataBinding

Se produit lorsque le contrôle serveur se lie à une source de données.

(Hérité de Control)
Disposed

Se produit lorsqu’un contrôle serveur est libéré de la mémoire, qui est la dernière étape du cycle de vie du contrôle de serveur lorsqu’une page ASP.NET est demandée.

(Hérité de Control)
Init

Se produit lorsque le contrôle serveur est initialisé, qui est la première étape de son cycle de vie.

(Hérité de Control)
Load

Se produit lorsque le contrôle serveur est chargé dans l’objet Page .

(Hérité de Control)
PreRender

Se produit après le chargement de l’objet Control , mais avant le rendu.

(Hérité de Control)
Unload

Se produit lorsque le contrôle serveur est déchargé de la mémoire.

(Hérité de Control)

Implémentations d’interfaces explicites

Nom Description
IAttributeAccessor.GetAttribute(String)

Obtient un attribut du contrôle Web avec le nom spécifié.

(Hérité de WebControl)
IAttributeAccessor.SetAttribute(String, String)

Définit un attribut du contrôle Web sur le nom et la valeur spécifiés.

(Hérité de WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()

Permet au développeur d’un concepteur d’un contrôle de composant composite de recréer les contrôles enfants du contrôle sur l’aire de conception.

(Hérité de Part)
IControlBuilderAccessor.ControlBuilder

Pour obtenir une description de ce membre, consultez ControlBuilder.

(Hérité de Control)
IControlDesignerAccessor.GetDesignModeState()

Pour obtenir une description de ce membre, consultez GetDesignModeState().

(Hérité de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary).

(Hérité de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Pour obtenir une description de ce membre, consultez SetOwnerControl(Control).

(Hérité de Control)
IControlDesignerAccessor.UserData

Pour obtenir une description de ce membre, consultez UserData.

(Hérité de Control)
IDataBindingsAccessor.DataBindings

Pour obtenir une description de ce membre, consultez DataBindings.

(Hérité de Control)
IDataBindingsAccessor.HasDataBindings

Pour obtenir une description de ce membre, consultez HasDataBindings.

(Hérité de Control)
IExpressionsAccessor.Expressions

Pour obtenir une description de ce membre, consultez Expressions.

(Hérité de Control)
IExpressionsAccessor.HasExpressions

Pour obtenir une description de ce membre, consultez HasExpressions.

(Hérité de Control)
IParserAccessor.AddParsedSubObject(Object)

Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object).

(Hérité de Control)

Méthodes d’extension

Nom Description
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Active le comportement des données dynamiques pour le contrôle de données spécifié.
EnableDynamicData(INamingContainer, Type, Object)

Active le comportement des données dynamiques pour le contrôle de données spécifié.
EnableDynamicData(INamingContainer, Type)

Active le comportement des données dynamiques pour le contrôle de données spécifié.
FindDataSourceControl(Control)

Retourne la source de données associée au contrôle de données pour le contrôle spécifié.
FindFieldTemplate(Control, String)

Retourne le modèle de champ de la colonne spécifiée dans le conteneur d’affectation de noms du contrôle spécifié.
FindMetaTable(Control)

Retourne l’objet métatable pour le contrôle de données contenant.
GetDefaultValues(INamingContainer)

Obtient la collection des valeurs par défaut pour le contrôle de données spécifié.
GetMetaTable(INamingContainer)

Obtient les métadonnées de table pour le contrôle de données spécifié.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Définit les métadonnées de table et le mappage de valeurs par défaut pour le contrôle de données spécifié.
SetMetaTable(INamingContainer, MetaTable, Object)

Définit les métadonnées de table et le mappage de valeurs par défaut pour le contrôle de données spécifié.
SetMetaTable(INamingContainer, MetaTable)

Définit les métadonnées de table pour le contrôle de données spécifié.
TryGetMetaTable(INamingContainer, MetaTable)

Détermine si les métadonnées de table sont disponibles.

S’applique à

Voir aussi