BulletedList Klass

Definition

Skapar en kontroll som genererar en lista över objekt i punktformat.

public ref class BulletedList : System::Web::UI::WebControls::ListControl, System::Web::UI::IPostBackEventHandler
public class BulletedList : System.Web.UI.WebControls.ListControl, System.Web.UI.IPostBackEventHandler
type BulletedList = class
    inherit ListControl
    interface IPostBackEventHandler
Public Class BulletedList
Inherits ListControl
Implements IPostBackEventHandler
Arv
Implementeringar

Exempel

Det här avsnittet innehåller två kodexempel. Det första kodexemplet visar hur du skapar en BulletedList kontroll med listobjekt som är formaterade som länkknappar. Det andra kodexemplet visar hur du skapar en BulletedList kontroll med databindning för att ange listobjekten.

I följande kodexempel visas hur du skapar en BulletedList kontroll med listobjekt som är formaterade som länkknappar. Text visas i en Label kontroll när ett listobjekt klickas.

<%@ Page Language="C#" %>

<!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 runat="server">
  <title>BulletedList Click Example</title>
  <script runat="server">


    void ItemsBulletedList_Click(object sender, System.Web.UI.WebControls.BulletedListEventArgs e)
    {

        // Change the message displayed in the label based on the index
        // of the list item that was clicked.
        switch (e.Index) 
      {
            case 0:
                Message.Text = "You clicked list item 1.";
                break;
            case 1:
                Message.Text = "You clicked list item 2.";
                break;
            case 2:
                Message.Text = "You clicked list item 3.";
                break;
            default:
                throw new Exception("You did not click a valid list item.");
                break;
        }

    }

  </script>

</head>
<body>

  <h3>BulletedList Click Example</h3>

  <form id="form1" runat="server">
            
    <p>Click on an item in the list to raise the Click event.</p> 
        
    <asp:BulletedList id="ItemsBulletedList" 
      BulletStyle="Disc"
      DisplayMode="LinkButton"
      OnClick="ItemsBulletedList_Click"
      runat="server">
        <asp:ListItem Value="http://www.cohowinery.com">Coho Winery</asp:ListItem>
        <asp:ListItem Value="http://www.contoso.com">Contoso, Ltd.</asp:ListItem>
        <asp:ListItem Value="http://www.tailspintoys.com">Tailspin Toys</asp:ListItem>
    </asp:BulletedList>
            
    <asp:Label id="Message" 
      Font-Size="12"
      Width="168px" 
      Font-Bold="True" 
      runat="server"
      AssociatedControlID="ItemsBulletedList"/>

   </form>

</body>
</html>
<%@ Page Language="VB" %>

<!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 runat="server">
  <title>BulletedList Click Example</title>
  <script runat="server">

    Sub ItemsBulletedList_Click(ByVal sender As Object, _
                                ByVal e As System.Web.UI.WebControls.BulletedListEventArgs)
      
      ' Change the message displayed in the label based on the index
      ' of the list item that was clicked.
      Select Case (e.Index)
        Case 0
          Message.Text = "You clicked list item 1."
        Case 1
          Message.Text = "You clicked list item 2."
        Case 2
          Message.Text = "You clicked list item 3."
        Case Else
          Throw New Exception("You did not click a valid list item.")
      End Select

    End Sub

  </script>

</head>
<body>

  <h3>BulletedList Click Example</h3>

  <form id="form1" runat="server">
            
    <p>Click on an item in the list to raise the Click event.</p> 
        
    <asp:BulletedList id="ItemsBulletedList" 
      BulletStyle="Disc"
      DisplayMode="LinkButton" 
      OnClick="ItemsBulletedList_Click"
      runat="server">
        <asp:ListItem Value="http://www.cohowinery.com">Coho Winery</asp:ListItem>
        <asp:ListItem Value="http://www.contoso.com">Contoso, Ltd.</asp:ListItem>
        <asp:ListItem Value="http://www.tailspintoys.com">Tailspin Toys</asp:ListItem>
    </asp:BulletedList>
            
    <asp:Label id="Message"
      Font-Size="12"
      Width="168px"
      Font-Bold="True"
      runat="server"
      AssociatedControlID="ItemsBulletedList"/>

   </form>

</body>
</html>

I följande kodexempel visas hur du skapar en BulletedList kontroll med databindning för att ange listobjekten. Listobjekten formateras som länkknappar. Text visas i en Label kontroll när ett listobjekt klickas.

<%@ Page Language="C#" %>

<!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 runat="server">
  <title>BulletedList Class Data Binding Example</title>
  <script runat="server">

    void ProductsBulletedList_Click(object sender, 
      System.Web.UI.WebControls.BulletedListEventArgs e)
    {

        // Change the message displayed in the label based on the index
        // of the list item that was clicked.
        switch (e.Index) 
      {
            case 0:
                Message.Text = "Product 1 was clicked";
                break;
            case 1:
                Message.Text = "Product 2 was clicked";
                break;
            case 2:
                Message.Text = "Product 3 was clicked";
                break;
            case 3:
                Message.Text = "Product 4 was clicked";
                break;
            default:
                throw new Exception("You must click a valid list item.");
                break;
        }

  }

  </script>
    
</head>
<body>

  <h3>BulletedList Class Data Binding Example</h3>

  <form id="form1" runat="server">
            
    <p>Click on an item in the list.</p>

    <asp:BulletedList id="ProductsBulletedList" 
      BulletStyle="Disc"
      DisplayMode="LinkButton"
      DataTextField="ProductName"
      DataSourceID="SqlDataSource1"
      OnClick="ProductsBulletedList_Click"
      runat="server">                    
    </asp:BulletedList>
        
    <asp:SqlDataSource id="SqlDataSource1"          
      ConnectionString="<%$ ConnectionStrings:NorthWindConnection%>"
      runat="server"
      SelectCommand="SELECT * FROM [Products] Where ProductID < 5">
    </asp:SqlDataSource>

    <asp:Label id="Message" 
      Font-Size="12"
      Width="168px" 
      Font-Bold="True" 
      runat="server"/>

   </form>

</body>
</html>
<%@ Page Language="VB" %>

<!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 runat="server">
  <title>BulletedList Class Data Binding Example</title>
  <script runat="server">

    Sub ProductsBulletedList_Click(ByVal sender As Object, _
                                   ByVal e As System.Web.UI.WebControls.BulletedListEventArgs)
      
      ' Change the message displayed in the label based on the index
      ' of the list item that was clicked.
      Select Case (e.Index)
        Case 0
          Message.Text = "Product 1 was clicked"
        Case 1
          Message.Text = "Product 2 was clicked"
        Case 2
          Message.Text = "Product 3 was clicked"
        Case 3
          Message.Text = "Product 4 was clicked"
        Case Else
          Throw New Exception("You must click a valid list item.")
      End Select

    End Sub

  </script>
    
</head>
<body>

  <h3>BulletedList Class Data Binding Example</h3>

  <form id="form1" runat="server">
            
    <p>Click on an item in the list.</p>

    <asp:BulletedList id="ProductsBulletedList" 
      BulletStyle="Disc"
      DisplayMode="LinkButton"
      DataTextField="ProductName"
      DataSourceID="SqlDataSource1"
      OnClick="ProductsBulletedList_Click"
      runat="server">                    
    </asp:BulletedList>
        
    <asp:SqlDataSource id="SqlDataSource1"          
      ConnectionString="<%$ ConnectionStrings:NorthWindConnection%>"
      runat="server"
      SelectCommand="SELECT * FROM [Products] Where ProductID < 5">
    </asp:SqlDataSource>

    <asp:Label id="Message" 
      Font-Size="12"
      Width="168px" 
      Font-Bold="True" 
      runat="server"/>

   </form>

</body>
</html>

Kommentarer

I det här avsnittet:

Introduction

Använd kontrollen BulletedList för att skapa en lista över objekt som är formaterade med punkter. Om du vill ange de enskilda listobjekt som du vill ska visas i en BulletedList kontroll placerar du ett ListItem objekt för varje post mellan kontrollens BulletedList inledande och avslutande taggar.

Om du vill ange vilken punkttyp som ska användas för att visa listobjekt i en BulletedList kontroll anger du BulletStyle egenskapen till en av de punkttyper som definieras av BulletStyle uppräkningen. I följande tabell visas de tillgängliga punktformaten.

Punktformat Description
NotSet Inte inställt.
Numbered Ett tal.
LowerAlpha En gemen bokstav.
UpperAlpha En versal bokstav.
LowerRoman Ett romerskt gemener.
UpperRoman Ett romerskt versalt tal.
Disc En fylld cirkel.
Circle En tom cirkel.
Square En fylld fyrkant.
CustomImage En anpassad avbildning.

Använd egenskapen FirstBulletNumber för att ange det värde som startar numreringen av listobjekt i en ordnad BulletedList kontroll. Värdet som tilldelas egenskapen FirstBulletNumber ignoreras om BulletStyle egenskapen är inställd på Discfältet , Square, Circleeller CustomImage . Om du ställer in BulletStyle egenskapen på värdet för för att ange en anpassad avbildning CustomImage för punktrutan måste du ange BulletImageUrl egenskapen även för att ange platsen för bildfilen.

Om du vill ange visningsbeteendet för listobjekten i en BulletedListanger du DisplayMode egenskapen till ett av de värden som definieras av BulletedListDisplayMode uppräkningen. De definierade visningsbeteendena är Text, HyperLinkoch LinkButton.

När en hyperlänk klickas navigerar den till en URL. Använd egenskapen Value för att ange den URL som en hyperlänk navigerar till. Använd egenskapen Target för att ange den ram eller det fönster som visar webbsidan som navigeras till när en hyperlänk klickas.

När egenskapen DisplayMode är inställd LinkButtonBulletedList på visar kontrollen listobjekt som länkar som skickas tillbaka till servern när du klickar på den. Om du vill styra de åtgärder som utförs programmatiskt när en länkknapp klickas anger du en händelsehanterare för Click händelsen. Observera att SelectedIndex egenskaperna och SelectedItem ärvs från ListControl klassen och inte gäller för BulletedList kontrollen. Använd händelsedata för BulletedListEventArgs klassen för att fastställa indexet för länkknappen i en BulletedList som klickades.

Kontrollen BulletedList stöder även databindning. Om du vill binda BulletedList till en datakälla kan du använda någon av de angivna mekanismerna för databindning. Mer information finns i Bindning till databaser.

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.

Deklarativ syntax

<asp:BulletedList
    AccessKey="string"
    AppendDataBoundItems="True|False"
    AutoPostBack="True|False"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    BulletImageUrl="uri"
    BulletStyle="NotSet|Numbered|LowerAlpha|UpperAlpha|LowerRoman|
        UpperRoman|Disc|Circle|Square|CustomImage"
    CausesValidation="True|False"
    CssClass="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    DataTextField="string"
    DataTextFormatString="string"
    DataValueField="string"
    DisplayMode="Text|HyperLink|LinkButton"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    FirstBulletNumber="integer"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
        Medium|Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    OnClick="Click event handler"
    OnDataBinding="DataBinding event handler"
    OnDataBound="DataBound event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnSelectedIndexChanged="SelectedIndexChanged event handler"
    OnTextChanged="TextChanged event handler"
    OnUnload="Unload event handler"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Target="string|_blank|_parent|_search|_self|_top"
    ToolTip="string"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
>
            <asp:ListItem
                Enabled="True|False"
                Selected="True|False"
                Text="string"
                Value="string"
            />
</asp:BulletedList>

Konstruktorer

Name Description
BulletedList()

Initierar en ny instans av BulletedList 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)
AppendDataBoundItems

Hämtar eller anger ett värde som anger om listobjekt rensas före databindningen.

(Ärvd från ListControl)
AppRelativeTemplateSourceDirectory

Hämtar eller anger den programrelativa virtuella katalogen PageUserControl för eller -objektet som innehåller den här kontrollen.

(Ärvd från Control)
Attributes

Hämtar samlingen med godtyckliga attribut (endast för återgivning) som inte motsvarar egenskaperna i kontrollen.

(Ärvd från WebControl)
AutoPostBack

Hämtar eller anger värdet för AutoPostBack egenskapen för basklassen.

BackColor

Hämtar eller anger bakgrundsfärgen för webbserverkontrollen.

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

Hämtar eller anger sökvägen till en bild som ska visas för varje punkt i en BulletedList kontroll.

BulletStyle

Hämtar eller anger punktformatet BulletedList för kontrollen.

CausesValidation

Hämtar eller anger ett värde som anger om verifieringen utförs när en kontroll som härleds från ListControl klassen klickas.

(Ärvd från ListControl)
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 en ControlCollection samling för kontrollen.

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

Hämtar eller anger ID för den kontroll som den databundna kontrollen hämtar sin lista över dataobjekt från.

(Ärvd från DataBoundControl)
DataSourceObject

Hämtar ett objekt som implementerar IDataSource gränssnittet, vilket ger åtkomst till objektets datainnehåll.

(Ärvd från DataBoundControl)
DataTextField

Hämtar eller anger fältet för datakällan som innehåller textinnehållet i listobjekten.

(Ärvd från ListControl)
DataTextFormatString

Hämtar eller anger formateringssträngen som används för att styra hur data som är bundna till listkontrollen visas.

(Ärvd från ListControl)
DataValueField

Hämtar eller anger fältet för datakällan som ger värdet för varje listobjekt.

(Ärvd från ListControl)
DesignMode

Hämtar ett värde som anger om en kontroll används på en designyta.

(Ärvd från Control)
DisplayMode

Hämtar eller anger visningsläget för listinnehållet i en BulletedList kontroll.

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

Hämtar eller anger det värde som startar numreringen av listobjekt i en ordnad BulletedList kontroll.

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

Hämtar ett värde som anger om kontrollen har attribut inställda.

(Ärvd från WebControl)
HasChildViewState

Hämtar ett värde som anger om den aktuella serverkontrollens underordnade kontroller har några sparade vytillståndsinställningar.

(Ärvd från Control)
Height

Hämtar eller anger höjden på webbserverkontrollen.

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

Hämtar ett värde som anger om den databundna kontrollen har initierats.

(Ärvd från BaseDataBoundControl)
IsBoundUsingDataSourceID

Hämtar ett värde som anger om egenskapen DataSourceID har angetts.

(Ärvd från BaseDataBoundControl)
IsChildControlStateCleared

Hämtar ett värde som anger om kontroller i den här kontrollen har kontrolltillstånd.

(Ärvd från Control)
IsDataBindingAutomatic

Hämtar ett värde som anger om databindningen är automatisk.

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

Hämtar ett värde som anger om modellbindning används.

(Ärvd från DataBoundControl)
IsViewStateEnabled

Hämtar ett värde som anger om visningstillstånd är aktiverat för den här kontrollen.

(Ärvd från Control)
Items

Hämtar samlingen med objekt i listkontrollen.

(Ärvd från ListControl)
ItemType

Hämtar eller anger namnet på dataobjekttypen för starkt typ av databindning.

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

Hämtar eller anger ett värde som anger om kontrollen återges om datakällan inte har några data eller om kontrollen inte är databunden.

RequiresDataBinding

Hämtar eller anger ett värde som anger om DataBind() metoden ska anropas.

(Ärvd från BaseDataBoundControl)
SelectArguments

Hämtar ett DataSourceSelectArguments objekt som den databundna kontrollen använder när data hämtas från en datakällakontroll.

(Ärvd från DataBoundControl)
SelectedIndex

Hämtar eller anger det nollbaserade indexet för det markerade objektet i en BulletedList kontroll.

SelectedItem

Hämtar det markerade objektet i en BulletedList kontroll.

SelectedValue

Hämtar eller anger egenskapen för Value det markerade ListItem objektet i BulletedList kontrollen.

SelectMethod

Namnet på den metod som ska anropas för att läsa data.

(Ärvd från DataBoundControl)
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 BaseDataBoundControl)
TabIndex

Hämtar eller anger flikindexet för webbserverkontrollen.

(Ärvd från WebControl)
TagKey

HtmlTextWriterTag Hämtar värdet för den angivna BulletedList kontrollen.

TagName

Hämtar namnet på kontrolltaggen. Den här egenskapen används främst av kontrollutvecklare.

(Ärvd från WebControl)
Target

Hämtar eller anger målfönstret eller ramen där du vill visa det webbplatsinnehåll som är länkat till när en hyperlänk i en BulletedList kontroll klickas.

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

Hämtar eller anger texten för BulletedList kontrollen.

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

Hämtar eller anger den grupp med kontroller som kontrollen som härleds från ListControl klassen orsakar validering när den skickas tillbaka till servern.

(Ärvd från ListControl)
ViewState

Hämtar en ordlista med tillståndsinformation som gör att du kan spara och återställa visningstillståndet för en serverkontroll över flera begäranden för samma sida.

(Ärvd från Control)
ViewStateIgnoresCase

Hämtar ett värde som anger om objektet StateBag är skiftlägesokänsligt.

(Ärvd från Control)
ViewStateMode

Hämtar eller anger visningstillståndsläget för den här kontrollen.

(Ärvd från Control)
Visible

Hämtar eller anger ett värde som anger om en serverkontroll återges som användargränssnitt på sidan.

(Ärvd från Control)
Width

Hämtar eller anger bredden på webbserverkontrollen.

(Ärvd från WebControl)

Metoder

Name Description
AddAttributesToRender(HtmlTextWriter)

Lägger till HTML-attribut och formatmallar för en BulletedList kontroll som ska återges till det angivna HtmlTextWriter objektet.

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

Rensar listmarkeringen och anger Selected egenskapen för alla objekt till false.

(Ärvd från ListControl)
ConfirmInitState()

Anger det initierade tillståndet för den databundna kontrollen.

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

Skapar ett standardobjekt DataSourceSelectArguments som används av den databundna kontrollen om inga argument anges.

(Ärvd från DataBoundControl)
DataBind()

Binder en datakälla till den anropade serverkontrollen och alla dess underordnade kontroller.

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

DataBind() Anropar metoden om DataSourceID egenskapen har angetts och den databundna kontrollen har markerats för att kräva bindning.

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

Hämtar ett DataSourceView objekt som den databundna kontrollen använder för att utföra dataåtgärder.

(Ärvd från DataBoundControl)
GetDataSource()

Hämtar det IDataSource gränssnitt som den databundna kontrollen är associerad med, om någon.

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

Läser in kontrollens tidigare sparade vytillstånd DetailsView .

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

Anger tillståndet för kontrollen i visningstillståndet som korrekt bundet till data.

(Ärvd från DataBoundControl)
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)
OnClick(BulletedListEventArgs)

Genererar Click händelsen för BulletedList kontrollen.

OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)

Genererar händelsen CreatingModelDataSource .

(Ärvd från DataBoundControl)
OnDataBinding(EventArgs)

Genererar händelsen DataBinding .

(Ärvd från ListControl)
OnDataBound(EventArgs)

Genererar händelsen DataBound .

(Ärvd från BaseDataBoundControl)
OnDataPropertyChanged()

Ombindar den databundna kontrollen till sina data efter att en av egenskaperna för grundläggande datakällaidentifiering har ändrats.

(Ärvd från DataBoundControl)
OnDataSourceViewChanged(Object, EventArgs)

Genererar händelsen DataSourceViewChanged .

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

Hanterar händelsen Init .

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

Hanterar händelsen Load .

(Ärvd från DataBoundControl)
OnPagePreLoad(Object, EventArgs)

Anger det initierade tillståndet för den databundna kontrollen innan kontrollen läses in.

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

Genererar händelsen PreRender .

(Ärvd från ListControl)
OnSelectedIndexChanged(EventArgs)

Genererar händelsen SelectedIndexChanged . På så sätt kan du ange en anpassad hanterare för händelsen.

(Ärvd från ListControl)
OnTextChanged(EventArgs)

Genererar händelsen TextChanged .

(Ärvd från ListControl)
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)
PerformDataBinding(IEnumerable)

Binder den angivna datakällan till den kontroll som härleds från ListControl klassen.

(Ärvd från ListControl)
PerformSelect()

Hämtar data från den associerade datakällan.

(Ärvd från ListControl)
RaiseBubbleEvent(Object, EventArgs)

Tilldelar alla källor till händelsen och dess information till kontrollens överordnade.

(Ärvd från Control)
RaisePostBackEvent(String)

Genererar händelser för BulletedList kontrollen när ett formulär skickas tillbaka till servern.

RemovedControl(Control)

Anropas efter att en underordnad Controls kontroll har tagits bort från objektets Control samling.

(Ärvd från Control)
Render(HtmlTextWriter)

Skriver kontrollinnehållet BulletedList till det angivna HtmlTextWriter objektet för visning på klienten.

RenderBeginTag(HtmlTextWriter)

Renderar HTML-öppningstaggen för kontrollen till den angivna skrivaren. Den här metoden används främst av kontrollutvecklare.

(Ärvd från WebControl)
RenderBulletText(ListItem, Int32, HtmlTextWriter)

Återger punkttexten för varje listobjekt i en BulletedList kontroll.

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 listobjekten i en BulletedList kontroll som punkter i den angivna HtmlTextWriter.

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)
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 det aktuella visningstillståndet för -derived-kontrollen ListControl och de objekt som den innehåller.

(Ärvd från ListControl)
SetDesignModeState(IDictionary)

Anger designtidsdata för en kontroll.

(Ärvd från Control)
SetPostDataSelection(Int32)

Anger egenskapen för Selected en ListItem kontroll när en sida har publicerats.

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

Markerar startpunkten för att börja spåra och spara ändringar i visningstillstånd i en ListControl -derived kontroll.

(Ärvd från ListControl)
ValidateDataSource(Object)

Verifierar att objektet som en databunden kontroll binder till är ett objekt som det kan arbeta med.

(Ärvd från DataBoundControl)
VerifyMultiSelect()

Avgör om listkontrollen stöder multiselection-läge.

(Ärvd från ListControl)

Händelser

Name Description
CallingDataMethods

Inträffar när datametoder anropas.

(Ärvd från DataBoundControl)
Click

Inträffar när en länkknapp i en BulletedList kontroll klickas.

CreatingModelDataSource

Inträffar när objektet ModelDataSource skapas.

(Ärvd från DataBoundControl)
DataBinding

Inträffar när serverkontrollen binder till en datakälla.

(Ärvd från Control)
DataBound

Inträffar när serverkontrollen binder till en datakälla.

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

Inträffar när markeringen från listkontrollen ändras mellan inlägg på servern.

(Ärvd från ListControl)
TextChanged

Inträffar när Text egenskaperna och SelectedValue ändras.

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

En beskrivning av den här metoden finns i RaisePostBackEvent(String).

Tilläggsmetoder

Name Description
EnablePersistedSelection(BaseDataBoundControl)
Föråldrad.

Gör att markeringen kan sparas i datakontroller som stöder val och växling.

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.

Gäller för

Se även