EditorZone Klass

Definition

Namnområde:
System.Web.UI.WebControls.WebParts
Sammansättning:
System.Web.dll

Fungerar som den primära kontrollen i webbdelskontrolluppsättningen för värdkontroller EditorPart på en webbsida.

public ref class EditorZone : System::Web::UI::WebControls::WebParts::EditorZoneBase
public class EditorZone : System.Web.UI.WebControls.WebParts.EditorZoneBase
type EditorZone = class
    inherit EditorZoneBase
Public Class EditorZone
Inherits EditorZoneBase
Arv
Object
Control
WebControl
CompositeControl
WebZone
ToolZone
EditorZoneBase
EditorZone

Exempel

I följande kodexempel visas flera deklarativa och programmatiska användningsområden för EditorZone klassen. Exemplet skapar en anpassad redigeringszon som ärver från EditorZone klassen och använder den på en webbdelssida.

Kodexemplet har tre delar:

  • En användarkontroll som gör att du kan ändra visningslägen på webbsidan.

  • En webbsida som refererar till den anpassade EditorZone kontrollen.

  • En förklaring av hur exemplet fungerar.

Den första delen av det här kodexemplet är användarkontrollen som gör det möjligt för användare att ändra visningslägen på en webbsida. Mer information om visningslägen och en beskrivning av källkoden i den här kontrollen finns i Genomgång: Ändra visningslägen på en webbdelssida.

<%@ control language="C#" classname="DisplayModeMenuCS"%>

<script runat="server">
  
 // Use a field to reference the current WebPartManager.
  WebPartManager _manager;

  void Page_Init(object sender, EventArgs e)
  {
    Page.InitComplete += new EventHandler(InitComplete);
  }  

  void InitComplete(object sender, System.EventArgs e)
  {
    _manager = WebPartManager.GetCurrentWebPartManager(Page);

    String browseModeName = WebPartManager.BrowseDisplayMode.Name;

    // Fill the dropdown with the names of supported display modes.
    foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
    {
      String modeName = mode.Name;
      // Make sure a mode is enabled before adding it.
      if (mode.IsEnabled(_manager))
      {
        ListItem item = new ListItem(modeName + " Mode", modeName);
        DisplayModeDropdown.Items.Add(item);
      }
    }

  }
 
  // Change the page to the selected display mode.
  void DisplayModeDropdown_SelectedIndexChanged(object sender, 
    EventArgs e)
  {
    String selectedMode = DisplayModeDropdown.SelectedValue;

    WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
    if (mode != null)
      _manager.DisplayMode = mode;

  }

  void Page_PreRender(object sender, EventArgs e)
  {
    DisplayModeDropdown.SelectedValue = _manager.DisplayMode.Name;
  }
  
</script>
<div>
  <asp:DropDownList ID="DisplayModeDropdown" 
    runat="server"  
    AutoPostBack="true" 
    OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
</div>

<%@ control language="vb" classname="DisplayModeMenuVB"%>

<script runat="server">
  
' Use a field to reference the current WebPartManager.
Dim _manager As WebPartManager


Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs) 
    AddHandler Page.InitComplete, AddressOf InitComplete

End Sub 


Sub InitComplete(ByVal sender As Object, ByVal e As System.EventArgs) 
    _manager = WebPartManager.GetCurrentWebPartManager(Page)
    
    Dim browseModeName As String = WebPartManager.BrowseDisplayMode.Name
    
    ' Fill the dropdown with the names of supported display modes.
    Dim mode As WebPartDisplayMode
    For Each mode In  _manager.SupportedDisplayModes
        Dim modeName As String = mode.Name
        ' Make sure a mode is enabled before adding it.
        If mode.IsEnabled(_manager) Then
            Dim item As New ListItem(modeName + " Mode", modeName)
            DisplayModeDropdown.Items.Add(item)
        End If
    Next mode

End Sub 
 

' Change the page to the selected display mode.
Sub DisplayModeDropdown_SelectedIndexChanged(ByVal sender As Object, ByVal e As EventArgs) 
    Dim selectedMode As String = DisplayModeDropdown.SelectedValue
    
    Dim mode As WebPartDisplayMode = _manager.SupportedDisplayModes(selectedMode)
    If Not (mode Is Nothing) Then
        _manager.DisplayMode = mode
    End If
 
End Sub 


Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs) 
    DisplayModeDropdown.SelectedValue = _manager.DisplayMode.Name

End Sub 

</script>
<div>
  <asp:DropDownList ID="DisplayModeDropdown" 
    runat="server"  
    AutoPostBack="true" 
    OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
</div>

Den andra delen av kodexemplet är en webbsida. Längst upp på sidan finns ett Register direktiv för användarkontrollen. Taggen för användarkontroll deklareras på sidan med ett uc1: prefix för elementet. Observera att under elementet <asp:WebPartZone> finns ett <asp:EditorZone> element som innehåller flera EditorPart kontroller, med vissa taggar och egenskaper inställda för att fastställa dess utseende och beteende. Det finns också ett antal metoder som har åtkomst till olika medlemmar i EditorZone kontrollen programmatiskt.

<%@ Page Language="C#" %>
<%@ register tagprefix="uc1" 
  tagname="DisplayModeMenuCS" 
  src="displaymodecs.ascx" %>
  
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  // <snippet3>

  void Button1_Click(object sender, EventArgs e)
  {
    if (EditorZone1.ApplyVerb.Enabled)
      EditorZone1.ApplyVerb.Enabled = false;
    else
      EditorZone1.ApplyVerb.Enabled = true;
  }

  void Button2_Click(object sender, EventArgs e)
  {
    EditorZone1.BorderWidth = 2;
    EditorZone1.BorderColor = System.Drawing.Color.DarkBlue;
  }

  void Button3_Click(object sender, EventArgs e)
  {
    Label1.Text = "<br />";
    foreach (EditorPart part in EditorZone1.EditorParts)
    {
      Label1.Text += part.ID + "<br />";
    }
  }

  void Button4_Click(object sender, EventArgs e)
  {
    EditorZone1.InstructionText = "My custom instruction text.";
  }
  // </snippet3>
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
  <title>EditorZoneBase Examples</title>
</head>
<body>
  <form id="form1" runat="server">
    <asp:WebPartManager ID="mgr" runat="server" />
    <uc1:DisplayModeMenuCS runat="server" id="displaymodemenu1" />
    <asp:WebPartZone ID="WebPartZone1" runat="server">
      <ZoneTemplate>
        <asp:BulletedList 
          ID="BulletedList1" 
          Runat="server"
          DisplayMode="HyperLink" 
          Title="Favorite Links" >
          <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:Calendar ID="Calendar1" Runat="server" 
          Title="My Calendar" />
      </ZoneTemplate>
    </asp:WebPartZone>
    <asp:EditorZone ID="EditorZone1" runat="server" >
      <VerbStyle Font-Italic="true" />
      <EditUIStyle BackColor="lightgray" />
      <PartChromeStyle BorderWidth="1" />
      <LabelStyle Font-Bold="true" />
      <CancelVerb Text="Cancel Changes" />
      <ZoneTemplate>
        <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
          runat="server" />
        <asp:LayoutEditorPart ID="LayoutEditorPart1" 
          runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <hr />
    <asp:Button ID="Button1" runat="server" Width="200"
      Text="Enable or Disable Apply" OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" runat="server" Width="200"
      Text="Set Zone BorderColor" OnClick="Button2_Click" />
    <br />
    <asp:Button ID="Button3" runat="server" Width="200"
      Text="Display EditorPart Collection" OnClick="Button3_Click" />
    <asp:Label ID="Label1" runat="server" />
    <br />
    <asp:Button ID="Button4" runat="server" Width="200"
      Text="Set Instruction Text" OnClick="Button4_Click" /> 
  </form>
</body>
</html>

<%@ Page Language="vb" %>
<%@ register tagprefix="uc1" 
  tagname="DisplayModeMenuVB" 
  src="displaymodevb.ascx" %>
  
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  ' <snippet3>

  Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)
    If EditorZone1.ApplyVerb.Enabled = True Then
      EditorZone1.ApplyVerb.Enabled = False
    Else
      EditorZone1.ApplyVerb.Enabled = True
    End If
  End Sub
 
  Sub Button2_Click(ByVal sender As Object, ByVal e As EventArgs)
    EditorZone1.BorderWidth = 2
    EditorZone1.BorderColor = System.Drawing.Color.DarkBlue
  End Sub

  Sub Button3_Click(ByVal sender As Object, ByVal e As EventArgs)
    Label1.Text = "<br />"
    Dim part As EditorPart
    For Each part In EditorZone1.EditorParts
      Label1.Text += part.ID + "<br />"
    Next part
  End Sub

  Sub Button4_Click(ByVal sender As Object, ByVal e As EventArgs)
    EditorZone1.InstructionText = "My custom instruction text."
  End Sub
  ' </snippet3>
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
  <title>EditorZoneBase Examples</title>
</head>
<body>
  <form id="form1" runat="server">
    <asp:WebPartManager ID="mgr" runat="server" />
    <uc1:DisplayModeMenuVB runat="server" id="displaymodemenu1" />
    <asp:WebPartZone ID="WebPartZone1" runat="server">
      <ZoneTemplate>
        <asp:BulletedList 
          ID="BulletedList1" 
          Runat="server"
          DisplayMode="HyperLink" 
          Title="Favorite Links" >
          <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:Calendar ID="Calendar1" Runat="server" 
          Title="My Calendar" />
      </ZoneTemplate>
    </asp:WebPartZone>
    <asp:EditorZone ID="EditorZone1" runat="server" >
      <VerbStyle Font-Italic="true" />
      <EditUIStyle BackColor="lightgray" />
      <PartChromeStyle BorderWidth="1" />
      <LabelStyle Font-Bold="true" />
      <CancelVerb Text="Cancel Changes" />
      <ZoneTemplate>
        <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
          runat="server" />
        <asp:LayoutEditorPart ID="LayoutEditorPart1" 
          runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <hr />
    <asp:Button ID="Button1" runat="server" Width="200"
      Text="Enable or Disable Apply" OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" runat="server" Width="200"
      Text="Set Zone BorderColor" OnClick="Button2_Click" />
    <br />
    <asp:Button ID="Button3" runat="server" Width="200"
      Text="Display EditorPart Collection" OnClick="Button3_Click" />
    <asp:Label ID="Label1" runat="server" />
    <br />
    <asp:Button ID="Button4" runat="server" Width="200"
      Text="Set Instruction Text" OnClick="Button4_Click" /> 
  </form>
</body>
</html>

När du läser in sidan i en webbläsare kan du välja Redigera läge i listrutan för att växla till redigeringsläge. Om du vill visa redigeringsgränssnittet kan du klicka på verbmenyn (nedåtpilen) i namnlisten för en av de två kontrollerna och klicka på Redigera för att redigera kontrollen. När redigeringsgränssnittet är synligt kan du se effekterna av klassmedlemmarnas deklarativa och programmatiska användning EditorZone .

Kommentarer

I kontrolluppsättningen Webbdelar är en zon en sammansatt kontroll som täcker en definierad region på en webbsida och innehåller serverkontroller. De primära funktionerna i en zon är att lägga ut de kontroller som den innehåller och att tillhandahålla ett gemensamt användargränssnitt (UI) för dessa kontroller. Allmän information om zoner och hur de används i webbdelsprogram finns i referensdokumentationen för basklassen WebZone och Översikt över kontrolluppsättning för webbdelar.

Kontrollen EditorZone är en av de grundläggande kontrollerna i kontrolluppsättningen webbdelar. En viktig funktion i webbdelar är slutanvändarnas möjlighet att ändra (eller anpassa) webbsidor enligt deras inställningar och spara sina anpassade inställningar för framtida webbläsarsessioner. En aspekt av att ändra webbsidor innehåller redigering. användare kan redigera utseende, layout, beteende och andra egenskaper för de synliga WebPart kontrollerna. Flera kontroller i kontrolluppsättningen webbdelar innehåller redigeringsfunktionerna, inklusive EditorZone kontrollen.

En EditorZone kontroll blir synlig när en webbdelssida går in i redigeringsläge och gör olika EditorPart kontroller tillgängliga som kan användas för att anpassa WebPart kontroller. Kontrollen EditorZone liknar den överordnade EditorZoneBase klassen, med en viktig skillnad: Kontrollen EditorZone tillhandahåller en zonmall som refereras till i dess ZoneTemplate egenskap. Zonmallen lägger till möjligheten att deklarera innehåll i sidpersistensformatet. Sidutvecklare kan placera en EditorZone kontroll i den deklarativa markeringen för en webbsida, lägga till ett underordnat <zonetemplate> element och i elementet <zonetemplate> lägga till deklarativa referenser till EditorPart kontroller.

Kontrollen EditorZone har också en metod, CreateEditorParts, som åsidosätter en basmetod i EditorZoneBase klassen. Den här metoden är nödvändig så att en EditorZone kontroll kan skapa zonmallen så att den innehåller alla EditorPart kontroller som läggs till i zonen deklarativt.

Note

Knapparna i användargränssnittet EditorZone kräver skript på klientsidan för att fungera korrekt. Om skript är inaktiverat i webbläsaren kan användaren inte utföra åtgärder via användargränssnittet EditorZone .

Tillgänglighet

Pålägget som återges som standard för den här kontrollen kanske inte överensstämmer med tillgänglighetsstandarder som riktlinjerna för webbinnehållstillgänglighet 1.0 (WCAG) prioritet 1. Mer information om hjälpmedelsstöd för den här kontrollen finns i ASP.NET Controls and Accessibility.

Anteckningar till arvingar

Om du vill skapa en anpassad EditorZone zon för att få större kontroll över återgivningen av redigeringsgränssnittet kan du ärva direkt från EditorZoneBase klassen, så länge du inte behöver tillhandahålla stöd för zonmallar för sidutvecklare för att lägga EditorPart till kontroller i zonen deklarativt. I så fall lägger du till alla EditorPart kontroller i en zon programmatiskt. Om du vill tillhandahålla stöd för zonmallar bör du ärva från EditorZone klassen.

Konstruktorer

Name Description
EditorZone()

Initierar en ny instans av EditorZone klassen.

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)
ApplyVerb

Hämtar en referens till ett WebPartVerb objekt som gör det möjligt för slutanvändare att tillämpa redigeringsändringar på en kontroll i redigeringsläge.

(Ärvd från EditorZoneBase)
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)
AssociatedDisplayModes

Hämtar samlingen med WebPartDisplayMode objekt som är associerade med en viss ToolZone zon.

(Ärvd från ToolZone)
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.

(Ärvd från WebZone)
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)
CancelVerb

Hämtar en referens till ett WebPartVerb objekt som gör det möjligt för slutanvändare att avbryta redigering av ändringar i en kontroll i redigeringsläge.

(Ärvd från EditorZoneBase)
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)
Display

Hämtar ett värde som anger om en ToolZone kontroll visas för närvarande.

(Ärvd från EditorZoneBase)
EditorPartChrome

Hämtar en referens till instansen av klassen som EditorPartChrome är associerad med EditorZoneBase zonen.

(Ärvd från EditorZoneBase)
EditorParts

Hämtar en samling av alla EditorPart kontroller som finns i en EditorZoneBase zon.

(Ärvd från EditorZoneBase)
EditUIStyle

Hämtar formatattributen för de redigerbara kontrollerna som finns i en ToolZone kontroll.

(Ärvd från ToolZone)
EmptyZoneText

Hämtar eller anger ett meddelande som visas när en zon inte innehåller några kontroller.

(Ärvd från EditorZoneBase)
EmptyZoneTextStyle

Hämtar formatattributen för platshållartexten i en tom zon.

(Ärvd från WebZone)
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.

(Ärvd från WebZone)
ErrorText

Hämtar eller anger texten i ett felmeddelande på zonnivå som ska visas överst i användargränssnittet för redigering.

(Ärvd från EditorZoneBase)
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.

(Ärvd från WebZone)
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.

(Ärvd från WebZone)
HasHeader

Hämtar ett värde som anger om en zon har ett rubrikområde.

(Ärvd från WebZone)
HeaderCloseVerb

Hämtar en referens till WebPartVerb objektet i huvudet på en ToolZone kontroll som används för att stänga kontrollen.

(Ärvd från ToolZone)
HeaderStyle

Hämtar formatattributen för innehållet i en zons rubrikområde.

(Ärvd från WebZone)
HeaderText

Hämtar eller anger texten för rubrikområdet i en zon.

(Ärvd från EditorZoneBase)
HeaderVerbStyle

Hämtar formatattributen för alla sidhuvudverb som visas i en ToolZone kontroll.

(Ärvd från ToolZone)
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)
InstructionText

Hämtar eller anger texten i en ToolZone kontroll som ger anvisningar för slutanvändare.

(Ärvd från EditorZoneBase)
InstructionTextStyle

Hämtar formatattributen för instruktionstexten som visas överst i en ToolZone kontroll.

(Ärvd från ToolZone)
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)
LabelStyle

Hämtar formatattributen för innehållet i etiketterna som visas tillsammans med redigeringskontrollerna i en ToolZone kontroll. De härledda ToolZone kontrollerna, till exempel CatalogZone och EditorZone, använder formatmallarna på etiketterna.

(Ärvd från ToolZone)
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)
OKVerb

Hämtar en referens till ett WebPartVerb objekt som tillämpar redigeringsändringar på en kontroll i redigeringsläge och döljer användargränssnittet (UI).

(Ärvd från EditorZoneBase)
Padding

Hämtar eller anger cellutfyllnadsattributen i tabellen som innehåller WebPart kontrollerna i en zon.

(Ärvd från WebZone)
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.

(Ärvd från WebZone)
PartChromeStyle

Hämtar formategenskaper som gäller för kantlinjerna för webbdelskontroller som finns i en zon.

(Ärvd från WebZone)
PartChromeType

Hämtar eller anger den typ av kantlinje som ramar in webbdelskontroller som finns i en zon.

(Ärvd från WebZone)
PartStyle

Hämtar formategenskaper som gäller för kantlinjen och innehållet i varje webbdelskontroll som finns i en zon.

(Ärvd från WebZone)
PartTitleStyle

Hämtar formatattribut för namnlistinnehållet för varje webbdelskontroll som finns i en zon.

(Ärvd från WebZone)
RenderClientScript

Hämtar ett värde som anger om klientskriptet ska återges på en webbdelssida.

(Ärvd från WebZone)
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.

(Ärvd från WebZone)
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.

(Ärvd från WebZone)
VerbStyle

Hämtar formatattributen för användargränssnittsverb (UI) som är associerade med webbdelskontroller i en zon.

(Ärvd från WebZone)
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 ett användargränssnittselement på sidan.

(Ärvd från ToolZone)
WebPartManager

Hämtar en referens till kontrollen WebPartManager som är associerad med en WebZone kontrollinstans på en webbdelssida.

(Ärvd från WebZone)
WebPartToEdit

Hämtar en referens till den WebPart kontroll som för närvarande redigeras.

(Ärvd från EditorZoneBase)
Width

Hämtar eller anger bredden på webbserverkontrollen.

(Ärvd från WebControl)
ZoneTemplate

Innehåller en mall som innehåller underordnade kontroller i en EditorZone kontroll i sidpersistenceformat.

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 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 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)
Close()

Den här metoden anropas när en användare klickar på ett nära verb i rubriken i en zon och avslutar processen med att redigera WebPart kontroller och returnerar en webbdelssidas visningsläge för att bläddra.

(Ärvd från EditorZoneBase)
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()

Skapar den uppsättning underordnade kontroller som är associerade med en EditorZoneBase zon.

(Ärvd från EditorZoneBase)
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)
CreateEditorPartChrome()

Hämtar en referens till ett nytt EditorPartChrome objekt som används för att återge gränssnittselementen runt en EditorZoneBase zon.

(Ärvd från EditorZoneBase)
CreateEditorParts()

Skapar alla kontroller som deklarerats EditorPart i en zonmall i sidpersistenceformat.
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.

(Ärvd från WebZone)
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)
InvalidateEditorParts()

Anger samlingen med EditorPart kontroller som är associerade med en EditorZoneBase zon till null, vilket resulterar i att CreateEditorParts() metoden anropas för att återskapa samlingen.

(Ärvd från EditorZoneBase)
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.

(Ärvd från EditorZoneBase)
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)
OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)

Genererar DisplayModeChanged händelsen och förstör alla EditorPart och underordnade kontroller i zonen inför en webbsida för att ange eller avsluta redigeringsvisningsläget.

(Ärvd från EditorZoneBase)
OnInit(EventArgs)

Skapar specialiserade händelsehanterare som används av WebPartManager kontrollen på en webbsida.

(Ärvd från ToolZone)
OnLoad(EventArgs)

Genererar händelsen Load .

(Ärvd från Control)
OnPreRender(EventArgs)

Genererar händelsen PreRender och anropar PerformPreRender() metoden för kontrollernas EditorPart kromelement.

(Ärvd från EditorZoneBase)
OnSelectedWebPartChanged(Object, WebPartEventArgs)

Genererar SelectedWebPartChanged händelsen och anger EditorParts samlingen till null i zonen som förberedelse för att en WebPart kontroll ska gå in i eller avsluta redigeringsläget.

(Ärvd från EditorZoneBase)
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)
RaisePostBackEvent(String)

Utför de åtgärder som är associerade med ett av zonverberna eller genererar en händelse som skickas tillbaka till servern.

(Ärvd från EditorZoneBase)
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)

Renderar zonen till det angivna HtmlTextWriter objektet.

(Ärvd från EditorZoneBase)
RenderBeginTag(HtmlTextWriter)

Renderar den inledande HTML-taggen för zonkontrollen till det angivna HtmlTextWriter objektet.

(Ärvd från WebZone)
RenderBody(HtmlTextWriter)

Åsidosätter basmetoden för att återge brödtextområdet i en zon som härleds EditorZoneBase från klassen.

(Ärvd från EditorZoneBase)
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.

(Ärvd från WebZone)
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 basmetoden för att återge verb i sidfoten för en ToolZone kontroll.

(Ärvd från ToolZone)
RenderHeader(HtmlTextWriter)

Åsidosätter basmetoden för att tillhandahålla specialiserad återgivning för det rubrikområde som krävs av ToolZone kontroller.

(Ärvd från ToolZone)
RenderVerb(HtmlTextWriter, WebPartVerb)

Renderar ett enskilt verb med en ToolZone kontroll.

(Ärvd från ToolZone)
RenderVerbs(HtmlTextWriter)

Renderar verben som gäller på zonnivå.

(Ärvd från EditorZoneBase)
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.

(Ärvd från EditorZoneBase)
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.

(Ärvd från EditorZoneBase)

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)
IPostBackEventHandler.RaisePostBackEvent(String)

Implementerar RaisePostBackEvent(String) metoden.

(Ärvd från ToolZone)

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