UnauthorizedWebPart Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Används för att skapa ett platshållarobjekt när WebPartManager kontrollens IsAuthorized metod returnerar false för en WebPart kontroll. Det går inte att ärva den här klassen.
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
- Arv
Exempel
I följande kodexempel visas hur kontrollen används UnauthorizedWebPart .
Den första delen av kodexemplet är en anpassad WebPartManager kontroll som åsidosätter IsAuthorized(WebPart) metoden för att skapa anpassade auktoriseringsvillkor. Alla WebPart kontroller som har dess AuthorizationFilter egenskap inställd på ett visst värde, eller någon kontroll som inte har något värde tilldelat till egenskapen, kommer att auktoriseras och kontroller som inte uppfyller dessa kriterier kommer inte att auktoriseras.
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
Den andra delen av kodexemplet är webbsidan som är värd för den anpassade WebPartManager kontrollen. Det finns tre statiska serverkontroller som deklareras i elementet <asp:webpartzone> . Även om dessa kontroller faktiskt WebPart inte är kontroller, kommer de att omslutas med ett GenericWebPart objekt vid körning, så du kan behandla dem som WebPart kontroller och därmed tilldela värden till deras AuthorizationFilter egenskaper. Observera att BulletedList kontrollen har sitt filter inställt på det värde som ska göra det möjligt att auktorisera den, enligt kriterierna i den anpassade WebPartManager kontrollen. Kontrollen Label har ett filtervärde som gör att den inte är auktoriserad. Kontrollen Calendar tilldelar inte ett värde till egenskapen, så som standard bör den auktoriseras.
<%@ 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>
Den tredje delen av kodexemplet är en inställning som du måste lägga till i Web.config-filen för att kunna exportera beskrivningsfiler för webbdelar. Kontrollera att du har en Web.config fil i samma katalog som webbsidan för det här kodexemplet. I avsnittet <system.web> kontrollerar du att det finns ett <webParts> element med ett enableExport attribut inställt på true, som i följande markering.
<webParts enableExport="true">
...
</webParts>
Läs in sidan i en webbläsare och observera att BulletedList kontrollerna och Calendar återges som förväntat, men kontrollen återges inte eftersom den Label inte har behörighet. Om du klickar på knappen List WebPart Controls (List WebPart Controls ) visas WebPartManager ID:t för alla kontroller i dess WebParts samling. Observera att ID:t för Label kontrollen visas, vilket bevisar att en UnauthorizedWebPart kontroll har lagts till i sidkontrollträdet för att hålla dess plats, även om etiketten inte återges på sidan.
Kommentarer
Kontrolluppsättningen Webbdelar tillhandahåller en auktoriseringsmekanism för att avgöra om enskilda WebPart kontroller kan läggas till på en sida. Utvecklare kan också tilldela en godtycklig sträng till egenskapen AuthorizationFilter på en WebPart kontroll.
WebPartManager När kontrollen lägger till kontroller på en sida kontrollerar den det här filtervärdet mot kriterier som angetts av utvecklaren med hjälp IsAuthorized av metoden och returnerar false om en kontroll inte är auktoriserad.
Note
Den här mekanismen fungerar också med serverkontroller och användarkontroller som placeras i WebPartZoneBase zoner, eftersom dessa kontroller omsluts med ett GenericWebPart objekt vid körning och det här objektet ärver AuthorizationFilter egenskapen.
När en WebPart kontroll inte är auktoriserad WebPartManager infogar kontrollen en UnauthorizedWebPart kontroll i kontrollträdet på sidan i stället för den obehöriga kontrollen. En UnauthorizedWebPart kontroll i kontrollträdet förbehåller sig positionen för den obehöriga kontrollen på sidan och förhindrar att personanpassningsdata som en användare tidigare har tillämpat på WebPart kontrollen går förlorade.
Kontrollen UnauthorizedWebPart visas aldrig på en sida där den infogas, och den visas inte heller i källkoden för den renderade sidan. Utvecklare kan verifiera dess närvaro i sidkontrollträdet genom att kontrollera WebParts kontrollens WebPartManager egenskap.
Konstruktorer
| Name | Description |
|---|---|
| UnauthorizedWebPart(String, String, String, String) |
Initierar en ny instans av en UnauthorizedWebPart kontroll, som anropas när en dynamisk WebPart kontroll (eller server eller användarkontroll) misslyckas med auktoriseringen. |
| UnauthorizedWebPart(WebPart) |
Initierar en ny instans av en UnauthorizedWebPart kontroll, som anropas när en statisk WebPart kontroll (eller server eller användarkontroll) misslyckas med auktoriseringen. |
Egenskaper
| Name | Description |
|---|---|
| AccessKey |
Hämtar eller anger åtkomstnyckeln som gör att du snabbt kan navigera till webbserverkontrollen. (Ärvd från WebControl) |
| Adapter |
Hämtar det webbläsarspecifika adaptern för kontrollen. (Ärvd från Control) |
| AllowClose |
Hämtar eller anger ett värde som anger om en slutanvändare kan stänga en WebPart kontroll på en webbsida. (Ärvd från WebPart) |
| AllowConnect |
Hämtar eller anger ett värde som anger om kontrollen WebPart tillåter att andra kontroller bildar anslutningar med den. (Ärvd från WebPart) |
| AllowEdit |
Hämtar eller anger ett värde som anger om en slutanvändare kan ändra en WebPart kontroll via användargränssnittet som tillhandahålls av en eller flera EditorPart kontroller. (Ärvd från WebPart) |
| AllowHide |
Hämtar eller anger ett värde som anger om slutanvändarna får dölja en WebPart kontroll. (Ärvd från WebPart) |
| AllowMinimize |
Hämtar eller anger ett värde som anger om slutanvändare kan minimera en WebPart kontroll. (Ärvd från WebPart) |
| AllowZoneChange |
Hämtar eller anger ett värde som anger om en användare kan flytta en WebPart kontroll mellan WebPartZoneBase zoner. (Ärvd från WebPart) |
| AppRelativeTemplateSourceDirectory |
Hämtar eller anger den programrelativa virtuella katalogen PageUserControl för eller -objektet som innehåller den här kontrollen. (Ärvd från Control) |
| Attributes |
Hämtar samlingen med godtyckliga attribut (endast för återgivning) som inte motsvarar egenskaperna i kontrollen. (Ärvd från WebControl) |
| AuthorizationFilter |
Hämtar eller anger en godtycklig sträng för att avgöra om en WebPart kontroll har behörighet att läggas till på en sida. (Ärvd från WebPart) |
| BackColor |
Hämtar eller anger bakgrundsfärgen för webbserverkontrollen. (Ärvd från WebControl) |
| BackImageUrl |
Hämtar eller anger URL:en för bakgrundsbilden för panelkontrollen. (Ärvd från Panel) |
| BindingContainer |
Hämtar kontrollen som innehåller den här kontrollens databindning. (Ärvd från Control) |
| BorderColor |
Hämtar eller anger kantlinjefärgen för webbkontrollen. (Ärvd från WebControl) |
| BorderStyle |
Hämtar eller anger kantlinjeformatet för webbserverkontrollen. (Ärvd från WebControl) |
| BorderWidth |
Hämtar eller anger kantlinjebredden för webbserverkontrollen. (Ärvd från WebControl) |
| CatalogIconImageUrl |
Hämtar eller anger URL:en till en bild som representerar en webbdelskontroll i en katalog med kontroller. (Ärvd från WebPart) |
| ChildControlsCreated |
Hämtar ett värde som anger om serverkontrollens underordnade kontroller har skapats. (Ärvd från Control) |
| ChromeState |
Hämtar eller anger om en delkontroll är i ett minimerat eller normalt tillstånd. (Ärvd från WebPart) |
| ChromeType |
Hämtar eller anger vilken typ av kantlinje som ramar in en webbdelskontroll. (Ärvd från WebPart) |
| ClientID |
Hämtar kontroll-ID:t för HTML-kod som genereras av ASP.NET. (Ärvd från Control) |
| ClientIDMode |
Hämtar eller anger den algoritm som används för att generera värdet för ClientID egenskapen. (Ärvd från Control) |
| ClientIDSeparator |
Hämtar ett teckenvärde som representerar det avgränsartecken som används i egenskapen ClientID . (Ärvd från Control) |
| ConnectErrorMessage |
Hämtar ett felmeddelande som ska visas för användare om fel inträffar under anslutningsprocessen. (Ärvd från WebPart) |
| Context |
Hämtar objektet HttpContext som är associerat med serverkontrollen för den aktuella webbbegäran. (Ärvd från Control) |
| Controls |
Hämtar ett ControlCollection objekt som innehåller underordnade kontroller för en angiven serverkontroll i användargränssnittshierarkin. (Ärvd från Part) |
| ControlStyle |
Hämtar formatmallen för webbserverkontrollen. Den här egenskapen används främst av kontrollutvecklare. (Ärvd från WebControl) |
| ControlStyleCreated |
Hämtar ett värde som anger om ett Style objekt har skapats för egenskapen ControlStyle . Den här egenskapen används främst av kontrollutvecklare. (Ärvd från WebControl) |
| CssClass |
Hämtar eller anger css-klassen (Cascading Style Sheet) som återges av webbserverkontrollen på klienten. (Ärvd från WebControl) |
| DataItemContainer |
Hämtar en referens till namngivningscontainern om namngivningscontainern implementerar IDataItemContainer. (Ärvd från Control) |
| DataKeysContainer |
Hämtar en referens till namngivningscontainern om namngivningscontainern implementerar IDataKeysControl. (Ärvd från Control) |
| DefaultButton |
Hämtar eller anger identifieraren för standardknappen som finns i Panel kontrollen. (Ärvd från Panel) |
| Description |
Hämtar eller anger en kort fras som sammanfattar vad delkontrollen gör, för användning i Knappbeskrivningar och kataloger med delkontroller. (Ärvd från WebPart) |
| DesignMode |
Hämtar ett värde som anger om en kontroll används på en designyta. (Ärvd från Control) |
| Direction |
Hämtar eller anger den vågräta riktning som innehållet flödar inom kontrollen. (Ärvd från WebPart) |
| DisplayTitle |
Hämtar en sträng som innehåller den fullständiga rubriktexten som faktiskt visas i namnlisten för en WebPart kontrollinstans. (Ärvd från WebPart) |
| Enabled |
Hämtar eller anger ett värde som anger om webbserverkontrollen är aktiverad. (Ärvd från WebControl) |
| EnableTheming |
Hämtar eller anger ett värde som anger om teman ska gälla för den här kontrollen. (Ärvd från WebControl) |
| EnableViewState |
Hämtar eller anger ett värde som anger om serverkontrollen bevarar sitt visningstillstånd och visningstillståndet för eventuella underordnade kontroller som den innehåller till den begärande klienten. (Ärvd från Control) |
| Events |
Hämtar en lista över händelsehanterardelegater för kontrollen. Den här egenskapen är skrivskyddad. (Ärvd från Control) |
| ExportMode |
Hämtar eller anger om alla, vissa eller ingen av en WebPart kontrolls egenskaper kan exporteras. (Ärvd från WebPart) |
| Font |
Hämtar teckensnittsegenskaperna som är associerade med webbserverkontrollen. (Ärvd från WebControl) |
| ForeColor |
Hämtar eller anger förgrundsfärgen (vanligtvis textens färg) för webbserverkontrollen. (Ärvd från WebControl) |
| GenericWebPartID |
Hämtar värdet för ID egenskapen från den allmänna webbdelskontrollen som ersätts av en proxywebbdelskontroll. (Ärvd från ProxyWebPart) |
| GroupingText |
Hämtar eller anger undertexten för den grupp kontroller som finns i panelkontrollen. (Ärvd från Panel) |
| HasAttributes |
Hämtar ett värde som anger om kontrollen har attribut inställda. (Ärvd från WebControl) |
| HasChildViewState |
Hämtar ett värde som anger om den aktuella serverkontrollens underordnade kontroller har några sparade vytillståndsinställningar. (Ärvd från Control) |
| HasSharedData |
Hämtar ett värde som anger om en WebPart kontroll har några delade anpassningsdata som är associerade med den. (Ärvd från WebPart) |
| HasUserData |
Hämtar ett värde som anger om en WebPart kontroll har några associerade användaranpassningsdata. (Ärvd från WebPart) |
| Height |
Hämtar eller anger höjden på en zon. (Ärvd från WebPart) |
| HelpMode |
Hämtar eller anger vilken typ av användargränssnitt (UI) som används för att visa hjälpinnehåll för en WebPart kontroll. (Ärvd från WebPart) |
| HelpUrl |
Hämtar eller anger URL:en till en hjälpfil för en WebPart kontroll. (Ärvd från WebPart) |
| Hidden |
Hämtar eller anger ett värde som anger om en WebPart kontroll visas på en webbsida. (Ärvd från WebPart) |
| HorizontalAlign |
Hämtar eller anger den vågräta justeringen av innehållet i panelen. (Ärvd från Panel) |
| ID |
Hämtar eller anger den programmatiska identifierare som tilldelats webbdelskontrollen. (Ärvd från ProxyWebPart) |
| IdSeparator |
Hämtar det tecken som används för att separera kontrollidentifierare. (Ärvd från Control) |
| ImportErrorMessage |
Hämtar eller anger ett felmeddelande som används om fel uppstår när en WebPart kontroll importeras. (Ärvd från WebPart) |
| IsChildControlStateCleared |
Hämtar ett värde som anger om kontroller i den här kontrollen har kontrolltillstånd. (Ärvd från Control) |
| IsClosed |
Hämtar ett värde som anger om en WebPart kontroll för närvarande är stängd på en webbdelssida. (Ärvd från WebPart) |
| IsEnabled |
Hämtar ett värde som anger om kontrollen är aktiverad. (Ärvd från WebControl) |
| IsShared |
Hämtar ett värde som anger om en WebPart kontroll delas, vilket innebär att den är synlig för alla användare av en webbdelssida. (Ärvd från WebPart) |
| IsStandalone |
Hämtar ett värde som anger om en WebPart kontroll är fristående, vilket innebär att den inte finns i en WebPartZoneBase zon. (Ärvd från WebPart) |
| IsStatic |
Hämtar ett värde som anger om en WebPart kontroll är en statisk kontroll, vilket innebär att kontrollen deklareras i markering av en webbdelssida och inte läggs till på sidan programmatiskt. (Ärvd från WebPart) |
| IsTrackingViewState |
Hämtar ett värde som anger om serverkontrollen sparar ändringar i visningstillståndet. (Ärvd från Control) |
| IsViewStateEnabled |
Hämtar ett värde som anger om visningstillstånd är aktiverat för den här kontrollen. (Ärvd från Control) |
| LoadViewStateByID |
Hämtar ett värde som anger om kontrollen deltar i inläsningen av dess visningstillstånd i ID stället för index. (Ärvd från Control) |
| NamingContainer |
Hämtar en referens till serverkontrollens namngivningscontainer, vilket skapar ett unikt namnområde för differentiering mellan serverkontroller med samma ID egenskapsvärde. (Ärvd från Control) |
| OriginalID |
ID Hämtar kontrollen webbdelar ersatt av proxywebbdelskontrollen. (Ärvd från ProxyWebPart) |
| OriginalPath |
Hämtar sökvägen till användarkontrollen som ersätts. (Ärvd från ProxyWebPart) |
| OriginalTypeName |
Type Hämtar kontrollen webbdelar ersatt av proxywebbdelskontrollen. (Ärvd från ProxyWebPart) |
| Page |
Hämtar en referens till den Page instans som innehåller serverkontrollen. (Ärvd från Control) |
| Parent |
Hämtar en referens till serverkontrollens överordnade kontroll i sidkontrollhierarkin. (Ärvd från Control) |
| RenderingCompatibility |
Hämtar ett värde som anger den ASP.NET version som renderad HTML kommer att vara kompatibel med. (Ärvd från Control) |
| ScrollBars |
Hämtar eller anger synlighet och position för rullningslister i en Panel kontroll. (Ärvd från Panel) |
| Site |
Hämtar information om containern som är värd för den aktuella kontrollen när den återges på en designyta. (Ärvd från Control) |
| SkinID |
Hämtar eller ställer in huden för att applicera på kontrollen. (Ärvd från WebControl) |
| Style |
Hämtar en samling textattribut som återges som ett formatattribut på den yttre taggen för webbserverkontrollen. (Ärvd från WebControl) |
| Subtitle |
Hämtar en sträng som sammanfogas med egenskapsvärdet Title för att skapa en fullständig rubrik för en WebPart kontroll. (Ärvd från WebPart) |
| SupportsDisabledAttribute |
Hämtar ett värde som anger om kontrollen ska ange |
| TabIndex |
Hämtar eller anger flikindexet för webbserverkontrollen. (Ärvd från WebControl) |
| TagKey |
Hämtar värdet HtmlTextWriterTag som motsvarar den här webbserverkontrollen. Den här egenskapen används främst av kontrollutvecklare. (Ärvd från WebControl) |
| TagName |
Hämtar namnet på kontrolltaggen. Den här egenskapen används främst av kontrollutvecklare. (Ärvd från WebControl) |
| TemplateControl |
Hämtar eller anger en referens till mallen som innehåller den här kontrollen. (Ärvd från Control) |
| TemplateSourceDirectory |
Hämtar den virtuella katalogen för Page eller UserControl som innehåller den aktuella serverkontrollen. (Ärvd från Control) |
| Title |
Hämtar eller anger rubriken för en delkontroll. (Ärvd från WebPart) |
| TitleIconImageUrl |
Hämtar eller anger URL:en till en bild som används för att representera en webbdelskontroll i kontrollens namnlist. (Ärvd från WebPart) |
| TitleUrl |
Hämtar eller anger en URL till kompletterande information om en WebPart kontroll. (Ärvd från WebPart) |
| ToolTip |
Hämtar eller anger texten som visas när muspekaren hovrar över webbserverkontrollen. (Ärvd från WebControl) |
| UniqueID |
Hämtar den unika, hierarkiskt kvalificerade identifieraren för serverkontrollen. (Ärvd från Control) |
| ValidateRequestMode |
Hämtar eller anger ett värde som anger om kontrollen kontrollerar klientindata från webbläsaren efter potentiellt farliga värden. (Ärvd från Control) |
| Verbs |
Hämtar en samling anpassade verb som är associerade med en WebPart kontroll. (Ärvd från WebPart) |
| ViewState |
Hämtar en ordlista med tillståndsinformation som gör att du kan spara och återställa visningstillståndet för en serverkontroll över flera begäranden för samma sida. (Ärvd från Control) |
| ViewStateIgnoresCase |
Hämtar ett värde som anger om objektet StateBag är skiftlägesokänsligt. (Ärvd från Control) |
| ViewStateMode |
Hämtar eller anger visningstillståndsläget för den här kontrollen. (Ärvd från Control) |
| Visible |
Hämtar eller anger ett värde som anger om en serverkontroll återges som användargränssnitt på sidan. (Ärvd från Control) |
| WebBrowsableObject |
Hämtar en referens till kontrollen så att den WebPart kan redigeras av anpassade EditorPart kontroller. (Ärvd från WebPart) |
| WebPartManager |
Hämtar en referens till kontrollen som WebPartManager är associerad med en WebPart kontrollinstans. (Ärvd från WebPart) |
| Width |
Hämtar eller anger bredden på webbserverkontrollen. (Ärvd från WebPart) |
| Wrap |
Hämtar eller anger ett värde som anger om innehållet omsluts i panelen. (Ärvd från Panel) |
| Zone |
WebPartZoneBase Hämtar zonen som för närvarande innehåller en WebPart kontroll. (Ärvd från WebPart) |
| ZoneIndex |
Hämtar indexpositionen för en WebPart kontroll inom dess zon. (Ärvd från WebPart) |
Metoder
| Name | Description |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Lägger till information om bakgrundsbilden, justering, radbrytning och riktning i listan över attribut som ska återges. (Ärvd från Panel) |
| AddedControl(Control, Int32) |
Anropas efter att en underordnad kontroll har lagts till i ControlsControl objektets samling. (Ärvd från Control) |
| AddParsedSubObject(Object) |
Meddelar serverkontrollen att ett element, antingen XML eller HTML, parsades och lägger till elementet i serverkontrollens ControlCollection objekt. (Ärvd från Control) |
| ApplyStyle(Style) |
Kopierar alla icke-tomma element i det angivna formatet till webbkontrollen och skriver över alla befintliga formatelement i kontrollen. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl) |
| ApplyStyleSheetSkin(Page) |
Tillämpar formategenskaperna som definierats i sidformatmallen på kontrollen. (Ärvd från Control) |
| BeginRenderTracing(TextWriter, Object) |
Påbörjar designtidsspårning av återgivningsdata. (Ärvd från Control) |
| BuildProfileTree(String, Boolean) |
Samlar in information om serverkontrollen och levererar den till egenskapen Trace som ska visas när spårning är aktiverat för sidan. (Ärvd från Control) |
| ClearCachedClientID() |
Anger det cachelagrade ClientID värdet till |
| ClearChildControlState() |
Tar bort kontrolltillståndsinformationen för serverkontrollens underordnade kontroller. (Ärvd från Control) |
| ClearChildState() |
Tar bort informationen om visningstillstånd och kontrolltillstånd för alla serverkontrollens underordnade kontroller. (Ärvd från Control) |
| ClearChildViewState() |
Tar bort visningstillståndsinformationen för alla serverkontrollens underordnade kontroller. (Ärvd från Control) |
| ClearEffectiveClientIDMode() |
Anger egenskapen för ClientIDMode den aktuella kontrollinstansen och för eventuella underordnade kontroller till Inherit. (Ärvd från Control) |
| CopyBaseAttributes(WebControl) |
Kopierar egenskaperna som inte kapslas in av Style objektet från den angivna webbserverkontrollen till den webbserverkontroll som den här metoden anropas från. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl) |
| CreateChildControls() |
Anropas av det ASP.NET sidramverket för att meddela serverkontroller som använder kompositionsbaserad implementering för att skapa underordnade kontroller som de innehåller som förberedelse för att publicera tillbaka eller återge. (Ärvd från Control) |
| CreateControlCollection() |
Skapar ett nytt ControlCollection objekt som innehåller de underordnade kontrollerna (både literal och server) för serverkontrollen. (Ärvd från Control) |
| CreateControlStyle() |
Skapar ett formatobjekt som används internt av Panel kontrollen för att implementera alla formatrelaterade egenskaper. (Ärvd från Panel) |
| CreateEditorParts() |
Returnerar en samling anpassade EditorPart kontroller som kan användas för att redigera en WebPart kontroll när den är i redigeringsläge. (Ärvd från WebPart) |
| DataBind() |
Binder en datakälla till den anropade serverkontrollen och alla dess underordnade kontroller. (Ärvd från Part) |
| DataBind(Boolean) |
Binder en datakälla till den anropade serverkontrollen och alla dess underordnade kontroller med ett alternativ för att skapa händelsen DataBinding . (Ärvd från Control) |
| DataBindChildren() |
Binder en datakälla till serverkontrollens underordnade kontroller. (Ärvd från Control) |
| Dispose() |
Gör att en serverkontroll kan utföra slutlig rensning innan den frigörs från minnet. (Ärvd från Control) |
| EndRenderTracing(TextWriter, Object) |
Avslutar designtidsspårning av återgivningsdata. (Ärvd från Control) |
| EnsureChildControls() |
Avgör om serverkontrollen innehåller underordnade kontroller. Om den inte gör det skapar den underordnade kontroller. (Ärvd från Control) |
| EnsureID() |
Skapar en identifierare för kontroller som inte har tilldelats någon identifierare. (Ärvd från Control) |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| FindControl(String, Int32) |
Söker i den aktuella namngivningscontainern efter en serverkontroll med det angivna |
| FindControl(String) |
Söker i den aktuella namngivningscontainern efter en serverkontroll med den angivna |
| Focus() |
Anger indatafokus till en kontroll. (Ärvd från Control) |
| GetDesignModeState() |
Hämtar designtidsdata för en kontroll. (Ärvd från Control) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetRouteUrl(Object) |
Hämtar url:en som motsvarar en uppsättning routningsparametrar. (Ärvd från Control) |
| GetRouteUrl(RouteValueDictionary) |
Hämtar url:en som motsvarar en uppsättning routningsparametrar. (Ärvd från Control) |
| GetRouteUrl(String, Object) |
Hämtar url:en som motsvarar en uppsättning vägparametrar och ett vägnamn. (Ärvd från Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Hämtar url:en som motsvarar en uppsättning vägparametrar och ett vägnamn. (Ärvd från Control) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| GetUniqueIDRelativeTo(Control) |
Returnerar den prefixade delen av UniqueID egenskapen för den angivna kontrollen. (Ärvd från Control) |
| HasControls() |
Avgör om serverkontrollen innehåller några underordnade kontroller. (Ärvd från Control) |
| HasEvents() |
Returnerar ett värde som anger om händelser har registrerats för kontrollen eller underordnade kontroller. (Ärvd från Control) |
| IsLiteralContent() |
Avgör om serverkontrollen endast innehåller literalinnehåll. (Ärvd från Control) |
| LoadControlState(Object) |
Åsidosättningar LoadControlState(Object) för att förhindra inläsning av tidigare sparat tillstånd för ett ProxyWebPart objekt. (Ärvd från ProxyWebPart) |
| LoadViewState(Object) |
Åsidosättningar LoadViewState(Object) för att förhindra inläsning av tidigare sparat visningstillstånd för ett ProxyWebPart objekt. (Ärvd från ProxyWebPart) |
| MapPathSecure(String) |
Hämtar den fysiska sökväg som en virtuell sökväg, antingen absolut eller relativ, mappar till. (Ärvd från Control) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| MergeStyle(Style) |
Kopierar alla icke-tomma element i det angivna formatet till webbkontrollen, men skriver inte över några befintliga formatelement i kontrollen. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Avgör om händelsen för serverkontrollen skickas upp på sidans UI-serverkontrollhierarki. (Ärvd från Control) |
| OnClosing(EventArgs) |
Aktiverar härledda klasser för att tillhandahålla anpassad hantering när en WebPart kontroll stängs på en webbdelssida. (Ärvd från WebPart) |
| OnConnectModeChanged(EventArgs) |
Gör det möjligt för härledda klasser att tillhandahålla anpassad hantering när en WebPart kontroll påbörjar eller avslutar processen med att ansluta till andra kontroller. (Ärvd från WebPart) |
| OnDataBinding(EventArgs) |
Genererar händelsen DataBinding . (Ärvd från Control) |
| OnDeleting(EventArgs) |
Aktiverar härledda klasser för att tillhandahålla anpassad hantering när en WebPart kontroll tas bort permanent från en webbdelssida. (Ärvd från WebPart) |
| OnEditModeChanged(EventArgs) |
Aktiverar härledda klasser för att tillhandahålla anpassad hantering när en WebPart kontroll går in i eller lämnar redigeringsläget. (Ärvd från WebPart) |
| OnInit(EventArgs) |
Genererar händelsen Init . (Ärvd från Control) |
| OnLoad(EventArgs) |
Genererar händelsen Load . (Ärvd från Control) |
| OnPreRender(EventArgs) |
Genererar händelsen PreRender . (Ärvd från Control) |
| OnUnload(EventArgs) |
Genererar händelsen Unload . (Ärvd från Control) |
| OpenFile(String) |
Hämtar en Stream som används för att läsa en fil. (Ärvd från Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Tilldelar alla källor till händelsen och dess information till kontrollens överordnade. (Ärvd från Control) |
| RemovedControl(Control) |
Anropas efter att en underordnad Controls kontroll har tagits bort från objektets Control samling. (Ärvd från Control) |
| Render(HtmlTextWriter) |
Renderar kontrollen till den angivna HTML-skrivaren. (Ärvd från WebControl) |
| RenderBeginTag(HtmlTextWriter) |
Renderar HTML-öppningstaggen för Panel kontrollen till den angivna skrivaren. (Ärvd från Panel) |
| RenderChildren(HtmlTextWriter) |
Matar ut innehållet i en serverkontrolls underordnade objekt till ett angivet HtmlTextWriter objekt som skriver innehållet som ska återges på klienten. (Ärvd från Control) |
| RenderContents(HtmlTextWriter) |
Renderar innehållet i kontrollen till den angivna skrivaren. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Matar ut serverkontrollinnehåll till ett angivet HtmlTextWriter objekt med hjälp av ett angivet ControlAdapter objekt. (Ärvd från Control) |
| RenderControl(HtmlTextWriter) |
Matar ut serverkontrollinnehåll till ett angivet HtmlTextWriter objekt och lagrar spårningsinformation om kontrollen om spårning är aktiverat. (Ärvd från Control) |
| RenderEndTag(HtmlTextWriter) |
Renderar HTML-avslutande taggen för Panel kontrollen till den angivna skrivaren. (Ärvd från Panel) |
| ResolveAdapter() |
Hämtar kontrollkortet som ansvarar för att återge den angivna kontrollen. (Ärvd från Control) |
| ResolveClientUrl(String) |
Hämtar en URL som kan användas av webbläsaren. (Ärvd från Control) |
| ResolveUrl(String) |
Konverterar en URL till en som kan användas på den begärande klienten. (Ärvd från Control) |
| SaveControlState() |
Sparar alla ändringar i serverkontrolltillståndet som har inträffat sedan sidan publicerades tillbaka till servern. (Ärvd från ProxyWebPart) |
| SaveViewState() |
Sparar alla tillstånd som ändrades efter TrackViewState() att metoden anropades. (Ärvd från ProxyWebPart) |
| SetDesignModeState(IDictionary) |
Anger designtidsdata för en kontroll. (Ärvd från Control) |
| SetPersonalizationDirty() |
Anger en flagga som anger att anpassningsdata har ändrats för den aktuella WebPart kontrollinstansen. (Ärvd från WebPart) |
| SetRenderMethodDelegate(RenderMethod) |
Tilldelar ett händelsehanterardelegat för att återge serverkontrollen och dess innehåll till den överordnade kontrollen. (Ärvd från Control) |
| SetTraceData(Object, Object, Object) |
Anger spårningsdata för designtidsspårning av återgivningsdata, med hjälp av det spårade objektet, spårningsdatanyckeln och värdet för spårningsdata. (Ärvd från Control) |
| SetTraceData(Object, Object) |
Anger spårningsdata för designtidsspårning av återgivningsdata med hjälp av spårningsdatanyckeln och värdet för spårningsdata. (Ärvd från Control) |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
| TrackViewState() |
Gör att kontrollen spårar ändringar i dess visningstillstånd så att de kan lagras i objektets ViewState egenskap. (Ärvd från WebPart) |
Händelser
| Name | Description |
|---|---|
| DataBinding |
Inträffar när serverkontrollen binder till en datakälla. (Ärvd från Control) |
| Disposed |
Inträffar när en serverkontroll frigörs från minnet, vilket är den sista fasen i serverkontrolllivscykeln när en ASP.NET sida begärs. (Ärvd från Control) |
| Init |
Inträffar när serverkontrollen initieras, vilket är det första steget i dess livscykel. (Ärvd från Control) |
| Load |
Inträffar när serverkontrollen läses in i Page objektet. (Ärvd från Control) |
| PreRender |
Inträffar efter att objektet Control har lästs in men före återgivningen. (Ärvd från Control) |
| Unload |
Inträffar när serverkontrollen tas bort från minnet. (Ärvd från Control) |
Explicita gränssnittsimplementeringar
| Name | Description |
|---|---|
| IAttributeAccessor.GetAttribute(String) |
Hämtar ett attribut för webbkontrollen med det angivna namnet. (Ärvd från WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Anger ett attribut för webbkontrollen till det angivna namnet och värdet. (Ärvd från WebControl) |
| ICompositeControlDesignerAccessor.RecreateChildControls() |
Gör att utvecklaren av en designer för en sammansatt delkontroll kan återskapa kontrollens underordnade kontroller på designytan. (Ärvd från Part) |
| IControlBuilderAccessor.ControlBuilder |
En beskrivning av den här medlemmen finns i ControlBuilder. (Ärvd från Control) |
| IControlDesignerAccessor.GetDesignModeState() |
En beskrivning av den här medlemmen finns i GetDesignModeState(). (Ärvd från Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
En beskrivning av den här medlemmen finns i SetDesignModeState(IDictionary). (Ärvd från Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
En beskrivning av den här medlemmen finns i SetOwnerControl(Control). (Ärvd från Control) |
| IControlDesignerAccessor.UserData |
En beskrivning av den här medlemmen finns i UserData. (Ärvd från Control) |
| IDataBindingsAccessor.DataBindings |
En beskrivning av den här medlemmen finns i DataBindings. (Ärvd från Control) |
| IDataBindingsAccessor.HasDataBindings |
En beskrivning av den här medlemmen finns i HasDataBindings. (Ärvd från Control) |
| IExpressionsAccessor.Expressions |
En beskrivning av den här medlemmen finns i Expressions. (Ärvd från Control) |
| IExpressionsAccessor.HasExpressions |
En beskrivning av den här medlemmen finns i HasExpressions. (Ärvd från Control) |
| IParserAccessor.AddParsedSubObject(Object) |
En beskrivning av den här medlemmen finns i AddParsedSubObject(Object). (Ärvd från Control) |
Tilläggsmetoder
| Name | Description |
|---|---|
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Aktiverar dynamiskt databeteende för den angivna datakontrollen. |
| EnableDynamicData(INamingContainer, Type, Object) |
Aktiverar dynamiskt databeteende för den angivna datakontrollen. |
| EnableDynamicData(INamingContainer, Type) |
Aktiverar dynamiskt databeteende för den angivna datakontrollen. |
| FindDataSourceControl(Control) |
Returnerar datakällan som är associerad med datakontrollen för den angivna kontrollen. |
| FindFieldTemplate(Control, String) |
Returnerar fältmallen för den angivna kolumnen i den angivna kontrollens namngivningscontainer. |
| FindMetaTable(Control) |
Returnerar metatabellobjektet för den innehållande datakontrollen. |
| GetDefaultValues(INamingContainer) |
Hämtar insamlingen av standardvärdena för den angivna datakontrollen. |
| GetMetaTable(INamingContainer) |
Hämtar tabellmetadata för den angivna datakontrollen. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Anger tabellmetadata och standardvärdemappning för den angivna datakontrollen. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Anger tabellmetadata och standardvärdemappning för den angivna datakontrollen. |
| SetMetaTable(INamingContainer, MetaTable) |
Anger tabellmetadata för den angivna datakontrollen. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Avgör om tabellmetadata är tillgängliga. |