UnauthorizedWebPart Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Utilizzato per creare un oggetto segnaposto ogni volta che il WebPartManager metodo del IsAuthorized controllo restituisce false per un WebPart controllo. Questa classe non può essere ereditata.
public ref class UnauthorizedWebPart sealed : System::Web::UI::WebControls::WebParts::ProxyWebPartpublic sealed class UnauthorizedWebPart : System.Web.UI.WebControls.WebParts.ProxyWebParttype UnauthorizedWebPart = class
inherit ProxyWebPartPublic NotInheritable Class UnauthorizedWebPart
Inherits ProxyWebPart- Ereditarietà
Esempio
Nell'esempio di codice seguente viene illustrato l'uso del UnauthorizedWebPart controllo .
La prima parte dell'esempio di codice è un controllo personalizzato WebPartManager che esegue l'override del IsAuthorized(WebPart) metodo per creare criteri di autorizzazione personalizzati. Qualsiasi WebPart controllo con la proprietà AuthorizationFilter impostata su un valore specifico o qualsiasi controllo che non ha alcun valore assegnato alla proprietà, verrà autorizzato e i controlli che non soddisfano questi criteri non saranno autorizzati.
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 è la pagina Web che ospita il controllo personalizzato WebPartManager . All'interno dell'elemento <asp:webpartzone> sono dichiarati tre controlli server statici. Anche se questi controlli non sono effettivamente WebPart controlli, verranno racchiusi in un GenericWebPart oggetto in fase di esecuzione, in modo da poterli trattare come WebPart controlli e quindi assegnare valori alle relative AuthorizationFilter proprietà. Si noti che il BulletedList controllo ha il relativo filtro impostato sul valore che deve abilitarlo per l'autorizzazione, in base ai criteri nel controllo personalizzato WebPartManager . Il Label controllo ha un valore di filtro che deve fare in modo che non sia autorizzato. Il Calendar controllo non assegna un valore alla proprietà, pertanto per impostazione predefinita deve essere autorizzato.
<%@ 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 terza parte dell'esempio di codice è un'impostazione che è necessario aggiungere nel file Web.config per consentire l'esportazione di file di descrizione web part. Assicurarsi di disporre di un file Web.config nella stessa directory della pagina Web per questo esempio di codice. All'interno della <system.web> sezione verificare che sia presente un elemento con un <webParts>enableExport attributo impostato su true, come nel markup seguente.
<webParts enableExport="true">
...
</webParts>
Caricare la pagina in un browser e notare che il rendering dei BulletedList controlli e Calendar viene eseguito come previsto, ma il rendering del Label controllo non viene eseguito perché non è autorizzato. Facendo clic sul pulsante Elenca controlli WebPart , il WebPartManager controllo elenca gli ID di tutti i controlli nella raccolta WebParts . Si noti che l'ID per il Label controllo è elencato, dimostrando che un UnauthorizedWebPart controllo è stato aggiunto all'albero dei controlli della pagina per mantenere la posizione, anche se il rendering dell'etichetta non viene eseguito nella pagina.
Commenti
Il set di controlli Web part fornisce un meccanismo di autorizzazione per determinare se è possibile aggiungere singoli WebPart controlli a una pagina. Gli sviluppatori possono facoltativamente assegnare una stringa arbitraria alla AuthorizationFilter proprietà in un WebPart controllo . Quando il WebPartManager controllo aggiunge controlli a una pagina, controlla questo valore del filtro in base ai criteri impostati dallo sviluppatore, utilizzando il IsAuthorized metodo e restituisce false se un controllo non è autorizzato.
Annotazioni
Questo meccanismo funziona anche con i controlli server e i controlli utente posizionati in zone, perché questi controlli vengono inclusi in WebPartZoneBase un GenericWebPart oggetto in fase di esecuzione e questo oggetto eredita la AuthorizationFilter proprietà .
Quando un WebPart controllo non è autorizzato, il WebPartManager controllo inserisce un UnauthorizedWebPart controllo nell'albero dei controlli della pagina al posto del controllo non autorizzato. Un UnauthorizedWebPart controllo nell'albero dei controlli riserva la posizione del controllo non autorizzato nella pagina e impedisce la perdita di dati di personalizzazione che un utente potrebbe aver applicato in precedenza al WebPart controllo.
Il UnauthorizedWebPart controllo non viene mai visualizzato in una pagina in cui viene inserito, né viene visualizzato nel codice sorgente per la pagina sottoposta a rendering. Gli sviluppatori possono verificarne la presenza nell'albero dei controlli pagina controllando la WebParts proprietà del WebPartManager controllo.
Costruttori
| Nome | Descrizione |
|---|---|
| UnauthorizedWebPart(String, String, String, String) |
Inizializza una nuova istanza di un UnauthorizedWebPart controllo, chiamata quando un controllo dinamico WebPart (o un controllo server o utente) non riesce. |
| UnauthorizedWebPart(WebPart) |
Inizializza una nuova istanza di un UnauthorizedWebPart controllo, chiamata quando un controllo statico WebPart (o un controllo server o utente) non riesce. |
Proprietà
| Nome | Descrizione |
|---|---|
| AccessKey |
Ottiene o imposta la chiave di accesso che consente di passare rapidamente al controllo server Web. (Ereditato da WebControl) |
| Adapter |
Ottiene l'adattatore specifico del browser per il controllo . (Ereditato da Control) |
| AllowClose |
Ottiene o imposta un valore che indica se un utente finale può chiudere un WebPart controllo in una pagina Web. (Ereditato da WebPart) |
| AllowConnect |
Ottiene o imposta un valore che indica se il WebPart controllo consente ad altri controlli di formare connessioni. (Ereditato da WebPart) |
| AllowEdit |
Ottiene o imposta un valore che indica se un utente finale può modificare un WebPart controllo tramite l'interfaccia utente fornita da uno o più EditorPart controlli. (Ereditato da WebPart) |
| AllowHide |
Ottiene o imposta un valore che indica se gli utenti finali possono nascondere un WebPart controllo. (Ereditato da WebPart) |
| AllowMinimize |
Ottiene o imposta un valore che indica se gli utenti finali possono ridurre al minimo un WebPart controllo. (Ereditato da WebPart) |
| AllowZoneChange |
Ottiene o imposta un valore che indica se un utente può spostare un WebPart controllo tra WebPartZoneBase le zone. (Ereditato da WebPart) |
| AppRelativeTemplateSourceDirectory |
Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl che contiene questo controllo. (Ereditato da Control) |
| Attributes |
Ottiene la raccolta di attributi arbitrari (solo per il rendering) che non corrispondono alle proprietà del controllo. (Ereditato da WebControl) |
| AuthorizationFilter |
Ottiene o imposta una stringa arbitraria per determinare se un WebPart controllo è autorizzato ad essere aggiunto a una pagina. (Ereditato da WebPart) |
| BackColor |
Ottiene o imposta il colore di sfondo del controllo server Web. (Ereditato da WebControl) |
| BackImageUrl |
Ottiene o imposta l'URL dell'immagine di sfondo per il controllo pannello. (Ereditato da Panel) |
| BindingContainer |
Ottiene il controllo che contiene il data binding di questo controllo. (Ereditato da Control) |
| BorderColor |
Ottiene o imposta il colore del bordo del controllo Web. (Ereditato da WebControl) |
| BorderStyle |
Ottiene o imposta lo stile del bordo del controllo server Web. (Ereditato da WebControl) |
| BorderWidth |
Ottiene o imposta la larghezza del bordo del controllo server Web. (Ereditato da WebControl) |
| CatalogIconImageUrl |
Ottiene o imposta l'URL di un'immagine che rappresenta un controllo Web part in un catalogo di controlli. (Ereditato da WebPart) |
| ChildControlsCreated |
Ottiene un valore che indica se sono stati creati i controlli figlio del controllo server. (Ereditato da Control) |
| ChromeState |
Ottiene o imposta un valore che indica se un controllo parte si trova in uno stato ridotto a icona o normale. (Ereditato da WebPart) |
| ChromeType |
Ottiene o imposta il tipo di bordo che incornicia un controllo Web part. (Ereditato da WebPart) |
| ClientID |
Ottiene l'ID di controllo per il markup HTML generato da ASP.NET. (Ereditato da Control) |
| ClientIDMode |
Ottiene o imposta l'algoritmo utilizzato per generare il valore della ClientID proprietà . (Ereditato da Control) |
| ClientIDSeparator |
Ottiene un valore di carattere che rappresenta il carattere separatore utilizzato nella ClientID proprietà . (Ereditato da Control) |
| ConnectErrorMessage |
Ottiene un messaggio di errore da visualizzare agli utenti se si verificano errori durante il processo di connessione. (Ereditato da WebPart) |
| Context |
Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente. (Ereditato da Control) |
| Controls |
Ottiene un ControlCollection oggetto che contiene i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente. (Ereditato da Part) |
| ControlStyle |
Ottiene lo stile del controllo server Web. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| ControlStyleCreated |
Ottiene un valore che indica se è stato creato un Style oggetto per la ControlStyle proprietà . Questa proprietà viene usata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| CssClass |
Ottiene o imposta la classe CSS (Cascading Style Sheet) sottoposta a rendering dal controllo server Web nel client. (Ereditato da WebControl) |
| DataItemContainer |
Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer. (Ereditato da Control) |
| DataKeysContainer |
Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl. (Ereditato da Control) |
| DefaultButton |
Ottiene o imposta l'identificatore per il pulsante predefinito contenuto nel Panel controllo . (Ereditato da Panel) |
| Description |
Ottiene o imposta una breve frase che riepiloga le operazioni del controllo parte da utilizzare nelle descrizioni comandi e nei cataloghi dei controlli parte. (Ereditato da WebPart) |
| DesignMode |
Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione. (Ereditato da Control) |
| Direction |
Ottiene o imposta la direzione orizzontale che il contenuto scorre all'interno del controllo. (Ereditato da WebPart) |
| DisplayTitle |
Ottiene una stringa contenente il testo completo del titolo effettivamente visualizzato nella barra del titolo di un'istanza WebPart del controllo. (Ereditato da WebPart) |
| Enabled |
Ottiene o imposta un valore che indica se il controllo server Web è abilitato. (Ereditato da WebControl) |
| EnableTheming |
Ottiene o imposta un valore che indica se i temi si applicano a questo controllo. (Ereditato da WebControl) |
| EnableViewState |
Ottiene o imposta un valore che indica se il controllo server mantiene lo stato di visualizzazione e lo stato di visualizzazione di tutti i controlli figlio contenuti, al client richiedente. (Ereditato da Control) |
| Events |
Ottiene un elenco di delegati del gestore eventi per il controllo . Questa proprietà è di sola lettura. (Ereditato da Control) |
| ExportMode |
Ottiene o imposta un valore che indica se è possibile esportare tutte, alcune o nessuna delle proprietà di un WebPart controllo. (Ereditato da WebPart) |
| Font |
Ottiene le proprietà del tipo di carattere associate al controllo server Web. (Ereditato da WebControl) |
| ForeColor |
Ottiene o imposta il colore di primo piano (in genere il colore del testo) del controllo server Web. (Ereditato da WebControl) |
| GenericWebPartID |
Ottiene il valore della ID proprietà dal controllo Web part generico sostituito da un controllo Web part proxy. (Ereditato da ProxyWebPart) |
| GroupingText |
Ottiene o imposta la didascalia per il gruppo di controlli contenuti nel controllo pannello. (Ereditato da Panel) |
| HasAttributes |
Ottiene un valore che indica se il controllo dispone di attributi impostati. (Ereditato da WebControl) |
| HasChildViewState |
Ottiene un valore che indica se i controlli figlio del controllo server corrente hanno impostazioni dello stato di visualizzazione salvate. (Ereditato da Control) |
| HasSharedData |
Ottiene un valore che indica se a un WebPart controllo sono associati dati di personalizzazione condivisi. (Ereditato da WebPart) |
| HasUserData |
Ottiene un valore che indica se a un WebPart controllo sono associati dati di personalizzazione utente. (Ereditato da WebPart) |
| Height |
Ottiene o imposta l'altezza di una zona. (Ereditato da WebPart) |
| HelpMode |
Ottiene o imposta il tipo di interfaccia utente utilizzato per visualizzare il contenuto della Guida per un WebPart controllo. (Ereditato da WebPart) |
| HelpUrl |
Ottiene o imposta l'URL di un file della Guida per un WebPart controllo . (Ereditato da WebPart) |
| Hidden |
Ottiene o imposta un valore che indica se un WebPart controllo viene visualizzato in una pagina Web. (Ereditato da WebPart) |
| HorizontalAlign |
Ottiene o imposta l'allineamento orizzontale del contenuto all'interno del pannello. (Ereditato da Panel) |
| ID |
Ottiene o imposta l'identificatore programmatico assegnato al controllo Web part. (Ereditato da ProxyWebPart) |
| IdSeparator |
Ottiene il carattere utilizzato per separare gli identificatori di controllo. (Ereditato da Control) |
| ImportErrorMessage |
Ottiene o imposta un messaggio di errore utilizzato se si verificano errori quando viene importato un WebPart controllo. (Ereditato da WebPart) |
| IsChildControlStateCleared |
Ottiene un valore che indica se i controlli contenuti all'interno di questo controllo hanno uno stato di controllo. (Ereditato da Control) |
| IsClosed |
Ottiene un valore che indica se un WebPart controllo è attualmente chiuso in una pagina web part. (Ereditato da WebPart) |
| IsEnabled |
Ottiene un valore che indica se il controllo è abilitato. (Ereditato da WebControl) |
| IsShared |
Ottiene un valore che indica se un WebPart controllo è condiviso, ovvero è visibile a tutti gli utenti di una pagina web part. (Ereditato da WebPart) |
| IsStandalone |
Ottiene un valore che indica se un WebPart controllo è autonomo, ovvero che non è contenuto all'interno di una WebPartZoneBase zona. (Ereditato da WebPart) |
| IsStatic |
Ottiene un valore che indica se un WebPart controllo è un controllo statico, ovvero il controllo viene dichiarato nel markup di una pagina web part e non aggiunto alla pagina a livello di codice. (Ereditato da WebPart) |
| IsTrackingViewState |
Ottiene un valore che indica se il controllo server salva le modifiche apportate allo stato di visualizzazione. (Ereditato da Control) |
| IsViewStateEnabled |
Ottiene un valore che indica se lo stato di visualizzazione è abilitato per questo controllo. (Ereditato da Control) |
| LoadViewStateByID |
Ottiene un valore che indica se il controllo partecipa al caricamento dello stato di visualizzazione in ID base al posto dell'indice. (Ereditato da Control) |
| NamingContainer |
Ottiene un riferimento al contenitore di denominazione del controllo server, che crea uno spazio dei nomi univoco per la differenziazione tra i controlli server con lo stesso ID valore della proprietà. (Ereditato da Control) |
| OriginalID |
Ottiene l'oggetto ID del controllo Web part sostituito dal controllo Web part proxy. (Ereditato da ProxyWebPart) |
| OriginalPath |
Ottiene il percorso del controllo utente da sostituire. (Ereditato da ProxyWebPart) |
| OriginalTypeName |
Ottiene l'oggetto Type del controllo Web part sostituito dal controllo Web part proxy. (Ereditato da ProxyWebPart) |
| Page |
Ottiene un riferimento all'istanza Page che contiene il controllo server. (Ereditato da Control) |
| Parent |
Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli pagina. (Ereditato da Control) |
| RenderingCompatibility |
Ottiene un valore che specifica la versione ASP.NET con cui è stato eseguito il rendering del codice HTML sarà compatibile. (Ereditato da Control) |
| ScrollBars |
Ottiene o imposta la visibilità e la posizione delle barre di scorrimento in un Panel controllo . (Ereditato da Panel) |
| Site |
Ottiene informazioni sul contenitore che ospita il controllo corrente durante il rendering in un'area di progettazione. (Ereditato da Control) |
| SkinID |
Ottiene o imposta l'interfaccia da applicare al controllo. (Ereditato da WebControl) |
| Style |
Ottiene una raccolta di attributi di testo di cui verrà eseguito il rendering come attributo di stile sul tag esterno del controllo server Web. (Ereditato da WebControl) |
| Subtitle |
Ottiene una stringa concatenata con il valore della Title proprietà per formare un titolo completo per un WebPart controllo. (Ereditato da WebPart) |
| SupportsDisabledAttribute |
Ottiene un valore che indica se il controllo deve impostare l'attributo dell'elemento |
| TabIndex |
Ottiene o imposta l'indice della scheda del controllo server Web. (Ereditato da WebControl) |
| TagKey |
Ottiene il HtmlTextWriterTag valore che corrisponde a questo controllo server Web. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| TagName |
Ottiene il nome del tag di controllo. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| TemplateControl |
Ottiene o imposta un riferimento al modello che contiene questo controllo. (Ereditato da Control) |
| TemplateSourceDirectory |
Ottiene la directory virtuale dell'oggetto Page o UserControl che contiene il controllo server corrente. (Ereditato da Control) |
| Title |
Ottiene o imposta il titolo di un controllo parte. (Ereditato da WebPart) |
| TitleIconImageUrl |
Ottiene o imposta l'URL di un'immagine utilizzata per rappresentare un controllo Web part nella barra del titolo del controllo. (Ereditato da WebPart) |
| TitleUrl |
Ottiene o imposta un URL per informazioni supplementari su un WebPart controllo . (Ereditato da WebPart) |
| ToolTip |
Ottiene o imposta il testo visualizzato quando il puntatore del mouse passa il mouse sul controllo server Web. (Ereditato da WebControl) |
| UniqueID |
Ottiene l'identificatore univoco e qualificato gerarchicamente per il controllo server. (Ereditato da Control) |
| ValidateRequestMode |
Ottiene o imposta un valore che indica se il controllo controlla l'input client dal browser per individuare valori potenzialmente pericolosi. (Ereditato da Control) |
| Verbs |
Ottiene una raccolta di verbi personalizzati associati a un WebPart controllo . (Ereditato da WebPart) |
| ViewState |
Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un controllo server tra più richieste per la stessa pagina. (Ereditato da Control) |
| ViewStateIgnoresCase |
Ottiene un valore che indica se l'oggetto StateBag non fa distinzione tra maiuscole e minuscole. (Ereditato da Control) |
| ViewStateMode |
Ottiene o imposta la modalità dello stato di visualizzazione di questo controllo. (Ereditato da Control) |
| Visible |
Ottiene o imposta un valore che indica se il rendering di un controllo server viene eseguito come interfaccia utente nella pagina. (Ereditato da Control) |
| WebBrowsableObject |
Ottiene un riferimento al WebPart controllo per consentirne la modifica da parte di controlli personalizzati EditorPart . (Ereditato da WebPart) |
| WebPartManager |
Ottiene un riferimento al controllo associato a un'istanza WebPartManager del WebPart controllo. (Ereditato da WebPart) |
| Width |
Ottiene o imposta la larghezza del controllo server Web. (Ereditato da WebPart) |
| Wrap |
Ottiene o imposta un valore che indica se il contenuto viene disposto all'interno del pannello. (Ereditato da Panel) |
| Zone |
Ottiene la WebPartZoneBase zona che contiene attualmente un WebPart controllo . (Ereditato da WebPart) |
| ZoneIndex |
Ottiene la posizione di indice di un WebPart controllo all'interno della relativa zona. (Ereditato da WebPart) |
Metodi
| Nome | Descrizione |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Aggiunge informazioni sull'immagine di sfondo, l'allineamento, il ritorno a capo e la direzione all'elenco di attributi di cui eseguire il rendering. (Ereditato da Panel) |
| AddedControl(Control, Int32) |
Chiamato dopo l'aggiunta di un controllo figlio all'insieme Controls dell'oggetto Control . (Ereditato da Control) |
| AddParsedSubObject(Object) |
Notifica al controllo server che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'oggetto del ControlCollection controllo server. (Ereditato da Control) |
| ApplyStyle(Style) |
Copia tutti gli elementi non in blocchi dello stile specificato nel controllo Web, sovrascrivendo tutti gli elementi di stile esistenti del controllo. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| ApplyStyleSheetSkin(Page) |
Applica le proprietà di stile definite nel foglio di stile della pagina al controllo . (Ereditato da Control) |
| BeginRenderTracing(TextWriter, Object) |
Inizia la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control) |
| BuildProfileTree(String, Boolean) |
Raccoglie informazioni sul controllo server e le distribuisce alla Trace proprietà da visualizzare quando la traccia è abilitata per la pagina. (Ereditato da Control) |
| ClearCachedClientID() |
Imposta il valore memorizzato nella ClientID cache su |
| ClearChildControlState() |
Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server. (Ereditato da Control) |
| ClearChildState() |
Elimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server. (Ereditato da Control) |
| ClearChildViewState() |
Elimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server. (Ereditato da Control) |
| ClearEffectiveClientIDMode() |
Imposta la ClientIDMode proprietà dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit. (Ereditato da Control) |
| CopyBaseAttributes(WebControl) |
Copia le proprietà non incapsulate dall'oggetto Style dal controllo server Web specificato al controllo server Web da cui viene chiamato questo metodo. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| CreateChildControls() |
Chiamato dal framework di pagina ASP.NET per notificare ai controlli server che usano l'implementazione basata sulla composizione per creare tutti i controlli figlio che contengono in preparazione alla registrazione o al rendering. (Ereditato da Control) |
| CreateControlCollection() |
Crea un nuovo ControlCollection oggetto per contenere i controlli figlio (sia letterali che server) del controllo server. (Ereditato da Control) |
| CreateControlStyle() |
Crea un oggetto di stile utilizzato internamente dal Panel controllo per implementare tutte le proprietà correlate allo stile. (Ereditato da Panel) |
| CreateEditorParts() |
Restituisce un insieme di controlli personalizzati EditorPart che possono essere utilizzati per modificare un WebPart controllo quando è in modalità di modifica. (Ereditato da WebPart) |
| DataBind() |
Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio. (Ereditato da Part) |
| DataBind(Boolean) |
Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio con un'opzione per generare l'evento DataBinding . (Ereditato da Control) |
| DataBindChildren() |
Associa un'origine dati ai controlli figlio del controllo server. (Ereditato da Control) |
| Dispose() |
Consente a un controllo server di eseguire la pulizia finale prima che venga rilasciata dalla memoria. (Ereditato da Control) |
| EndRenderTracing(TextWriter, Object) |
Termina la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control) |
| EnsureChildControls() |
Determina se il controllo server contiene controlli figlio. In caso contrario, crea controlli figlio. (Ereditato da Control) |
| EnsureID() |
Crea un identificatore per i controlli a cui non è assegnato un identificatore. (Ereditato da Control) |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| FindControl(String, Int32) |
Cerca nel contenitore di denominazione corrente un controllo server con l'oggetto specificato |
| FindControl(String) |
Cerca nel contenitore di denominazione corrente un controllo server con il parametro specificato |
| Focus() |
Imposta lo stato attivo dell'input su un controllo . (Ereditato da Control) |
| GetDesignModeState() |
Ottiene i dati in fase di progettazione per un controllo . (Ereditato da Control) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetRouteUrl(Object) |
Ottiene l'URL che corrisponde a un set di parametri di route. (Ereditato da Control) |
| GetRouteUrl(RouteValueDictionary) |
Ottiene l'URL che corrisponde a un set di parametri di route. (Ereditato da Control) |
| GetRouteUrl(String, Object) |
Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route. (Ereditato da Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route. (Ereditato da Control) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| GetUniqueIDRelativeTo(Control) |
Restituisce la parte con prefisso della UniqueID proprietà del controllo specificato. (Ereditato da Control) |
| HasControls() |
Determina se il controllo server contiene controlli figlio. (Ereditato da Control) |
| HasEvents() |
Restituisce un valore che indica se gli eventi vengono registrati per il controllo o per i controlli figlio. (Ereditato da Control) |
| IsLiteralContent() |
Determina se il controllo server contiene solo contenuto letterale. (Ereditato da Control) |
| LoadControlState(Object) |
Esegue l'override LoadControlState(Object) per impedire il caricamento dello stato salvato in precedenza per un ProxyWebPart oggetto . (Ereditato da ProxyWebPart) |
| LoadViewState(Object) |
Esegue l'override LoadViewState(Object) per impedire il caricamento dello stato di visualizzazione salvato in precedenza per un ProxyWebPart oggetto . (Ereditato da ProxyWebPart) |
| MapPathSecure(String) |
Recupera il percorso fisico a cui viene mappato un percorso virtuale, assoluto o relativo. (Ereditato da Control) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| MergeStyle(Style) |
Copia tutti gli elementi non in blocchi dello stile specificato nel controllo Web, ma non sovrascriverà gli elementi di stile esistenti del controllo. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Determina se l'evento per il controllo server viene passato alla gerarchia di controllo server dell'interfaccia utente della pagina. (Ereditato da Control) |
| OnClosing(EventArgs) |
Consente alle classi derivate di fornire una gestione personalizzata quando un WebPart controllo viene chiuso in una pagina web part. (Ereditato da WebPart) |
| OnConnectModeChanged(EventArgs) |
Consente alle classi derivate di fornire una gestione personalizzata quando un WebPart controllo inizia o termina il processo di connessione ad altri controlli. (Ereditato da WebPart) |
| OnDataBinding(EventArgs) |
Genera l'evento DataBinding. (Ereditato da Control) |
| OnDeleting(EventArgs) |
Consente alle classi derivate di fornire una gestione personalizzata quando un WebPart controllo viene rimosso definitivamente da una pagina web part. (Ereditato da WebPart) |
| OnEditModeChanged(EventArgs) |
Consente alle classi derivate di fornire una gestione personalizzata quando un WebPart controllo entra o lascia la modalità di modifica. (Ereditato da WebPart) |
| OnInit(EventArgs) |
Genera l'evento Init. (Ereditato da Control) |
| OnLoad(EventArgs) |
Genera l'evento Load. (Ereditato da Control) |
| OnPreRender(EventArgs) |
Genera l'evento PreRender. (Ereditato da Control) |
| OnUnload(EventArgs) |
Genera l'evento Unload. (Ereditato da Control) |
| OpenFile(String) |
Ottiene un Stream oggetto utilizzato per leggere un file. (Ereditato da Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Assegna tutte le origini dell'evento e le relative informazioni all'elemento padre del controllo. (Ereditato da Control) |
| RemovedControl(Control) |
Chiamato dopo che un controllo figlio viene rimosso dall'insieme Controls dell'oggetto Control . (Ereditato da Control) |
| Render(HtmlTextWriter) |
Esegue il rendering del controllo nel writer HTML specificato. (Ereditato da WebControl) |
| RenderBeginTag(HtmlTextWriter) |
Esegue il rendering del tag di apertura HTML del Panel controllo nel writer specificato. (Ereditato da Panel) |
| RenderChildren(HtmlTextWriter) |
Restituisce il contenuto degli elementi figlio di un controllo server in un oggetto fornito HtmlTextWriter , che scrive il contenuto di cui eseguire il rendering nel client. (Ereditato da Control) |
| RenderContents(HtmlTextWriter) |
Esegue il rendering del contenuto del controllo nel writer specificato. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Restituisce il contenuto del controllo server a un oggetto fornito HtmlTextWriter utilizzando un oggetto fornito ControlAdapter . (Ereditato da Control) |
| RenderControl(HtmlTextWriter) |
Restituisce il contenuto del controllo server in un oggetto fornito HtmlTextWriter e archivia le informazioni di traccia sul controllo se la traccia è abilitata. (Ereditato da Control) |
| RenderEndTag(HtmlTextWriter) |
Esegue il rendering del tag di chiusura HTML del Panel controllo nel writer specificato. (Ereditato da Panel) |
| ResolveAdapter() |
Ottiene l'adattatore di controllo responsabile del rendering del controllo specificato. (Ereditato da Control) |
| ResolveClientUrl(String) |
Ottiene un URL che può essere utilizzato dal browser. (Ereditato da Control) |
| ResolveUrl(String) |
Converte un URL in un URL utilizzabile nel client richiedente. (Ereditato da Control) |
| SaveControlState() |
Salva le modifiche apportate allo stato del controllo server dopo il postback della pagina al server. (Ereditato da ProxyWebPart) |
| SaveViewState() |
Salva qualsiasi stato modificato dopo che il TrackViewState() metodo è stato richiamato. (Ereditato da ProxyWebPart) |
| SetDesignModeState(IDictionary) |
Imposta i dati in fase di progettazione per un controllo . (Ereditato da Control) |
| SetPersonalizationDirty() |
Imposta un flag che indica che i dati di personalizzazione sono stati modificati per l'istanza del controllo corrente WebPart . (Ereditato da WebPart) |
| SetRenderMethodDelegate(RenderMethod) |
Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e del relativo contenuto nel controllo padre. (Ereditato da Control) |
| SetTraceData(Object, Object, Object) |
Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando l'oggetto tracciato, la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control) |
| SetTraceData(Object, Object) |
Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
| TrackViewState() |
Fa in modo che il controllo possa tenere traccia delle modifiche apportate allo stato di visualizzazione in modo che possano essere archiviate nella proprietà dell'oggetto ViewState . (Ereditato da WebPart) |
Eventi
| Nome | Descrizione |
|---|---|
| DataBinding |
Si verifica quando il controllo server viene associato a un'origine dati. (Ereditato da Control) |
| Disposed |
Si verifica quando viene rilasciato un controllo server dalla memoria, ovvero l'ultima fase del ciclo di vita del controllo server quando viene richiesta una pagina ASP.NET. (Ereditato da Control) |
| Init |
Si verifica quando il controllo server viene inizializzato, ovvero il primo passaggio del ciclo di vita. (Ereditato da Control) |
| Load |
Si verifica quando il controllo server viene caricato nell'oggetto Page . (Ereditato da Control) |
| PreRender |
Si verifica dopo il caricamento dell'oggetto Control , ma prima del rendering. (Ereditato da Control) |
| Unload |
Si verifica quando il controllo server viene scaricato dalla memoria. (Ereditato da Control) |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| IAttributeAccessor.GetAttribute(String) |
Ottiene un attributo del controllo Web con il nome specificato. (Ereditato da WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Imposta un attributo del controllo Web sul nome e sul valore specificati. (Ereditato da WebControl) |
| ICompositeControlDesignerAccessor.RecreateChildControls() |
Consente allo sviluppatore di una finestra di progettazione di un controllo di parte composita di ricreare i controlli figlio del controllo nell'area di progettazione. (Ereditato da Part) |
| IControlBuilderAccessor.ControlBuilder |
Per una descrizione di questo membro, vedere ControlBuilder. (Ereditato da Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Per una descrizione di questo membro, vedere GetDesignModeState(). (Ereditato da Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Per una descrizione di questo membro, vedere SetDesignModeState(IDictionary). (Ereditato da Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Per una descrizione di questo membro, vedere SetOwnerControl(Control). (Ereditato da Control) |
| IControlDesignerAccessor.UserData |
Per una descrizione di questo membro, vedere UserData. (Ereditato da Control) |
| IDataBindingsAccessor.DataBindings |
Per una descrizione di questo membro, vedere DataBindings. (Ereditato da Control) |
| IDataBindingsAccessor.HasDataBindings |
Per una descrizione di questo membro, vedere HasDataBindings. (Ereditato da Control) |
| IExpressionsAccessor.Expressions |
Per una descrizione di questo membro, vedere Expressions. (Ereditato da Control) |
| IExpressionsAccessor.HasExpressions |
Per una descrizione di questo membro, vedere HasExpressions. (Ereditato da Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Per una descrizione di questo membro, vedere AddParsedSubObject(Object). (Ereditato da Control) |
Metodi di estensione
| Nome | Descrizione |
|---|---|
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Abilita il comportamento dei dati dinamici per il controllo dati specificato. |
| EnableDynamicData(INamingContainer, Type, Object) |
Abilita il comportamento dei dati dinamici per il controllo dati specificato. |
| EnableDynamicData(INamingContainer, Type) |
Abilita il comportamento dei dati dinamici per il controllo dati specificato. |
| FindDataSourceControl(Control) |
Restituisce l'origine dati associata al controllo dati per il controllo specificato. |
| FindFieldTemplate(Control, String) |
Restituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato. |
| FindMetaTable(Control) |
Restituisce l'oggetto metatable per il controllo dati contenitore. |
| GetDefaultValues(INamingContainer) |
Ottiene la raccolta dei valori predefiniti per il controllo dati specificato. |
| GetMetaTable(INamingContainer) |
Ottiene i metadati della tabella per il controllo dati specificato. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Imposta i metadati della tabella e il mapping dei valori predefiniti per il controllo dati specificato. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Imposta i metadati della tabella e il mapping dei valori predefiniti per il controllo dati specificato. |
| SetMetaTable(INamingContainer, MetaTable) |
Imposta i metadati della tabella per il controllo dati specificato. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Determina se i metadati della tabella sono disponibili. |
