WebZone Klass

Definition

Namnområde:: System.Web.UI.WebControls.WebParts

Sammansättning:: System.Web.dll

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 kontroller som fungerar som containrar för serverkontroller (inklusive webbdelskontroller Part , serverkontroller och användarkontroller) i webbdelsprogram.

public ref class WebZone abstract : System::Web::UI::WebControls::CompositeControl

[System.ComponentModel.Bindable(false)]
public abstract class WebZone : System.Web.UI.WebControls.CompositeControl

[<System.ComponentModel.Bindable(false)>]
type WebZone = class
    inherit CompositeControl

Public MustInherit Class WebZone
Inherits CompositeControl

Arv: Object

Control

WebControl

CompositeControl
WebZone

Härledda: System.Web.UI.WebControls.WebParts.ToolZone

System.Web.UI.WebControls.WebParts.WebPartZoneBase

Attribut: BindableAttribute

Exempel

I följande kodexempel visas hur klassen används WebZone .

Den första delen av kodexemplet visar två anpassade kontroller som härleds WebPart från klassen. 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.

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 CalendarWebPart : WebPart
  {
    Calendar _calendar;

    public CalendarWebPart()
    {
      this.AllowClose = false;
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      _calendar = new Calendar();
      _calendar.Caption = "My Calendar";
      this.Controls.Add(_calendar);
      ChildControlsCreated = true;
    }
  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class LinksWebPart : WebPart
  {
    Literal _literal;
    const string _literalText = @"
      <table>
      <tr>
        <td><a href='http://msdn.microsoft.com'>MSDN</a></td>
      </tr>
      <tr>
        <td><a href='http://msn.microsoft.com'>MSN</a></td>
      </tr>
      <tr>
        <td><a href='http://www.msnbc.msn.com'>MSNBC</a></td>
      </tr>
      </table>";

    public LinksWebPart()
    {
      this.AllowClose = false;
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();

      _literal = new Literal();
      _literal.Text = _literalText;
      this.Controls.Add(_literal);

      ChildControlsCreated = true;
    }
  }
}

Imports System.Security.Permissions 
Imports System.Web
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 CalendarWebPart
  Inherits WebPart
  Private _calendar As Calendar

  Public Sub New()
    Me.AllowClose = False

  End Sub

  Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      _calendar = New Calendar()
      _calendar.Caption = "My Calendar"
      Me.Controls.Add(_calendar)
      ChildControlsCreated = True
  
  End Sub 
  
End Class 

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class LinksWebPart
    Inherits WebPart
    Private _literal As Literal
    Private Const _literalText As String = _
      "<table>" & _
      "<tr>" & _
      "<td><a href='http://msdn.microsoft.com'>MSDN</a></td>" & _
      "</tr>" & _
      "<tr>" & _
      "<td><a href='http://msn.microsoft.com'>MSN</a></td>" & _
      "</tr>" & _
      "<tr>" & _
      "<td><a href='http://www.msnbc.msn.com'>MSNBC</a></td>" & _
      "</tr>" & _
      "</table>"

    Public Sub New()
      Me.AllowClose = False

    End Sub


    Protected Overrides Sub CreateChildControls()
      Controls.Clear()

      _literal = New Literal()
      _literal.Text = _literalText
      Me.Controls.Add(_literal)

      ChildControlsCreated = True

    End Sub
  End Class

End Namespace

Den andra delen av kodexemplet visar en webbsida som är värd för WebPart kontrollerna. Observera att deklarativ kod innehåller två WebPartZone kontroller, en CatalogZone kontroll och en EditorZone kontroll.

<%@ page language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="ZoneWebPartsCS"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

</script>
<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" />
    <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <ZoneTemplate>
          <aspSample:CalendarWebPart 
            runat="server"   
            id="CalendarWebPart1" 
            Title="Calendar WebPart"
            />         
        </ZoneTemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      title="Zone 2"
      PartChromeType="TitleAndBorder"
      EmptyZoneText="Empty Zone">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
    </asp:webpartzone>
    <asp:EditorZone ID="editzone1" Runat="server">
      <ZoneTemplate>
        <asp:AppearanceEditorPart 
          ID="appearanceeditor1" 
          Runat="server" />
        <asp:LayoutEditorPart 
          ID="LayoutEditorPart1" 
          Runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <asp:CatalogZone ID="catalogzone1" Runat="server" >
      <ZoneTemplate>
        <asp:DeclarativeCatalogPart 
          ID="declarativepart1" 
          Runat="server">
          <WebPartsTemplate>
          <aspSample:LinksWebPart 
            runat="server"   
            id="linkswebpart" 
            Title="Favorite Links"
            />  
          </WebPartsTemplate>
        </asp:DeclarativeCatalogPart>
      </ZoneTemplate>
    </asp:CatalogZone>
    <br />
  </form>
</body>
</html>

<%@ page language="VB" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.VB.Controls" 
  Assembly="ZoneWebPartsVB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

</script>
<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" />
    <uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <ZoneTemplate>
          <aspSample:CalendarWebPart 
            runat="server"   
            id="CalendarWebPart1" 
            Title="Calendar WebPart"
            />         
        </ZoneTemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      title="Zone 2"
      PartChromeType="TitleAndBorder"
      EmptyZoneText="Empty Zone">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
    </asp:webpartzone>
    <asp:EditorZone ID="editzone1" Runat="server">
      <ZoneTemplate>
        <asp:AppearanceEditorPart 
          ID="appearanceeditor1" 
          Runat="server" />
        <asp:LayoutEditorPart 
          ID="LayoutEditorPart1" 
          Runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <asp:CatalogZone ID="catalogzone1" Runat="server" >
      <ZoneTemplate>
        <asp:DeclarativeCatalogPart 
          ID="declarativepart1" 
          Runat="server">
          <WebPartsTemplate>
          <aspSample:LinksWebPart 
            runat="server"   
            id="linkswebpart" 
            Title="Favorite Links"
            />  
          </WebPartsTemplate>
        </asp:DeclarativeCatalogPart>
      </ZoneTemplate>
    </asp:CatalogZone>
    <br />
  </form>
</body>
</html>

Du kan läsa in sidan i en webbläsare och växla mellan de olika sidvisningslägena för att se hur de olika zonerna beter sig. Mer information om visningslägen och hur du gör det möjligt för användare att växla mellan dem finns i Genomgång: Ändra visningslägen på en webbsida.

Kommentarer

En webbdelszon är en definierad region som innehåller serverkontroller på en webbsida och tillhandahåller ett konsekvent användargränssnitt (UI), layout och rendering för de inneslutna kontrollerna. Zoner återges i en webbläsare som HTML-tabeller.

Klassen WebZone är basklassen för alla webbdelszoner. En zonkontroll är en sammansatt kontroll som är utformad för att innehålla andra kontroller, och därför WebZone ärver klassen från CompositeControl klassen. Tillsammans med kontrollen WebPartManager och Part kontrollerna (eller andra användar- eller serverkontroller som kan placeras i zoner) utgör zonkontroller som härleds från WebZone basklassen de viktigaste byggstenarna i ett webbdelsprogram.

En viktig roll för webbdelszoner är att aktivera fullständig webbdelsfunktion för de kontroller som de innehåller. Varje webbdelssida innehåller minst en zon och en zon kan innehålla noll eller flera delkontroller. Zoner krävs för webbdelsfunktioner. Utan zoner kan även kontroller som härleds WebPart från klassen ha mycket lite funktioner för webbdelar. På grund av utformningen av kontrolluppsättningen webbdelar kan du placera vanliga ASP.NET kontroller, serverkontroller eller användarkontroller i en WebPartZoneBase zon (som härleds från WebZone), och på grund av att de är i zonen kan dessa vanliga serverkontroller fungera som WebPart kontroller vid körning. Mer information finns i dokumentationen GenericWebPart för klassen.

Note

Det är möjligt att lägga Part till eller WebPart kontroller på en sida utanför en zon, men i så fall fungerar de bara som vanliga serverkontroller.

Det finns två breda kategorier av zoner i kontrolluppsättningen Webbdelar, som alla ärver från basklassen WebZone .

WebPartZoneBase Zoner. Dessa innehåller WebPart (och andra server- och användarkontroller) och utgör det primära användargränssnittet för webbsidor som användarna interagerar med för det mesta.
ToolZone Zoner. Dessa zoner innehåller särskilda vyer av en webbdelssida som gör det möjligt för användare att ändra (anpassa) innehåll, layout, utseende, beteende och egenskaper för kontroller som finns i WebPartZoneBase zoner på en webbdelssida. Till exempel är en CatalogZoneBase zon en ToolZone som ger en katalogvy över en sida, vilket gör det möjligt för användare att lägga till och ta bort serverkontroller. En EditorZoneBase zon är en annan typ av ToolZone som ger en redigeringsvy av en sida, så att användarna kan ändra och redigera sidans layout, tillsammans med kontrollernas egenskaper, utseende och beteende.

Varje zon i kontrolluppsättningen webbdelar är utformad för att innehålla en motsvarande typ av kontroll som härleds från Part klassen, där delkontrollerna fungerar som huvudinnehåll och primärt användargränssnitt för zonen. Zontyper i kontrolluppsättningen webbdelar, tillsammans med motsvarande typer av delkontroller som de innehåller, visas i följande tabell.

Typ av delkontroll	Zontyp
WebPart (och server- och användarkontroller, som omsluts med en GenericWebPart vid körning)	WebPartZone (basklassen är WebPartZoneBase )
EditorPart (Flera härledda kontroller tillhandahålls med kontrolluppsättningen webbdelar och anpassade EditorPart kontroller kan utvecklas)	EditorZone (basklassen är EditorZoneBase )
CatalogPart (Flera härledda kontroller tillhandahålls med kontrolluppsättningen webbdelar och anpassade CatalogPart kontroller kan utvecklas)	CatalogZone (basklassen är CatalogZoneBase )
WebPartConnection (anslutningskontroller är unika eftersom de inte är delkontroller som ärver från basklassen)	ConnectionsZone (ärver direkt från ToolZone )

Alla zoner i webbdelskontrollen har grundläggande, vanliga användargränssnittselement som de ärver från basklassen WebZone . Alla dessa element är inte synliga i varje zon, men varje zontyp kan ha dessa vanliga, zonrelaterade gränssnittselement enligt beskrivningen i följande tabell.

Zonavsnitt	Description
Sidhuvud	Den övre delen av en zon. Den innehåller rubriktext, som kan innehålla en rubrik för zonen. formatattribut (till exempel en kantlinje eller bakgrundsfärg) som särskiljer rubriken. och verb på zonnivå (representeras av knappar, hyperlänkar eller bilder) som användarna kan klicka på för att utföra användargränssnittsåtgärder som gäller för hela zonen, till exempel att stänga en zon. Flera WebZone egenskaper, till exempel HasHeader, HeaderStyleoch HeaderText, relaterar till rubrikområdet i en zon. Om det finns verb på zonnivå i zonen VerbButtonType gäller egenskaperna och VerbStyle för dem. Observera att dessa två verbegenskaper endast gäller för verb på zonnivå, inte verb i de enskilda delkontrollerna som finns i zonen. Rubriker finns inte i alla typer av zoner. Vanligtvis visas de i ToolZone zoner där det finns ett behov av att ha ett gemensamt rubrikområde med text och ett verb, till exempel ett nära verb.
Brödtext	Huvudinnehållsavsnittet i en zon. Varje zon som härleds från WebZone har ett brödtextavsnitt. För alla typer av zoner i webbdelskontrolluppsättningen innehåller brödtexten i zonen den avsedda typen av Part kontroller (eller andra serverkontroller) som motsvarar en zontyp, som anges i föregående tabell. Olika medlemmar i WebZone klassen påverkar innehållet i brödtextavsnittet, till exempel BackImageUrlegenskaperna , PartChromeStyle, PartChromeTypeoch PartStyle . Om brödtextavsnittet är tomt kan meddelandet EmptyZoneText visas i vissa situationer.
Krom	De vanliga gränssnittselementen som återges för varje delkontroll i en zon. Detta skiljer sig från en diskussion om formatattribut som gäller för själva zonen. chrome gäller specifikt för de inneslutna delkontrollerna. Chrome innehåller verb, kantlinjer och andra formatattribut, till exempel bakgrundsfärg eller teckensnittsformat för rubriktexten, för en zons delkontroller. En zon bestämmer krominformationen med hjälp av ett enda kromobjekt som är lämpligt för den typ av delkontroller som den innehåller (till exempel ett CatalogPartChrome objekt för ett CatalogZone objekt som innehåller CatalogPart kontroller). Det här enkla kromobjektet hanterar kromdetaljerna och återgivningen för alla delkontroller i zonen. Detta gör det möjligt för utvecklare att skapa zoner där de kan ange ett konsekvent, gemensamt utseende för alla delkontroller. Vissa egenskaper som är relaterade till chrome för en zons delkontroller inkluderar PartChromeStyleegenskaperna , PartChromeType, PartStyleoch PartTitleStyle . Observera att de flesta chrome-relaterade egenskaper, inklusive en specifik egenskap som refererar till kromobjektet för en viss typ av zon, inte implementeras i basklassen WebZone . I stället implementeras de flesta chrome-specifika funktioner i zoner på specifika zontyper efter de unika behoven i deras delkontroller. Se avsnitten för varje zontyp som anges i föregående tabell i det här avsnittet.
Delkontroller	De kontroller som finns i brödtextavsnittet i en zon. Varje zon som ärver från WebZone klassen innehåller i sitt brödtextavsnitt en eller flera delkontroller av motsvarande typ, som du ser i föregående tabell i det här avsnittet. Dessa delkontroller utgör huvudgränssnittet för webbdelsprogram. De flesta zontyper som härleds från WebZone har en samlingsegenskap som gör att de kan referera till alla sina inneslutna delkontroller, till exempel WebParts egenskapen för WebPartZoneBase klassen och EditorParts egenskapen i EditorZoneBase klassen.
Sidfot	Den nedre delen av en zon. Precis som rubrikavsnittet finns den inte i alla typer av zoner, men förekommer vanligtvis i ToolZone zoner. Typiskt innehåll i ett sidfotsavsnitt är verb, till exempel ett ok verb eller ett tillämpat verb, som visas i sidfoten för EditorZoneBase zoner. Vissa egenskaper som är relaterade till sidfotsavsnittet HasFooterär egenskaperna , FooterStyle, VerbButtonTypeoch VerbStyle .

De flesta av WebZone klassens egenskaper beskrivs i föregående tabell som beskriver de vanliga gränssnittselementen i zoner. Klassen WebZone har också flera metoder som relaterar till dess roll för rendering av innehåll. Metoderna RenderBody, RenderContents, RenderFooteroch RenderHeader kan åsidosättas för att ge programmatisk kontroll över återgivningen av varje specifikt avsnitt i en zon. Om du till exempel vill anpassa återgivningen av alla sidfotsavsnitt i katalogzoner i ditt program kan du ärva från CatalogZoneBase klassen, åsidosätta metoden RenderFooter som ärvts från WebZoneoch ändra återgivningen av sidfotsavsnittet.

Anteckningar till implementerare

Du behöver sällan ärva direkt från WebZone klassen för att utveckla anpassade webbdelszoner. Kontrolluppsättningen Webbdelar innehåller de specialiserade zoner som anges ovan i avsnittet Kommentarer, och vanligtvis kan du härleda från en av dem för att lägga till anpassat beteende i en zon. Om du bestämmer dig för att ärva direkt från WebZone klassen måste du åsidosätta ett antal egenskaper och metoder (se dokumentationen för medlemmarna i WebZone klassen). Du måste också skapa en anpassad WebPartManager kontroll, alternativt en anpassad WebPartDisplayMode kontroll för att skapa ett unikt visningsläge där du kan visa din zon och andra anpassningar för att få din zon att fungera inom webbdelskontrolluppsättningen.

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 Page UserControl 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 till en bakgrundsbild för en zon.
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)
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 representerar de underordnade kontrollerna i en CompositeControl. (Ärvd från CompositeControl)
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)
DesignMode	Hämtar ett värde som anger om en kontroll används på en designyta. (Ärvd från Control)
EmptyZoneText	Hämtar eller anger ett meddelande som visas när en zon inte innehåller några kontroller.
EmptyZoneTextStyle	Hämtar formatattributen för platshållartexten i en tom zon.
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)
ErrorStyle	Hämtar formatattributen för att återge felmeddelandet som visas om en WebPart kontroll inte kan läsas in eller skapas.
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)
FooterStyle	Hämtar formatattributen för innehållet i en zons sidfotsområde.
ForeColor	Hämtar eller anger förgrundsfärgen (vanligtvis textens färg) för webbserverkontrollen. (Ärvd från WebControl)
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)
HasFooter	Hämtar ett värde som anger om en zon har ett sidfotsområde.
HasHeader	Hämtar ett värde som anger om en zon har ett rubrikområde.
HeaderStyle	Hämtar formatattributen för innehållet i en zons rubrikområde.
HeaderText	Hämtar eller anger texten för rubrikområdet i en zon.
Height	Hämtar eller anger höjden på webbserverkontrollen. (Ärvd från WebControl)
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)
Padding	Hämtar eller anger cellutfyllnadsattributen i tabellen som innehåller WebPart kontrollerna i en zon.
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)
PartChromePadding	Hämtar eller anger avståndet mellan innehållet i en WebPart kontroll och kontrollens kantlinje.
PartChromeStyle	Hämtar formategenskaper som gäller för kantlinjerna för webbdelskontroller som finns i en zon.
PartChromeType	Hämtar eller anger den typ av kantlinje som ramar in webbdelskontroller som finns i en zon.
PartStyle	Hämtar formategenskaper som gäller för kantlinjen och innehållet i varje webbdelskontroll som finns i en zon.
PartTitleStyle	Hämtar formatattribut för namnlistinnehållet för varje webbdelskontroll som finns i en zon.
RenderClientScript	Hämtar ett värde som anger om klientskriptet ska återges på en webbdelssida.
RenderingCompatibility	Hämtar ett värde som anger den ASP.NET version som renderad HTML kommer att vara kompatibel med. (Ärvd från Control)
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 `disabled` attributet för det renderade HTML-elementet till "inaktiverat" när kontrollens IsEnabled egenskap är `false`. (Ärvd från CompositeControl)
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.
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)
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)
VerbButtonType	Hämtar eller anger vilken typ av knapp som används för att representera verb i en zon.
VerbStyle	Hämtar formatattributen för användargränssnittsverb (UI) som är associerade med webbdelskontroller i en zon.
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)
WebPartManager	Hämtar en referens till kontrollen WebPartManager som är associerad med en WebZone kontrollinstans på en webbdelssida.
Width	Hämtar eller anger bredden på webbserverkontrollen. (Ärvd från WebControl)

Metoder

Name	Description
AddAttributesToRender(HtmlTextWriter)	Lägger till HTML-attribut och formatmallar som måste återges till den angivna HtmlTextWriterTag. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
AddedControl(Control, Int32)	Anropas efter att en underordnad kontroll har lagts till i Controls Control 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 `null`. (Ärvd från Control)
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 formatobjektet som används internt av WebControl klassen för att implementera alla formatrelaterade egenskaper. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
DataBind()	Binder en datakälla till CompositeControl och alla dess underordnade kontroller. (Ärvd från CompositeControl)
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 `id` och ett heltal som anges i parametern `pathOffset` , vilket underlättar sökningen. Du bör inte åsidosätta den här versionen av FindControl metoden. (Ärvd från Control)
FindControl(String)	Söker i den aktuella namngivningscontainern efter en serverkontroll med den angivna `id` parametern. (Ärvd från Control)
Focus()	Anger indatafokus till en kontroll. (Ärvd från Control)
GetDesignModeState()	Hämtar designtidsdata för en kontroll. (Ärvd från Control)
GetEffectiveChromeType(Part)	Returnerar det faktiska eller effektiva aktuella PartChromeType värdet för en WebPart kontroll, med tanke på PartChromeType zonens egenskap och det aktuella visningsläget för webbsidan.
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)	Läser in tidigare sparad tillståndsinformation för en zon.
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 .
OnLoad(EventArgs)	Genererar händelsen Load . (Ärvd från Control)
OnPreRender(EventArgs)	Genererar händelsen PreRender .
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)
RecreateChildControls()	Återskapar de underordnade kontrollerna i en kontroll som härleds från CompositeControl. (Ärvd från CompositeControl)
RemovedControl(Control)	Anropas efter att en underordnad Controls kontroll har tagits bort från objektets Control samling. (Ärvd från Control)
Render(HtmlTextWriter)	Skriver innehållet CompositeControl till det angivna HtmlTextWriter objektet för visning på klienten. (Ärvd från CompositeControl)
RenderBeginTag(HtmlTextWriter)	Renderar den inledande HTML-taggen för zonkontrollen till det angivna HtmlTextWriter objektet.
RenderBody(HtmlTextWriter)	Åsidosätter rendering för brödtexten i en zonkontroll.
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 hela innehållet i en zonkontroll mellan start- och sluttaggar till det angivna HtmlTextWriter objektet.
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 kontrollen till den angivna skrivaren. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
RenderFooter(HtmlTextWriter)	Åsidosätter rendering för sidfoten för en zonkontroll.
RenderHeader(HtmlTextWriter)	Åsidosätter rendering för huvudet på en zonkontroll.
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 ändringar i visningstillståndet som har inträffat efter att en sida har publicerats tillbaka till servern.
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()	Spårar ändringar i zonkontrollens visningstillstånd.

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 en designer kan återskapa den sammansatta kontrollens samling underordnade kontroller i designmiljön. (Ärvd från CompositeControl)
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.

Gäller för

Se även

Feedback

Var den här sidan till hjälp?