BulletedList Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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 |
| 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 |
| 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 |
| FindControl(String) |
Söker i den aktuella namngivningscontainern efter en serverkontroll med den angivna |
| 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. |