Button 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.
Visar en knapptryckningskontroll på webbsidan.
public ref class Button : System::Web::UI::WebControls::WebControl, System::Web::UI::IPostBackEventHandlerpublic ref class Button : System::Web::UI::WebControls::WebControl, System::Web::UI::IPostBackEventHandler, System::Web::UI::WebControls::IButtonControlpublic class Button : System.Web.UI.WebControls.WebControl, System.Web.UI.IPostBackEventHandlerpublic class Button : System.Web.UI.WebControls.WebControl, System.Web.UI.IPostBackEventHandler, System.Web.UI.WebControls.IButtonControltype Button = class
inherit WebControl
interface IPostBackEventHandlertype Button = class
inherit WebControl
interface IButtonControl
interface IPostBackEventHandlerPublic Class Button
Inherits WebControl
Implements IPostBackEventHandlerPublic Class Button
Inherits WebControl
Implements IButtonControl, IPostBackEventHandler- Arv
- Implementeringar
Exempel
I följande kodexempel visas hur du skapar en Skicka-kontroll Button som publicerar webbplatsinnehållet tillbaka till servern.
<%@ Page Language="C#" AutoEventWireup="True" %>
<!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>
<title>Button Example</title>
<script language="C#" runat="server">
void SubmitBtn_Click(Object sender, EventArgs e)
{
Message.Text="Hello World!!";
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Button Example</h3>
Click on the submit button.<br /><br />
<asp:Button id="Button1"
Text="Submit"
OnClick="SubmitBtn_Click"
runat="server"/>
<br />
<asp:label id="Message" runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!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>
<title>Button Example</title>
<script language="VB" runat="server">
Sub SubmitBtn_Click(sender As Object, e As EventArgs)
Message.Text = "Hello World!!"
End Sub 'SubmitBtn_Click
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Button Example</h3>
Click on the submit button.<br /><br />
<asp:Button id="Button1"
Text="Submit"
OnClick="SubmitBtn_Click"
runat="server"/>
<br />
<asp:label id="Message" runat="server"/>
</form>
</body>
</html>
I följande kodexempel visas hur du skapar en kommandokontroll Button som sorterar en lista.
<%@ Page Language="C#" AutoEventWireup="True" %>
<!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>Button CommandName Example</title>
<script runat="server">
void CommandBtn_Click(Object sender, CommandEventArgs e)
{
switch(e.CommandName)
{
case "Sort":
// Call the method to sort the list.
Sort_List((String)e.CommandArgument);
break;
case "Submit":
// Display a message for the Submit button being clicked.
Message.Text = "You clicked the Submit button";
// Test whether the command argument is an empty string ("").
if((String)e.CommandArgument == "")
{
// End the message.
Message.Text += ".";
}
else
{
// Display an error message for the command argument.
Message.Text += ", however the command argument is not recogized.";
}
break;
default:
// The command name is not recognized. Display an error message.
Message.Text = "Command name not recogized.";
break;
}
}
void Sort_List(string commandArgument)
{
switch(commandArgument)
{
case "Ascending":
// Insert code to sort the list in ascending order here.
Message.Text = "You clicked the Sort Ascending button.";
break;
case "Descending":
// Insert code to sort the list in descending order here.
Message.Text = "You clicked the Sort Descending button.";
break;
default:
// The command argument is not recognized. Display an error message.
Message.Text = "Command argument not recogized.";
break;
}
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Button CommandName Example</h3>
Click on one of the command buttons.
<br /><br />
<asp:Button id="Button1"
Text="Sort Ascending"
CommandName="Sort"
CommandArgument="Ascending"
OnCommand="CommandBtn_Click"
runat="server"/>
<asp:Button id="Button2"
Text="Sort Descending"
CommandName="Sort"
CommandArgument="Descending"
OnCommand="CommandBtn_Click"
runat="server"/>
<br /><br />
<asp:Button id="Button3"
Text="Submit"
CommandName="Submit"
OnCommand="CommandBtn_Click"
runat="server"/>
<asp:Button id="Button4"
Text="Unknown Command Name"
CommandName="UnknownName"
CommandArgument="UnknownArgument"
OnCommand="CommandBtn_Click"
runat="server"/>
<asp:Button id="Button5"
Text="Submit Unknown Command Argument"
CommandName="Submit"
CommandArgument="UnknownArgument"
OnCommand="CommandBtn_Click"
runat="server"/>
<br /><br />
<asp:Label id="Message" runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!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>Button CommandName Example</title>
<script runat="server">
Sub CommandBtn_Click(sender As Object, e As CommandEventArgs)
Select e.CommandName
Case "Sort"
' Call the method to sort the list.
Sort_List(CType(e.CommandArgument, String))
Case "Submit"
' Display a message for the Submit button being clicked.
Message.Text = "You clicked the Submit button"
' Test whether the command argument is an empty string ("").
If CType(e.CommandArgument , String) = "" Then
' End the message.
Message.Text &= "."
Else
' Display an error message for the command argument.
Message.Text &= ", however the command argument is not recogized."
End If
Case Else
' The command name is not recognized. Display an error message.
Message.Text = "Command name not recogized."
End Select
End Sub
Sub Sort_List(commandArgument As String)
Select commandArgument
Case "Ascending"
' Insert code to sort the list in ascending order here.
Message.Text = "You clicked the Sort Ascending button."
Case "Descending"
' Insert code to sort the list in descending order here.
Message.Text = "You clicked the Sort Descending button."
Case Else
' The command argument is not recognized. Display an error message.
Message.Text = "Command argument not recogized."
End Select
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Button CommandName Example</h3>
Click on one of the command buttons.
<br /><br />
<asp:Button id="Button1"
Text="Sort Ascending"
CommandName="Sort"
CommandArgument="Ascending"
OnCommand="CommandBtn_Click"
runat="server"/>
<asp:Button id="Button2"
Text="Sort Descending"
CommandName="Sort"
CommandArgument="Descending"
OnCommand="CommandBtn_Click"
runat="server"/>
<br /><br />
<asp:Button id="Button3"
Text="Submit"
CommandName="Submit"
OnCommand="CommandBtn_Click"
runat="server"/>
<asp:Button id="Button4"
Text="Unknown Command Name"
CommandName="UnknownName"
CommandArgument="UnknownArgument"
OnCommand="CommandBtn_Click"
runat="server"/>
<asp:Button id="Button5"
Text="Submit Unknown Command Argument"
CommandName="Submit"
CommandArgument="UnknownArgument"
OnCommand="CommandBtn_Click"
runat="server"/>
<br /><br />
<asp:Label id="Message" runat="server"/>
</form>
</body>
</html>
Kommentarer
I det här avsnittet:
Introduction
Använd kontrollen Button för att skapa en push-knapp på webbsidan där användarna kan publicera en sida på servern. Kontrollen utlöser en händelse i serverkoden som du kan hantera för att svara på efteråterställningen. Det kan också generera en händelse i klientskriptet som du kan hantera innan sidan publiceras eller som kan köras och sedan avbryta sändningen av sidan.
Note
ASP.NET innehåller flera typer av knappkontroller, som var och en visas på olika sätt på webbsidor. De är Button kontrollen, som återges som en push-knapp; LinkButton kontrollen, som återges som en länk, och ImageButton kontrollen, som återges som en bild, och ImageMap kontrollen, som gör att du kan skapa en bild som har hotspots som användarna kan klicka på. Som standard skickar alla knappkontroller sidan när du klickar. Du kan också använda HtmlButton kontrollerna och HtmlInputButton för att skapa knappar på sidan som kan programmeras i serverkod. Mer information om skillnaderna mellan HTML- och webbserverkontroller finns i ASP.NET Översikt över webbserverkontroller.
Som standard är en Button kontroll en Skicka-knapp. Knappen Skicka har inte något kommandonamn (anges av CommandName egenskapen) som är associerat med knappen och skickar bara tillbaka webbsidan till servern. Du kan ange en händelsehanterare för händelsen för Click att programmatiskt kontrollera de åtgärder som utförs när knappen Skicka klickas.
En kommandoknapp har ett kommandonamn som är associerat med knappen, till exempel Sort, genom att ange CommandName egenskapen . På så sätt kan du skapa flera Button kontroller på en webbsida och programmatiskt avgöra vilken kontroll som Button klickas. Du kan också använda egenskapen CommandArgument med en kommandoknapp för att ange ytterligare information om kommandot som ska utföras, till exempel Ascending. Du kan ange en händelsehanterare för händelsen för Command att programmatiskt kontrollera de åtgärder som utförs när kommandoknappen klickas.
Funktionssätt för knappåterställning och serverhändelser
När en användare klickar på någon knapp för webbserverkontroll skickas sidan till servern. Detta gör att webbsidan bearbetas och väntande händelser genereras i serverbaserad kod. När all sid- och kontrollbearbetning har slutförts återger sig sidan till webbläsaren igen.
Knapparna kan höja sina egna Click händelser eller Command händelser, som du kan hantera med hjälp av serverbaserad kod. Detta skiljer sig från händelser på traditionella HTML-sidor eller i klientbaserade webbprogram, där en knapps onclick händelse hanteras med hjälp av JavaScript som körs i klienten. Mer information finns i ASP.NET Web Forms Server Control Event Model.
När användarna klickar på en knappkontroll publiceras sidan tillbaka till servern. Som standard publiceras sidan tillbaka till sig själv,
Du kan konfigurera knappar för att publicera den aktuella sidan på en annan sida. Detta kan vara användbart för att skapa formulär med flera sidor. Mer information finns i Cross-Page Posting i ASP.NET Web Forms.
Hantera knapphändelser i klientskript
Knappkontroller kan generera både serverhändelser och klienthändelser. Serverhändelser inträffar efter postback och de hanteras i den kod på serversidan som du skriver för sidan. Klienthändelser hanteras i klientskriptet, vanligtvis ECMAScript (JavaScript), och genereras innan sidan skickas. Genom att lägga till händelser på klientsidan i ASP.NET knappkontroller kan du utföra uppgifter som att visa bekräftelsedialogrutor innan du skickar sidan och eventuellt avbryta sändningen. Mer information finns i Client Script in ASP.NET Web Pages and How to: Respond to Button Web Server Control Events in Client Script.
Du kanske också vill Button att kontrollen även ska använda klientskriptet för att utföra återanropet (i stället för att helt enkelt utföra en HTTP POST-åtgärd). Detta kan vara användbart om du vill ändra postback-posten programmatiskt, till exempel koppla den till andra element på sidan. Du kan ange att Button kontrollens UseSubmitBehavior egenskap true ska göra Button så att kontrollen använder klientskriptbaserad postback.
Knappkontroller och validering
Om en sida innehåller ASP.NET valideringskontroller gör ett klick på en knappkontroll som standard att valideringskontrollen utför kontrollen. Om validering på klientsidan är aktiverat för en valideringskontroll skickas inte sidan om en verifieringskontroll har misslyckats.
I följande tabell beskrivs de egenskaper som stöds av knappkontroller som gör att du kan styra valideringsprocessen mer exakt.
| Fastighet | Description |
|---|---|
| CausesValidation | Anger om du även utför en valideringskontroll genom att klicka på knappen. Ställ in den här egenskapen på false för att förhindra en valideringskontroll. |
| ValidationGroup | Gör att du kan ange vilka validerare på sidan som anropas när knappen klickas. Om inga valideringsgrupper har upprättats anropar en knappklick alla validatorer som finns på sidan. |
Mer information finns i Validating User Input in in ASP.NET Web Pages.
Knappar i datakontroller
Knappwebbserverkontroller används ofta i datakontroller, till exempel i DataListkontrollerna , GridViewoch Repeater i listan. I dessa fall svarar du vanligtvis inte direkt på knappklickshändelsen. I stället genererar en knapp i en datakontroll en händelse som är specifik för datakontrollen. I kontrollen kan till exempel DataList en knapp höja DataList kontrollens ItemCommand händelse i stället för att Button höja kontrollens Click händelse.
Eftersom databundna listkontroller kan innehålla många knappar kan du ange knappens egenskap för att ange ett värde som ska skickas CommandArgument som en del av händelsen. Du kan sedan testa för det här argumentet för att se vilken knapp som klickades.
Binda data till kontrollerna
Du kan binda knappen Webbserverkontroller till en datakälla för att styra deras egenskapsinställningar dynamiskt. Du kan till exempel ange en knapps Text egenskap med hjälp av databindning.
Använda knappar med UpdatePanel-kontroller
Partiell återgivning av sidor gör det möjligt att uppdatera delar av en sida utan tillbakablick. UpdatePanel med kontroller kan du markera delar av sidan som deltar i delvis sidåtergivning. Som standard är beteendet för kontroller i en UpdatePanel kontroll, inklusive Button kontroller, att utföra en asynkron postback i stället för en postback. Detta uppdaterar endast innehållet i kontrollen UpdatePanel som postbacken kommer från.
Förutom scenariot med en Button kontroll som finns i en UpdatePanel kontroll kan du använda Button kontroller med UpdatePanel kontroller i följande scenarier:
Definiera en Button kontroll som ligger utanför en UpdatePanel kontroll som en AsyncPostBackTrigger kontroll för panelen. När knappen klickas utför den en asynkron postback och uppdaterar innehållet i panelen.
Definiera en Button kontroll som finns i en UpdatePanel kontroll som en PostBackTrigger för panelen. När knappen klickas utför den ett återanrop trots att den finns i en UpdatePanel kontroll.
Mer information om delvis sidåtergivning och användning av UpdatePanel kontroller finns i Översikt över UpdatePanel-kontroll och Partial-Page Renderingsöversikt.
Deklarativ syntax
<asp:Button
AccessKey="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
CausesValidation="True|False"
CommandArgument="string"
CommandName="string"
CssClass="string"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
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"
OnClientClick="string"
OnCommand="Command event handler"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
PostBackUrl="uri"
runat="server"
SkinID="string"
Style="string"
TabIndex="integer"
Text="string"
ToolTip="string"
UseSubmitBehavior="True|False"
ValidationGroup="string"
Visible="True|False"
Width="size"
/>
Konstruktorer
| Name | Description |
|---|---|
| Button() |
Initierar en ny instans av Button 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) |
| 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) |
| 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) |
| CausesValidation |
Hämtar eller anger ett värde som anger om verifieringen utförs när Button kontrollen klickas. |
| 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) |
| CommandArgument |
Hämtar eller anger en valfri parameter som skickas Command till händelsen tillsammans med den associerade CommandName. |
| CommandName |
Hämtar eller anger det kommandonamn som är associerat med den Button kontroll som skickas till Command händelsen. |
| Context |
Hämtar objektet HttpContext som är associerat med serverkontrollen för den aktuella webbbegäran. (Ärvd från Control) |
| Controls |
Hämtar ett ControlCollection objekt som representerar de underordnade kontrollerna för en angiven serverkontroll i användargränssnittshierarkin. (Ärvd från Control) |
| ControlStyle |
Hämtar formatmallen för webbserverkontrollen. Den här egenskapen används främst av kontrollutvecklare. (Ärvd från WebControl) |
| ControlStyleCreated |
Hämtar ett värde som anger om ett Style objekt har skapats för egenskapen ControlStyle . Den här egenskapen används främst av kontrollutvecklare. (Ärvd från WebControl) |
| CssClass |
Hämtar eller anger css-klassen (Cascading Style Sheet) som återges av webbserverkontrollen på klienten. (Ärvd från WebControl) |
| DataItemContainer |
Hämtar en referens till namngivningscontainern om namngivningscontainern implementerar IDataItemContainer. (Ärvd från Control) |
| DataKeysContainer |
Hämtar en referens till namngivningscontainern om namngivningscontainern implementerar IDataKeysControl. (Ärvd från Control) |
| DesignMode |
Hämtar ett värde som anger om en kontroll används på en designyta. (Ärvd från Control) |
| 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) |
| 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) |
| IsChildControlStateCleared |
Hämtar ett värde som anger om kontroller i den här kontrollen har kontrolltillstånd. (Ärvd från Control) |
| IsEnabled |
Hämtar ett värde som anger om kontrollen är aktiverad. (Ärvd från WebControl) |
| IsTrackingViewState |
Hämtar ett värde som anger om serverkontrollen sparar ändringar i visningstillståndet. (Ärvd från Control) |
| IsViewStateEnabled |
Hämtar ett värde som anger om visningstillstånd är aktiverat för den här kontrollen. (Ärvd från Control) |
| LoadViewStateByID |
Hämtar ett värde som anger om kontrollen deltar i inläsningen av dess visningstillstånd i ID stället för index. (Ärvd från Control) |
| NamingContainer |
Hämtar en referens till serverkontrollens namngivningscontainer, vilket skapar ett unikt namnområde för differentiering mellan serverkontroller med samma ID egenskapsvärde. (Ärvd från Control) |
| OnClientClick |
Hämtar eller anger skriptet på klientsidan som körs när en Button kontrolls händelse aktiveras Click . |
| 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) |
| PostBackUrl |
Hämtar eller anger url:en för sidan som ska skickas till från den aktuella sidan när Button kontrollen klickas. |
| RenderingCompatibility |
Hämtar ett värde som anger den ASP.NET version som renderad HTML kommer att vara kompatibel med. (Ärvd från Control) |
| Site |
Hämtar information om containern som är värd för den aktuella kontrollen när den återges på en designyta. (Ärvd från Control) |
| SkinID |
Hämtar eller ställer in huden för att applicera på kontrollen. (Ärvd från WebControl) |
| Style |
Hämtar en samling textattribut som återges som ett formatattribut på den yttre taggen för webbserverkontrollen. (Ärvd från WebControl) |
| SupportsDisabledAttribute |
Hämtar ett värde som anger om kontrollen ska ange |
| 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) |
| Text |
Hämtar eller anger textrubriken Button som visas i 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) |
| UseSubmitBehavior |
Hämtar eller anger ett värde som anger om Button-kontrollen använder klientwebbläsarens sändningsmekanism eller ASP.NET efteråterställningsmekanism. |
| 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 Button kontrollen orsakar validering för när den skickas tillbaka till servern. |
| 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 kontrollens Button attribut i utdataströmmen för återgivning på klienten. |
| 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) |
| CopyBaseAttributes(WebControl) |
Kopierar egenskaperna som inte kapslas in av Style objektet från den angivna webbserverkontrollen till den webbserverkontroll som den här metoden anropas från. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl) |
| CreateChildControls() |
Anropas av det ASP.NET sidramverket för att meddela serverkontroller som använder kompositionsbaserad implementering för att skapa underordnade kontroller som de innehåller som förberedelse för att publicera tillbaka eller återge. (Ärvd från Control) |
| CreateControlCollection() |
Skapar ett nytt ControlCollection objekt som innehåller de underordnade kontrollerna (både literal och server) för serverkontrollen. (Ärvd från Control) |
| CreateControlStyle() |
Skapar formatobjektet som används internt av WebControl klassen för att implementera alla formatrelaterade egenskaper. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl) |
| DataBind() |
Binder en datakälla till den anropade serverkontrollen och alla dess underordnade kontroller. (Ärvd från Control) |
| 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 |
| FindControl(String) |
Söker i den aktuella namngivningscontainern efter en serverkontroll med den angivna |
| 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) |
| GetPostBackOptions() |
Skapar ett PostBackOptions objekt som representerar Button kontrollens postback-beteende. |
| 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) |
| OnClick(EventArgs) | |
| OnCommand(CommandEventArgs) | |
| OnDataBinding(EventArgs) |
Genererar händelsen DataBinding . (Ärvd från Control) |
| OnInit(EventArgs) |
Genererar händelsen Init . (Ärvd från Control) |
| OnLoad(EventArgs) |
Genererar händelsen Load . (Ärvd från Control) |
| OnPreRender(EventArgs) |
Avgör om knappen har klickats på innan återgivningen på klienten. |
| 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) |
| RaisePostBackEvent(String) |
Genererar händelser för kontrollen när den Button 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) |
Renderar kontrollen till den angivna HTML-skrivaren. (Ärvd från WebControl) |
| 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) |
| 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. |
| 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 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) |
| 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. (Ärvd från WebControl) |
Händelser
| Name | Description |
|---|---|
| Click |
Inträffar när Button kontrollen klickas. |
| Command |
Inträffar när Button kontrollen klickas. |
| 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) |
| 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) |
Genererar händelser för kontrollen när den Button skickas tillbaka till servern. |
Tilläggsmetoder
| Name | Description |
|---|---|
| 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. |
