WebPart 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 anpassade ASP.NET webbdelar-kontroller, och lägger till några ytterligare användargränssnittsegenskaper (UI) i basklassen Part, samt möjligheten att skapa anslutningar och anpassningsbeteende.

public ref class WebPart abstract : System::Web::UI::WebControls::WebParts::Part, System::Web::UI::WebControls::WebParts::IWebActionable, System::Web::UI::WebControls::WebParts::IWebEditable, System::Web::UI::WebControls::WebParts::IWebPart

public abstract class WebPart : System.Web.UI.WebControls.WebParts.Part, System.Web.UI.WebControls.WebParts.IWebActionable, System.Web.UI.WebControls.WebParts.IWebEditable, System.Web.UI.WebControls.WebParts.IWebPart

type WebPart = class
    inherit Part
    interface IWebPart
    interface IWebActionable
    interface IWebEditable

Public MustInherit Class WebPart
Inherits Part
Implements IWebActionable, IWebEditable, IWebPart

Arv: Object

Control

WebControl

Panel

Part
WebPart

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

System.Web.UI.WebControls.WebParts.ProxyWebPart

Implementeringar: IWebActionable IWebEditable IWebPart

Exempel

Följande kodexempel visar hur du skapar en WebPart kontroll och refererar till den på en webbsida.

Den första delen av exemplet innehåller koden för en anpassad WebPart kontroll med namnet TextDisplayWebPart. Den här kontrollen visar hur du skapar en enkel anpassad WebPart kontroll som ger dig åtkomst till funktionerna i kontrolluppsättningen webbdelar. 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. Det här kodexemplet förutsätter att du kompilerar källkoden till en sammansättning, placerar den i en undermapp för bin i webbprogrammet och refererar till sammansättningen med ett Register direktiv på webbsidan. 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 TextDisplayWebPart : WebPart
  {
    private String _contentText = null;
    TextBox input;
    Label DisplayContent;

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

    [Personalizable(), 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))
      {
        _contentText = input.Text + @"<br />";
        input.Text = String.Empty;
        DisplayContent.Text = this.ContentText;
      }
    }
  }
}

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 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
            _contentText = input.Text & "<br />"
            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 kontrollen TextDisplayWebPart på en ASP.NET webbsida. Observera att många av de olika WebPart egenskaperna kan tilldelas deklarativt till den anpassade kontrollen.

<%@ 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"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc" />
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" />
        </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"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc" />
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" />
        </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>

Kommentarer

När du skapar kontroller med webbdelsfunktioner har du två grundläggande alternativ. Du kan skapa anpassade kontroller som härleds WebPart från klassen, eller så kan du skapa eller använda andra serverkontroller. Befintliga ASP.NET kontroller, anpassade serverkontroller och användarkontroller kan alla ges fullständiga webbdelsfunktioner genom att deklarera dem i (eller lägga till dem programmatiskt till) en WebPartZone zonkontroll, vilket resulterar i att de omsluts med GenericWebPart objekt vid körning och behandlas som sanna WebPart kontroller. Mer information finns i dokumentationen GenericWebPart för klassen. För snabb utveckling och maximal återanvändning av kod kan det vara ett bra alternativ att använda befintliga serverkontroller. För maximal programmatisk kontroll över funktionerna för beteende och webbdelar i kontroller är det ofta det bästa alternativet att skapa en anpassad kontroll som ärver från WebPart klassen.

Den abstrakta WebPart klassen ärver från baskontrollen Part och tillhandahåller de grundläggande elementen för alla WebPart kontroller. Klassen innehåller en gemensam uppsättning egenskaper som påverkar gränssnittets utseende. Egenskaperna AllowClose, AllowConnect, AllowEdit, AllowHide, AllowMinimizeoch anger var och AllowZoneChange en om användaren av ett webbprogram har behörighet att interagera med delkontrollen på det sätt som anges av det angivna egenskapsnamnet. Egenskaperna CatalogIconImageUrl, , ChromeState ChromeType, Description, Height, HelpUrl Hidden, Title, , TitleIconImageUrl, TitleUrloch Width avgör storlek, synlighet, utseende och stödinnehåll (till exempel en rubrik och en beskrivning) för en WebPart kontroll.

Relationen mellan en WebPart kontroll och dess kontext i kontrolluppsättningen Webbdelar bestäms av egenskaper som WebPartManager, som innehåller en referens till kontrollens associerade WebPartManager objekt och Zone, som refererar till WebZone den som innehåller kontrollen. Det kan bara finnas en WebPartManager kontroll per sida och varje instans av en WebPart kontroll kan bara finnas inom en WebZone i taget.

Note

En WebPart kontroll kan placeras utanför en zon på en webbsida, men i det här fallet fungerar den som en normal serverkontroll och förlorar nästan alla webbdelar.

Flera andra viktiga egenskaper påverkar unika funktioner WebPart i kontroller. Med AuthorizationFilter egenskapen kan utvecklare ange en godtycklig sträng som kan användas som ett filter vid körning för att avgöra om en kontroll läggs till på sidan. Egenskapen används tillsammans med en funktion som rollhantering och AuthorizationFilter ger en användbar mekanism för att skapa vyer baserat på definierade användarroller. Egenskapen ExportMode anger om alla tillgängliga egenskapsdata på en kontroll exporteras under en export eller endast icke-känsliga data. Detta gör det möjligt för utvecklare att skilja mellan data som är känsliga och data som inte är det, i säkerhetssyfte. Egenskapen WebBrowsableObject returnerar en referens till en instans av en WebPart kontroll, så att en EditorPart kontroll kan redigera den när sidan är i redigeringsläge. Slutligen finns det flera egenskaper som anger kontrollens status i förhållande till resten av sidan. Egenskapen IsClosed anger om en kontroll är stängd (och därmed läggs till i ett PageCatalogPart objekt) eller om den är öppen och tillgänglig på sidan. Egenskapen IsShared anger om en kontroll är en delad kontroll (jämfört med en användarspecifik kontroll), vilket innebär att den är synlig för alla användare av en webbsida. Egenskapen IsStandalone anger om en kontroll för närvarande finns i en WebPartZoneBase-härledd zon (till exempel WebPartZone). Värdet false anger att kontrollen finns i en zon och därför har fullständig webbdelsfunktion. Egenskapen IsStatic anger om en kontroll är statisk eller dynamisk. En statisk kontroll deklareras i markering av en webbsida, medan en dynamisk kontroll läggs till programmatiskt.

Klassen WebPart innehåller också flera metoder som avgör vad som händer vid olika tidpunkter i kontrollens livscykel. Metoderna och OnConnectModeChanged kan till exempel OnEditModeChanged åsidosättas i en härledd klass för att ge programmatisk kontroll över återgivningen av en kontrolls innehåll under händelsen som motsvarar varje metods namn.

Klasser som härleds från WebPart kan lägga till WebPartVerb objekt i Verbs samlingen. Verben återges i en verbmeny som visas i namnlisten för en WebPart kontroll. WebPartVerb objekt tillhandahåller enkla gränssnittselement för vanliga användaråtgärder, till exempel att dölja eller minimera kontrollen eller visa hjälpen.

Metoden CreateEditorParts skapar en samling anpassade EditorPart kontroller som är associerade med en WebPart kontroll. Utvecklare kan åsidosätta den här metoden så att den skapar anpassade kontroller som är särskilt utformade för att redigera deras WebPart kontroll. Metoden anropas när en användare klickar på redigeringsverb på en WebPart kontroll.

Konstruktorer

Name	Description
WebPart()	Initierar klassen för användning av en ärvd klassinstans. Den här konstruktorn kan bara anropas av en ärvd klass.

Egenskaper

Name	Description
AccessKey	Hämtar eller anger åtkomstnyckeln som gör att du snabbt kan navigera till webbserverkontrollen. (Ärvd från WebControl)
Adapter	Hämtar det webbläsarspecifika adaptern för kontrollen. (Ärvd från Control)
AllowClose	Hämtar eller anger ett värde som anger om en slutanvändare kan stänga en WebPart kontroll på en webbsida.
AllowConnect	Hämtar eller anger ett värde som anger om kontrollen WebPart tillåter att andra kontroller bildar anslutningar med den.
AllowEdit	Hämtar eller anger ett värde som anger om en slutanvändare kan ändra en WebPart kontroll via användargränssnittet som tillhandahålls av en eller flera EditorPart kontroller.
AllowHide	Hämtar eller anger ett värde som anger om slutanvändarna får dölja en WebPart kontroll.
AllowMinimize	Hämtar eller anger ett värde som anger om slutanvändare kan minimera en WebPart kontroll.
AllowZoneChange	Hämtar eller anger ett värde som anger om en användare kan flytta en WebPart kontroll mellan WebPartZoneBase zoner.
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)
AuthorizationFilter	Hämtar eller anger en godtycklig sträng för att avgöra om en WebPart kontroll har behörighet att läggas till på en sida.
BackColor	Hämtar eller anger bakgrundsfärgen för webbserverkontrollen. (Ärvd från WebControl)
BackImageUrl	Hämtar eller anger URL:en för bakgrundsbilden för panelkontrollen. (Ärvd från Panel)
BindingContainer	Hämtar kontrollen som innehåller den här kontrollens databindning. (Ärvd från Control)
BorderColor	Hämtar eller anger kantlinjefärgen för webbkontrollen. (Ärvd från WebControl)
BorderStyle	Hämtar eller anger kantlinjeformatet för webbserverkontrollen. (Ärvd från WebControl)
BorderWidth	Hämtar eller anger kantlinjebredden för webbserverkontrollen. (Ärvd från WebControl)
CatalogIconImageUrl	Hämtar eller anger URL:en till en bild som representerar en webbdelskontroll i en katalog med kontroller.
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)
ConnectErrorMessage	Hämtar ett felmeddelande som ska visas för användare om fel inträffar under anslutningsprocessen.
Context	Hämtar objektet HttpContext som är associerat med serverkontrollen för den aktuella webbbegäran. (Ärvd från Control)
Controls	Hämtar ett ControlCollection objekt som innehåller underordnade kontroller för en angiven serverkontroll i användargränssnittshierarkin. (Ärvd från Part)
ControlStyle	Hämtar formatmallen för webbserverkontrollen. Den här egenskapen används främst av kontrollutvecklare. (Ärvd från WebControl)
ControlStyleCreated	Hämtar ett värde som anger om ett Style objekt har skapats för egenskapen ControlStyle . Den här egenskapen används främst av kontrollutvecklare. (Ärvd från WebControl)
CssClass	Hämtar eller anger css-klassen (Cascading Style Sheet) som återges av webbserverkontrollen på klienten. (Ärvd från WebControl)
DataItemContainer	Hämtar en referens till namngivningscontainern om namngivningscontainern implementerar IDataItemContainer. (Ärvd från Control)
DataKeysContainer	Hämtar en referens till namngivningscontainern om namngivningscontainern implementerar IDataKeysControl. (Ärvd från Control)
DefaultButton	Hämtar eller anger identifieraren för standardknappen som finns i Panel kontrollen. (Ärvd från Panel)
Description	Hämtar eller anger en kort fras som sammanfattar vad delkontrollen gör, för användning i Knappbeskrivningar och kataloger med delkontroller.
DesignMode	Hämtar ett värde som anger om en kontroll används på en designyta. (Ärvd från Control)
Direction	Hämtar eller anger den vågräta riktning som innehållet flödar inom kontrollen.
DisplayTitle	Hämtar en sträng som innehåller den fullständiga rubriktexten som faktiskt visas i namnlisten för en WebPart kontrollinstans.
Enabled	Hämtar eller anger ett värde som anger om webbserverkontrollen är aktiverad. (Ärvd från WebControl)
EnableTheming	Hämtar eller anger ett värde som anger om teman ska gälla för den här kontrollen. (Ärvd från WebControl)
EnableViewState	Hämtar eller anger ett värde som anger om serverkontrollen bevarar sitt visningstillstånd och visningstillståndet för eventuella underordnade kontroller som den innehåller till den begärande klienten. (Ärvd från Control)
Events	Hämtar en lista över händelsehanterardelegater för kontrollen. Den här egenskapen är skrivskyddad. (Ärvd från Control)
ExportMode	Hämtar eller anger om alla, vissa eller ingen av en WebPart kontrolls egenskaper kan exporteras.
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)
HasSharedData	Hämtar ett värde som anger om en WebPart kontroll har några delade anpassningsdata som är associerade med den.
HasUserData	Hämtar ett värde som anger om en WebPart kontroll har några associerade användaranpassningsdata.
Height	Hämtar eller anger höjden på en zon.
HelpMode	Hämtar eller anger vilken typ av användargränssnitt (UI) som används för att visa hjälpinnehåll för en WebPart kontroll.
HelpUrl	Hämtar eller anger URL:en till en hjälpfil för en WebPart kontroll.
Hidden	Hämtar eller anger ett värde som anger om en WebPart kontroll visas på en webbsida.
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)
ImportErrorMessage	Hämtar eller anger ett felmeddelande som används om fel uppstår när en WebPart kontroll importeras.
IsChildControlStateCleared	Hämtar ett värde som anger om kontroller i den här kontrollen har kontrolltillstånd. (Ärvd från Control)
IsClosed	Hämtar ett värde som anger om en WebPart kontroll för närvarande är stängd på en webbdelssida.
IsEnabled	Hämtar ett värde som anger om kontrollen är aktiverad. (Ärvd från WebControl)
IsShared	Hämtar ett värde som anger om en WebPart kontroll delas, vilket innebär att den är synlig för alla användare av en webbdelssida.
IsStandalone	Hämtar ett värde som anger om en WebPart kontroll är fristående, vilket innebär att den inte finns i en WebPartZoneBase zon.
IsStatic	Hämtar ett värde som anger om en WebPart kontroll är en statisk kontroll, vilket innebär att kontrollen deklareras i markering av en webbdelssida och inte läggs till på sidan programmatiskt.
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)
Subtitle	Hämtar en sträng som sammanfogas med egenskapsvärdet Title för att skapa en fullständig rubrik för en WebPart kontroll.
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 Panel)
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.
TitleIconImageUrl	Hämtar eller anger URL:en till en bild som används för att representera en webbdelskontroll i kontrollens namnlist.
TitleUrl	Hämtar eller anger en URL till kompletterande information om en WebPart kontroll.
ToolTip	Hämtar eller anger texten som visas när muspekaren hovrar över webbserverkontrollen. (Ärvd från WebControl)
UniqueID	Hämtar den unika, hierarkiskt kvalificerade identifieraren för serverkontrollen. (Ärvd från Control)
ValidateRequestMode	Hämtar eller anger ett värde som anger om kontrollen kontrollerar klientindata från webbläsaren efter potentiellt farliga värden. (Ärvd från Control)
Verbs	Hämtar en samling anpassade verb som är associerade med en WebPart kontroll.
ViewState	Hämtar en ordlista med tillståndsinformation som gör att du kan spara och återställa visningstillståndet för en serverkontroll över flera begäranden för samma sida. (Ärvd från Control)
ViewStateIgnoresCase	Hämtar ett värde som anger om objektet StateBag är skiftlägesokänsligt. (Ärvd från Control)
ViewStateMode	Hämtar eller anger visningstillståndsläget för den här kontrollen. (Ärvd från Control)
Visible	Hämtar eller anger ett värde som anger om en serverkontroll återges som användargränssnitt på sidan. (Ärvd från Control)
WebBrowsableObject	Hämtar en referens till kontrollen så att den WebPart kan redigeras av anpassade EditorPart kontroller.
WebPartManager	Hämtar en referens till kontrollen som WebPartManager är associerad med en WebPart kontrollinstans.
Width	Hämtar eller anger bredden på webbserverkontrollen.
Wrap	Hämtar eller anger ett värde som anger om innehållet omsluts i panelen. (Ärvd från Panel)
Zone	WebPartZoneBase Hämtar zonen som för närvarande innehåller en WebPart kontroll.
ZoneIndex	Hämtar indexpositionen för en WebPart kontroll inom dess zon.

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 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 ett formatobjekt som används internt av Panel kontrollen för att implementera alla formatrelaterade egenskaper. (Ärvd från Panel)
CreateEditorParts()	Returnerar en samling anpassade EditorPart kontroller som kan användas för att redigera en WebPart kontroll när den är i redigeringsläge.
DataBind()	Binder en datakälla till den anropade serverkontrollen och alla dess underordnade kontroller. (Ärvd från Part)
DataBind(Boolean)	Binder en datakälla till den anropade serverkontrollen och alla dess underordnade kontroller med ett alternativ för att skapa händelsen DataBinding . (Ärvd från Control)
DataBindChildren()	Binder en datakälla till serverkontrollens underordnade kontroller. (Ärvd från Control)
Dispose()	Gör att en serverkontroll kan utföra slutlig rensning innan den frigörs från minnet. (Ärvd från Control)
EndRenderTracing(TextWriter, Object)	Avslutar designtidsspårning av återgivningsdata. (Ärvd från Control)
EnsureChildControls()	Avgör om serverkontrollen innehåller underordnade kontroller. Om den inte gör det skapar den underordnade kontroller. (Ärvd från Control)
EnsureID()	Skapar en identifierare för kontroller som inte har tilldelats någon identifierare. (Ärvd från Control)
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
FindControl(String, Int32)	Söker i den aktuella namngivningscontainern efter en serverkontroll med det angivna `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)
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)
OnClosing(EventArgs)	Aktiverar härledda klasser för att tillhandahålla anpassad hantering när en WebPart kontroll stängs på en webbdelssida.
OnConnectModeChanged(EventArgs)	Gör det möjligt för härledda klasser att tillhandahålla anpassad hantering när en WebPart kontroll påbörjar eller avslutar processen med att ansluta till andra kontroller.
OnDataBinding(EventArgs)	Genererar händelsen DataBinding . (Ärvd från Control)
OnDeleting(EventArgs)	Aktiverar härledda klasser för att tillhandahålla anpassad hantering när en WebPart kontroll tas bort permanent från en webbdelssida.
OnEditModeChanged(EventArgs)	Aktiverar härledda klasser för att tillhandahålla anpassad hantering när en WebPart kontroll går in i eller lämnar redigeringsläget.
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)
SetPersonalizationDirty()	Anger en flagga som anger att anpassningsdata har ändrats för den aktuella WebPart kontrollinstansen.
SetPersonalizationDirty(Control)	Anger en flagga som anger att anpassningsdata har ändrats för den angivna serverkontrollen som finns i en WebPartZoneBase zon.
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.

Händelser

Name	Description
DataBinding	Inträffar när serverkontrollen binder till en datakälla. (Ärvd från Control)
Disposed	Inträffar när en serverkontroll frigörs från minnet, vilket är den sista fasen i serverkontrolllivscykeln när en ASP.NET sida begärs. (Ärvd från Control)
Init	Inträffar när serverkontrollen initieras, vilket är det första steget i dess livscykel. (Ärvd från Control)
Load	Inträffar när serverkontrollen läses in i Page objektet. (Ärvd från Control)
PreRender	Inträffar efter att objektet Control har lästs in men före återgivningen. (Ärvd från Control)
Unload	Inträffar när serverkontrollen tas bort från minnet. (Ärvd från Control)

Explicita gränssnittsimplementeringar

Name	Description
IAttributeAccessor.GetAttribute(String)	Hämtar ett attribut för webbkontrollen med det angivna namnet. (Ärvd från WebControl)
IAttributeAccessor.SetAttribute(String, String)	Anger ett attribut för webbkontrollen till det angivna namnet och värdet. (Ärvd från WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()	Gör att utvecklaren av en designer för en sammansatt delkontroll kan återskapa kontrollens underordnade kontroller på designytan. (Ärvd från Part)
IControlBuilderAccessor.ControlBuilder	En beskrivning av den här medlemmen finns i ControlBuilder. (Ärvd från Control)
IControlDesignerAccessor.GetDesignModeState()	En beskrivning av den här medlemmen finns i GetDesignModeState(). (Ärvd från Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	En beskrivning av den här medlemmen finns i SetDesignModeState(IDictionary). (Ärvd från Control)
IControlDesignerAccessor.SetOwnerControl(Control)	En beskrivning av den här medlemmen finns i SetOwnerControl(Control). (Ärvd från Control)
IControlDesignerAccessor.UserData	En beskrivning av den här medlemmen finns i UserData. (Ärvd från Control)
IDataBindingsAccessor.DataBindings	En beskrivning av den här medlemmen finns i DataBindings. (Ärvd från Control)
IDataBindingsAccessor.HasDataBindings	En beskrivning av den här medlemmen finns i HasDataBindings. (Ärvd från Control)
IExpressionsAccessor.Expressions	En beskrivning av den här medlemmen finns i Expressions. (Ärvd från Control)
IExpressionsAccessor.HasExpressions	En beskrivning av den här medlemmen finns i HasExpressions. (Ärvd från Control)
IParserAccessor.AddParsedSubObject(Object)	En beskrivning av den här medlemmen finns i AddParsedSubObject(Object). (Ärvd från Control)

Tilläggsmetoder

Name	Description
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Aktiverar dynamiskt databeteende för den angivna datakontrollen.
EnableDynamicData(INamingContainer, Type, Object)	Aktiverar dynamiskt databeteende för den angivna datakontrollen.
EnableDynamicData(INamingContainer, Type)	Aktiverar dynamiskt databeteende för den angivna datakontrollen.
FindDataSourceControl(Control)	Returnerar datakällan som är associerad med datakontrollen för den angivna kontrollen.
FindFieldTemplate(Control, String)	Returnerar fältmallen för den angivna kolumnen i den angivna kontrollens namngivningscontainer.
FindMetaTable(Control)	Returnerar metatabellobjektet för den innehållande datakontrollen.
GetDefaultValues(INamingContainer)	Hämtar insamlingen av standardvärdena för den angivna datakontrollen.
GetMetaTable(INamingContainer)	Hämtar tabellmetadata för den angivna datakontrollen.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Anger tabellmetadata och standardvärdemappning för den angivna datakontrollen.
SetMetaTable(INamingContainer, MetaTable, Object)	Anger tabellmetadata och standardvärdemappning för den angivna datakontrollen.
SetMetaTable(INamingContainer, MetaTable)	Anger tabellmetadata för den angivna datakontrollen.
TryGetMetaTable(INamingContainer, MetaTable)	Avgör om tabellmetadata är tillgängliga.

Gäller för

Se även

Feedback

Var den här sidan till hjälp?