Part 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.
Fungerar som basklass för alla webbdelsdelskontroller, som renderar ett modulärt användargränssnitt på en webbformulärsida.
public ref class Part abstract : System::Web::UI::WebControls::Panel, System::Web::UI::INamingContainer, System::Web::UI::WebControls::ICompositeControlDesignerAccessor
public abstract class Part : System.Web.UI.WebControls.Panel, System.Web.UI.INamingContainer, System.Web.UI.WebControls.ICompositeControlDesignerAccessor
type Part = class
inherit Panel
interface INamingContainer
interface ICompositeControlDesignerAccessor
Public MustInherit Class Part
Inherits Panel
Implements ICompositeControlDesignerAccessor, INamingContainer
- Arv
- Härledda
- Implementeringar
Exempel
Följande kodexempel visar deklarativ användning av flera egenskaper för klassen Part genom att använda två instanser av en anpassad WebPart-kontroll som refereras till på en ASP.NET webbsida. För att kodexemplet ska köras måste du kompilera den här källkoden. Du kan kompilera den explicit och placera den resulterande sammansättningen i webbplatsens bin-mapp eller den globala sammansättningscacheminnet. Du kan också placera källkoden i webbplatsens App_Code mapp, där den kompileras dynamiskt vid körning. En genomgång som visar båda kompileringsmetoderna finns i Genomgång: Utveckla och använda en anpassad webbserverkontroll.
Den första delen av exemplet innehåller koden för den anpassade kontrollen med namnet TextDisplayWebPart. Eftersom kontrollen härleds från WebPartärver den också de vanliga egenskaper som Part klassen tillhandahåller och illustrerar användningen av dessa egenskaper i det här kodexemplet.
using System;
using System.Security.Permissions;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
namespace Samples.AspNet.CS.Controls
{
[AspNetHostingPermission(SecurityAction.Demand,
Level=AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level=AspNetHostingPermissionLevel.Minimal)]
public class TextDisplayWebPart : WebPart
{
private String _contentText = null;
TextBox input;
Label DisplayContent;
const string _subTitle = "Contoso, Ltd";
public TextDisplayWebPart()
{
this.AllowClose = false;
}
[
Personalizable(PersonalizationScope.User, true),
WebBrowsable()
]
public String ContentText
{
get { return _contentText; }
set { _contentText = value; }
}
protected override void CreateChildControls()
{
Controls.Clear();
DisplayContent = new Label();
DisplayContent.BackColor =
System.Drawing.Color.LightBlue;
DisplayContent.Text = this.ContentText;
this.Controls.Add(DisplayContent);
input = new TextBox();
this.Controls.Add(input);
Button update = new Button();
update.Text = "Set Label Content";
update.Click += new EventHandler(this.submit_Click);
this.Controls.Add(update);
ChildControlsCreated = true;
}
private void submit_Click(object sender, EventArgs e)
{
// Update the label string.
if (!string.IsNullOrEmpty(input.Text))
{
this.ContentText = Page.Server.HtmlEncode(input.Text) + @"<br />";
// Clear the input textbox.
input.Text = String.Empty;
DisplayContent.Text = this.ContentText;
}
}
}
}
Imports System.Security.Permissions
Imports System.Web
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 TextDisplayWebPart
Inherits WebPart
Private _contentText As String = Nothing
Private input As TextBox
Private DisplayContent As Label
Public Sub New()
Me.AllowClose = False
End Sub
<Personalizable(), WebBrowsable()> _
Public Property ContentText() As String
Get
Return _contentText
End Get
Set
_contentText = value
End Set
End Property
Protected Overrides Sub CreateChildControls()
Controls.Clear()
DisplayContent = New Label()
DisplayContent.Text = Me.ContentText
DisplayContent.BackColor = _
System.Drawing.Color.LightBlue
Me.Controls.Add(DisplayContent)
input = New TextBox()
Me.Controls.Add(input)
Dim update As New Button()
update.Text = "Set Label Content"
AddHandler update.Click, AddressOf Me.submit_Click
Me.Controls.Add(update)
ChildControlsCreated = True
End Sub
Private Sub submit_Click(ByVal sender As Object, _
ByVal e As EventArgs)
' Update the label string.
If input.Text <> String.Empty Then
Me.ContentText = Page.Server.HtmlEncode(input.Text) + "<br />"
' Clear the input textbox.
input.Text = String.Empty
DisplayContent.Text = Me.ContentText
End If
End Sub
End Class
End Namespace
Den andra delen av exemplet visar hur du refererar till kontrollerna för den anpassade delen på en ASP.NET webbsida. Observera att de olika Part egenskaperna tilldelas deklarativt till de anpassade kontrollinstanserna. Jämför den deklarativa kod som refererar till de två instanserna på sidan och läs sedan in sidan i en webbläsare. Observera hur de olika egenskaperna påverkar kontrollernas utseende. När du till exempel har läst in sidan i en webbläsare visas den andra instansen TextDisplayWebPart av kontrollen minimerad eftersom dess ChromeState egenskapsvärde är inställt på Minimized.
<%@ page language="C#" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.CS.Controls"
Assembly="TextDisplayWebPartCS" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<asp:webpartmanager id="WebPartManager1" runat="server" />
<asp:webpartzone
id="WebPartZone1"
runat="server"
backcolor="#99cccc">
<parttitlestyle font-bold="true" forecolor="#ffffff" />
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart"
Description="A text content WebPart control."
ChromeType="TitleAndBorder"
width="350px" />
</zonetemplate>
</asp:webpartzone>
<asp:webpartzone
id="WebPartZone2"
runat="server"
backcolor="#99cccc">
<parttitlestyle font-bold="true" forecolor="#ffffff" />
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart2"
title = "Text Content WebPart 2"
Description="A text content WebPart control."
ChromeType="TitleOnly"
ChromeState="Minimized"
width="350px" />
</zonetemplate>
</asp:webpartzone>
</form>
</body>
</html>
<%@ page language="VB" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.VB.Controls"
Assembly="TextDisplayWebPartVB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<asp:webpartmanager id="WebPartManager1" runat="server" />
<asp:webpartzone
id="WebPartZone1"
runat="server"
backcolor="#99cccc">
<parttitlestyle font-bold="true" forecolor="#ffffff" />
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart"
Description="A text content WebPart control."
ChromeType="TitleAndBorder"
width="350px" />
</zonetemplate>
</asp:webpartzone>
<asp:webpartzone
id="WebPartZone2"
runat="server"
backcolor="#99cccc">
<parttitlestyle font-bold="true" forecolor="#ffffff" />
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart2"
title = "Text Content WebPart 2"
Description="A text content WebPart control."
ChromeType="TitleOnly"
ChromeState="Minimized"
width="350px" />
</zonetemplate>
</asp:webpartzone>
</form>
</body>
</html>
Kommentarer
Klassen Part definierar egenskaper som är gemensamma för alla delkontroller och gör att de kan ha ett modulärt och konsekvent utseende på en webbsida. Dessa vanliga egenskaper omfattar en rubrik, en beskrivning och egenskaper för den krom eller ram som omger en delkontroll.
Egenskapen Title anger en rubrik för delkontrollen. Egenskapen Description används för att sammanfatta delkontrollens syfte och visas som en knappbeskrivning i kontrollens namnlist. Egenskapen ChromeType avgör vilken typ av kantlinje som återges runt en delkontroll, medan ChromeState egenskapen anger om en delkontroll återges normalt eller minimeras. Kantlinjen för en delkontroll påverkas av egenskaperna för den zon som innehåller den. Egenskapen påverkar till exempel PartChromeType ramarna för alla delkontroller som finns i en zon.
En typ av delkontroll är WebPart kontrollen, som återger innehåll i en motsvarande zon. En annan typ är kontrollen EditorPart , som tillhandahåller användargränssnittskontroller (UI) som används för att ändra (anpassa) enskilda WebPart kontroller. En tredje typ av delkontroll är CatalogPart kontrollen, som innehåller en lista över WebPart kontroller som användare kan lägga till eller ta bort från en webbsida.
Delkontroller finns i zoner, som alla härleds från den abstrakta WebZone klassen. En zon ansvarar för att organisera de delkontroller som den innehåller. Varje zon renderar även användargränssnittselement för sig själv, inklusive ett sidhuvud, en sidfot, ett namnlist och gränssnittselement runt varje innesluten delkontroll, till exempel kantlinjer.
Note
Även om delkontroller vanligtvis finns i zoner är det möjligt att placera en delkontroll utanför en zon, om kontrollen refereras deklarativt i markering av en webbsida. Om en delkontroll deklareras utanför en zon på en webbsida fungerar kontrollen fortfarande, men förlorar de flesta webbdelarna. Kontrollen kan till exempel inte redigeras och kan inte dras till en zon vid körning. Det är också bra att komma ihåg att ingen delkontroll kan dras från en zon och släppas på en sida utanför en zon vid körning.
Några exempel på basdelstyper och deras motsvarande zontyper visas i följande tabell.
| Typ av delkontroll | Zontyp |
|---|---|
| WebPart | WebPartZone |
| EditorPart | EditorZone |
| CatalogPart | CatalogZone |
De olika typer av delkontroller som härleds från Part klassen hanterar de ärvda, UI-orienterade egenskaperna på olika sätt.
WebPart kontroller åsidosätter flera av de ärvda gränssnittsegenskaperna och markerar dem med Personalizable attributet (mer information finns i klassdokumentationen PersonalizableAttribute ), vilket gör att värdena för dessa egenskaper kan sparas för framtida webbläsarsessioner, en funktion som kallas anpassning. Om du till exempel programmatiskt gör det möjligt för en användare att uppdatera värdet för en WebPart kontrolls Title egenskap vid körning kommer det värdet att anpassas (förutsatt att anpassning är aktiverat, vilket är standardvärdet). Flera gränssnittsegenskaper som WebPart styr ärver från Part klassen och från WebControl klassen hanteras på samma sätt.
Andra delkontroller, till exempel EditorPart och CatalogPart, gör däremot inte att de ärvda gränssnittsegenskaperna kan anpassas. Därför sparas inte programmatiskt tilldelade egenskapsvärden för framtida webbläsarsessioner. Om du till exempel programmatiskt gör det möjligt för en användare att uppdatera en PropertyGridEditorPart kontrolls Title egenskap vid körning går det uppdaterade värdet förlorat när kontrollen har stängts eller webbläsarsessionen avslutas.
Ett enkelt sätt att spara värdena på sådana ärvda gränssnittsegenskaper för EditorPart och CatalogPart kontroller för framtida webbläsarsessioner är att deklarera egenskapsvärdena i sidpersistenceformat. Detta är dock en statisk metod och tillåter fortfarande inte att användarna anpassar egenskapsvärdena. Om du vill aktivera programmatiska uppdateringar av de ärvda gränssnittsegenskaperna så att användarna kan anpassa dem vid körning kan du använda privata, statiska variabler för att spara egenskapsvärdena. Varje gång en ny instans av en EditorPart eller CatalogPart kontroll skapas (till exempel i metoden som hanterar kontrollens Init händelse) kan du tilldela om värdet för en statisk variabel till en motsvarande egenskap. En sådan metod ger användarna möjlighet att anpassa redigeringsgränssnittet och kataloggränssnittet för ett webbdelsprogram.
Anteckningar till implementerare
Normalt bör du inte ärva direkt från Part klassen för att utveckla anpassade webbdelskontroller. För att tillhandahålla fullständig webbdelsfunktion kräver kontrolluppsättningen webbdelar klasserna som härleds från Part klassen, nämligen WebPart, EditorPartoch CatalogPart, så du bör härleda från dem för att utveckla anpassade kontroller. Det är dock fortfarande viktigt att förstå basklassens Part beteende, eftersom det ger en gemensam uppsättning egenskaper som används av alla andra delklasser.
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) |
| 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) |
| 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) |
| 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. |
| ChromeType |
Hämtar eller anger vilken typ av kantlinje som ramar in en webbdelskontroll. |
| 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) |
| 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. |
| 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. |
| 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 i vilken riktning du vill visa kontroller som innehåller text i en Panel kontroll. (Ärvd från Panel) |
| 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) |
| 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) |
| 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) |
| Height |
Hämtar eller anger höjden på webbserverkontrollen. (Ärvd från WebControl) |
| 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 serverkontrollen. (Ärvd från Control) |
| IdSeparator |
Hämtar det tecken som används för att separera kontrollidentifierare. (Ärvd från Control) |
| IsChildControlStateCleared |
Hämtar ett värde som anger om kontroller i den här kontrollen har kontrolltillstånd. (Ärvd från Control) |
| IsEnabled |
Hämtar ett värde som anger om kontrollen är aktiverad. (Ärvd från WebControl) |
| 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) |
| 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) |
| 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. |
| 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) |
| 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) |
| Width |
Hämtar eller anger bredden på webbserverkontrollen. (Ärvd från WebControl) |
| Wrap |
Hämtar eller anger ett värde som anger om innehållet omsluts i panelen. (Ärvd från Panel) |
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) |
| DataBind() |
Binder en datakälla till den anropade serverkontrollen och alla dess underordnade kontroller. |
| 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) |
Återställer kontrolltillståndsinformation från en begäran från föregående sida som sparades av SaveControlState() metoden. (Ärvd från Control) |
| LoadViewState(Object) |
Återställer visningstillståndsinformation från en tidigare begäran som sparades med SaveViewState() metoden. (Ärvd från WebControl) |
| 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) |
| OnDataBinding(EventArgs) |
Genererar händelsen DataBinding . (Ärvd från Control) |
| 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 Control) |
| SaveViewState() |
Sparar alla tillstånd som ändrades efter TrackViewState() att metoden anropades. (Ärvd från WebControl) |
| SetDesignModeState(IDictionary) |
Anger designtidsdata för en kontroll. (Ärvd från Control) |
| 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 WebControl) |
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. |
| 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. |