LinkButton Klasa

Definicja

Wyświetla kontrolkę przycisku stylu hiperłącza na stronie sieci Web.Displays a hyperlink-style button control on a Web page.

public ref class LinkButton : System::Web::UI::WebControls::WebControl, System::Web::UI::IPostBackEventHandler
public ref class LinkButton : System::Web::UI::WebControls::WebControl, System::Web::UI::IPostBackEventHandler, System::Web::UI::WebControls::IButtonControl
public class LinkButton : System.Web.UI.WebControls.WebControl, System.Web.UI.IPostBackEventHandler
public class LinkButton : System.Web.UI.WebControls.WebControl, System.Web.UI.IPostBackEventHandler, System.Web.UI.WebControls.IButtonControl
type LinkButton = class
    inherit WebControl
    interface IPostBackEventHandler
type LinkButton = class
    inherit WebControl
    interface IButtonControl
    interface IPostBackEventHandler
Public Class LinkButton
Inherits WebControl
Implements IPostBackEventHandler
Public Class LinkButton
Inherits WebControl
Implements IButtonControl, IPostBackEventHandler
Dziedziczenie
Implementuje

Przykłady

Projekt witryny sieci Web programu Visual Studio z kodem źródłowym jest dostępny do załączenia do tego tematu: Pobierz.A Visual Studio Web site project with source code is available to accompany this topic: Download.

Poniższy przykład pokazuje, jak utworzyć LinkButton kontrolkę wyświetlającą tekst w Label kontrolce po kliknięciu łącza.The following example demonstrates how to create a LinkButton control that displays text in a Label control when the link is clicked.

<%@ 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>LinkButton Example</title>
<script language="C#" runat="server">
 
      void LinkButton_Click(Object sender, EventArgs e) 
      {
         Label1.Text="You clicked the link button";
      }
 
   </script>
 
</head>
<body>
 
   <form id="form1" runat="server">

      <h3>LinkButton Example</h3>
 
      <asp:LinkButton id="LinkButton1" 
           Text="Click Me" 
           Font-Names="Verdana" 
           Font-Size="14pt" 
           OnClick="LinkButton_Click" 
           runat="server"/>
         
      <br />
 
      <asp:Label id="Label1" 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>LinkButton Example</title>
<script language="VB" runat="server">
 
      Sub LinkButton_Click(sender As Object, e As EventArgs) 
         Label1.Text = "You clicked the link button"
      End Sub
 
   </script>
 
</head>
<body>
 
   <form id="form1" runat="server">

      <h3>LinkButton Example</h3>
 
      <asp:LinkButton id="LinkButton1" 
           Text="Click Me" 
           Font-Names="Verdana" 
           Font-Size="14pt" 
           OnClick="LinkButton_Click" 
           runat="server"/>
         
      <br />
 
      <asp:Label id="Label1" runat="server" />
         
   </form>
 
</body>
</html>

Uwagi

W tym temacie:In this topic:

WprowadzenieIntroduction

Użyj LinkButton kontrolki, aby utworzyć przycisk stylu hiperłącze na stronie sieci Web.Use the LinkButton control to create a hyperlink-style button on the Web page. LinkButtonKontrolka ma taki sam wygląd jak HyperLink kontrolka, ale ma taką samą funkcjonalność jak Button kontrolka.The LinkButton control has the same appearance as a HyperLink control, but has the same functionality as a Button control. Jeśli chcesz połączyć się z inną stroną sieci Web po kliknięciu kontrolki, rozważ użycie HyperLink kontrolki.If you want to link to another Web page when the control is clicked, consider using the HyperLink control.

Uwaga

LinkButtonKontrolka renderuje JavaScript w przeglądarce klienta.The LinkButton control renders JavaScript to the client browser. Aby ta kontrolka działała prawidłowo, przeglądarka klienta musi mieć włączoną obsługę języka JavaScript.The client browser must have JavaScript enabled for this control to function properly. Aby uzyskać więcej informacji na temat skryptu klienta, zobacz skrypt klienta na stronach sieci Web ASP.NET.For more information on client script, see Client Script in ASP.NET Web Pages.

Można utworzyć przycisk Prześlij lub przycisk polecenia.You can create either a Submit button or a Command button. Z przyciskiem przesyłania nie jest skojarzona nazwa polecenia.A Submit button does not have a command name associated with it. Przycisk po prostu zapisuje stronę sieci Web z powrotem na serwerze.The button simply posts the Web page back to the server. Domyślnie LinkButton formant jest przyciskiem przesyłania.By default, a LinkButton control is a Submit button. Możesz dostarczyć program obsługi zdarzeń dla zdarzenia, Click Aby programowo kontrolować akcje wykonywane po kliknięciu przycisku Prześlij.You can provide an event handler for the Click event to programmatically control the actions performed when the Submit button is clicked. Z drugiej strony przycisk polecenia ma nazwę polecenia skojarzoną z przyciskiem, np Sort ..On the other hand, a Command button has a command name associated with the button, such as Sort. Ustaw CommandName Właściwość, aby określić nazwę polecenia.Set the CommandName property to specify the command name. Pozwala to na utworzenie wielu LinkButton formantów na stronie sieci Web i programowo określenie, która LinkButton kontrolka została kliknięta.This allows you to create multiple LinkButton controls on a Web page and programmatically determine which LinkButton control is clicked. Możesz również użyć CommandArgument właściwości z przyciskiem polecenia, aby podać dodatkowe informacje o poleceniu, takie jak określanie kolejności rosnącej.You can also use the CommandArgument property with a Command button to provide additional information about the command to perform, such as specifying ascending order. Można również udostępnić program obsługi zdarzeń dla zdarzenia, Command Aby programowo kontrolować akcję wykonywaną po kliknięciu przycisku polecenia.You can also provide an event handler for the Command event to programmatically control the action performed when the Command button is clicked.

Przestroga

Ta kontrolka może służyć do wyświetlania danych wejściowych użytkownika, co może obejmować złośliwy skrypt klienta.This control can be used to display user input, which might include malicious client script. Tekst nie jest zakodowany w formacie HTML, zanim zostanie wyświetlony w LinkButton kontrolce.Text is not HTML encoded before it is displayed in the LinkButton control. Sprawdź wszystkie informacje wysyłane z klienta pod kątem skryptu wykonywalnego, instrukcji SQL lub innego kodu przed wyświetleniem go w aplikacji.Check any information that is sent from a client for executable script, SQL statements, or other code before displaying it in your application. ASP.NET udostępnia funkcję walidacji żądania wejścia, aby blokować skrypt i kod HTML w danych wejściowych użytkownika.ASP.NET provides an input request validation feature to block script and HTML in user input. Kontrolki serwera weryfikacji są również udostępniane do oceny danych wejściowych użytkownika.Validation server controls are also provided to assess user input. Aby uzyskać więcej informacji, zobacz składnia kontroli serwera walidacji.For more information, see Validation Server Control Syntax.

Kontrolki element LinkButton i walidacjaLinkButton Controls and Validation

Domyślnie Walidacja strony jest wykonywana po LinkButton kliknięciu kontrolki.By default, page validation is performed when a LinkButton control is clicked. Walidacja strony określa, czy kontrolki wejściowe skojarzone z kontrolką walidacji na stronie wszystkie przekazują reguły walidacji określone przez kontrolkę walidacji.Page validation determines whether the input controls associated with a validation control on the page all pass the validation rules specified by the validation control. Aby zapobiec występowaniu walidacji strony, należy ustawić CausesValidation Właściwość na false .To prevent page validation from occurring, set the CausesValidation property to false.

Składnia deklaracyjnaDeclarative Syntax

<asp:LinkButton
    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"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
/>

Konstruktory

LinkButton()

Inicjuje nowe wystąpienie klasy LinkButton.Initializes a new instance of the LinkButton class.

Właściwości

AccessKey

Pobiera lub ustawia klucz dostępu, który umożliwia szybkie przejście do kontrolki serwera sieci Web.Gets or sets the access key that allows you to quickly navigate to the Web server control.

(Odziedziczone po WebControl)
Adapter

Pobiera kartę specyficzną dla przeglądarki dla kontrolki.Gets the browser-specific adapter for the control.

(Odziedziczone po Control)
AppRelativeTemplateSourceDirectory

Pobiera lub ustawia katalog wirtualny względem aplikacji Page lub UserControl obiekt, który zawiera tę kontrolkę.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Odziedziczone po Control)
Attributes

Pobiera kolekcję dowolnych atrybutów (tylko do renderowania), które nie odpowiadają właściwościom kontrolki.Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(Odziedziczone po WebControl)
BackColor

Pobiera lub ustawia kolor tła kontrolki serwera sieci Web.Gets or sets the background color of the Web server control.

(Odziedziczone po WebControl)
BindingContainer

Pobiera formant, który zawiera powiązanie danych tego formantu.Gets the control that contains this control's data binding.

(Odziedziczone po Control)
BorderColor

Pobiera lub ustawia kolor obramowania kontrolki sieci Web.Gets or sets the border color of the Web control.

(Odziedziczone po WebControl)
BorderStyle

Pobiera lub ustawia styl obramowania kontrolki serwera sieci Web.Gets or sets the border style of the Web server control.

(Odziedziczone po WebControl)
BorderWidth

Pobiera lub ustawia szerokość obramowania kontrolki serwera sieci Web.Gets or sets the border width of the Web server control.

(Odziedziczone po WebControl)
CausesValidation

Pobiera lub ustawia wartość wskazującą, czy Walidacja jest wykonywana po LinkButton kliknięciu kontrolki.Gets or sets a value indicating whether validation is performed when the LinkButton control is clicked.

ChildControlsCreated

Pobiera wartość wskazującą, czy zostały utworzone formanty podrzędne kontrolki serwera.Gets a value that indicates whether the server control's child controls have been created.

(Odziedziczone po Control)
ClientID

Pobiera identyfikator formantu dla znacznika HTML, który jest generowany przez ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Odziedziczone po Control)
ClientIDMode

Pobiera lub ustawia algorytm używany do generowania wartości ClientID właściwości.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Odziedziczone po Control)
ClientIDSeparator

Pobiera wartość znaku reprezentującą znak separatora używany we ClientID właściwości.Gets a character value representing the separator character used in the ClientID property.

(Odziedziczone po Control)
CommandArgument

Pobiera lub ustawia opcjonalny argument przesłany do Command procedury obsługi zdarzeń wraz z skojarzoną CommandName właściwością.Gets or sets an optional argument passed to the Command event handler along with the associated CommandName property.

CommandName

Pobiera lub ustawia nazwę polecenia skojarzoną z LinkButton kontrolką.Gets or sets the command name associated with the LinkButton control. Ta wartość jest przenoszona do Command programu obsługi zdarzeń wraz z CommandArgument właściwością.This value is passed to the Command event handler along with the CommandArgument property.

Context

Pobiera HttpContext obiekt skojarzony z kontrolką serwera dla bieżącego żądania sieci Web.Gets the HttpContext object associated with the server control for the current Web request.

(Odziedziczone po Control)
Controls

Pobiera ControlCollection obiekt reprezentujący kontrolki podrzędne dla określonej kontrolki serwera w hierarchii interfejsu użytkownika.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

(Odziedziczone po Control)
ControlStyle

Pobiera styl kontrolki serwera sieci Web.Gets the style of the Web server control. Ta właściwość jest używana głównie przez deweloperów kontroli.This property is used primarily by control developers.

(Odziedziczone po WebControl)
ControlStyleCreated

Pobiera wartość wskazującą, czy Style obiekt został utworzony dla ControlStyle właściwości.Gets a value indicating whether a Style object has been created for the ControlStyle property. Ta właściwość jest używana głównie przez deweloperów kontroli.This property is primarily used by control developers.

(Odziedziczone po WebControl)
CssClass

Pobiera lub ustawia klasę kaskadowego arkusza stylów (CSS) renderowaną przez formant serwera sieci Web na kliencie.Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.

(Odziedziczone po WebControl)
DataItemContainer

Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa jest zaimplementowany IDataItemContainer .Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Odziedziczone po Control)
DataKeysContainer

Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa jest zaimplementowany IDataKeysControl .Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Odziedziczone po Control)
DesignMode

Pobiera wartość wskazującą, czy kontrolka jest używana na powierzchni projektowej.Gets a value indicating whether a control is being used on a design surface.

(Odziedziczone po Control)
Enabled

Pobiera lub ustawia wartość wskazującą, czy formant serwera sieci Web jest włączony.Gets or sets a value indicating whether the Web server control is enabled.

(Odziedziczone po WebControl)
EnableTheming

Pobiera lub ustawia wartość wskazującą, czy motywy stosują się do tej kontrolki.Gets or sets a value indicating whether themes apply to this control.

(Odziedziczone po WebControl)
EnableViewState

Pobiera lub ustawia wartość wskazującą, czy formant serwera utrzymuje stan widoku, oraz stan widoku wszystkich formantów podrzędnych, które zawiera, do żądającego klienta.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Odziedziczone po Control)
Events

Pobiera listę delegatów obsługi zdarzeń dla formantu.Gets a list of event handler delegates for the control. Ta właściwość jest tylko do odczytu.This property is read-only.

(Odziedziczone po Control)
Font

Pobiera właściwości czcionki skojarzone z kontrolką serwera sieci Web.Gets the font properties associated with the Web server control.

(Odziedziczone po WebControl)
ForeColor

Pobiera lub ustawia kolor pierwszego planu (zazwyczaj kolor tekstu) kontrolki serwera sieci Web.Gets or sets the foreground color (typically the color of the text) of the Web server control.

(Odziedziczone po WebControl)
HasAttributes

Pobiera wartość wskazującą, czy kontrolka ma ustawione atrybuty.Gets a value indicating whether the control has attributes set.

(Odziedziczone po WebControl)
HasChildViewState

Pobiera wartość wskazującą, czy bieżące kontrolki formantu serwera mają jakiekolwiek zapisane ustawienia stanu widoku.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Odziedziczone po Control)
Height

Pobiera lub ustawia wysokość kontrolki serwera sieci Web.Gets or sets the height of the Web server control.

(Odziedziczone po WebControl)
ID

Pobiera lub ustawia identyfikator programowy przypisany do kontrolki serwerowej.Gets or sets the programmatic identifier assigned to the server control.

(Odziedziczone po Control)
IdSeparator

Pobiera znak używany do oddzielania identyfikatorów kontroli.Gets the character used to separate control identifiers.

(Odziedziczone po Control)
IsChildControlStateCleared

Pobiera wartość wskazującą, czy kontrolki zawarte w tym formancie mają stan kontroli.Gets a value indicating whether controls contained within this control have control state.

(Odziedziczone po Control)
IsEnabled

Pobiera wartość wskazującą, czy kontrolka jest włączona.Gets a value indicating whether the control is enabled.

(Odziedziczone po WebControl)
IsTrackingViewState

Pobiera wartość wskazującą, czy formant serwera zapisuje zmiany w stanie widoku.Gets a value that indicates whether the server control is saving changes to its view state.

(Odziedziczone po Control)
IsViewStateEnabled

Pobiera wartość wskazującą, czy stan widoku jest włączony dla tego formantu.Gets a value indicating whether view state is enabled for this control.

(Odziedziczone po Control)
LoadViewStateByID

Pobiera wartość wskazującą, czy formant uczestniczy w ładowaniu stanu widoku przez ID zamianę na indeks.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Odziedziczone po Control)
NamingContainer

Pobiera odwołanie do kontenera nazw kontrolki serwera, który tworzy unikatową przestrzeń nazw do rozróżniania między kontrolkami serwera z tą samą ID wartością właściwości.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Odziedziczone po Control)
OnClientClick

Pobiera lub ustawia skrypt po stronie klienta, który jest wykonywany po LinkButton Click wywołaniu zdarzenia kontrolki.Gets or sets the client-side script that executes when a LinkButton control's Click event is raised.

Page

Pobiera odwołanie do Page wystąpienia, które zawiera formant serwera.Gets a reference to the Page instance that contains the server control.

(Odziedziczone po Control)
Parent

Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii formantów strony.Gets a reference to the server control's parent control in the page control hierarchy.

(Odziedziczone po Control)
PostBackUrl

Pobiera lub ustawia adres URL strony do opublikowania na bieżącej stronie, gdy LinkButton formant zostanie kliknięty.Gets or sets the URL of the page to post to from the current page when the LinkButton control is clicked.

RenderingCompatibility

Pobiera wartość określającą ASP.NET wersję, która będzie zgodna z językiem HTML.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Odziedziczone po Control)
Site

Pobiera informacje o kontenerze, który hostuje bieżącą kontrolkę, gdy jest renderowany na powierzchni projektowej.Gets information about the container that hosts the current control when rendered on a design surface.

(Odziedziczone po Control)
SkinID

Pobiera lub ustawia skórkę, która ma zostać zastosowana do kontrolki.Gets or sets the skin to apply to the control.

(Odziedziczone po WebControl)
Style

Pobiera kolekcję atrybutów tekstu, które będą renderowane jako atrybut stylu na zewnętrznym tagu kontrolki serwera sieci Web.Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(Odziedziczone po WebControl)
SupportsDisabledAttribute

Pobiera wartość wskazującą, czy formant powinien ustawić disabled atrybut renderowanego elementu HTML na "Disabled", gdy właściwość kontrolki IsEnabled ma wartość false .Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

SupportsDisabledAttribute

Pobiera wartość wskazującą, czy formant powinien ustawić disabled atrybut renderowanego elementu HTML na "Disabled", gdy właściwość kontrolki IsEnabled ma wartość false .Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

(Odziedziczone po WebControl)
TabIndex

Pobiera lub ustawia indeks karty dla kontrolki serwer sieci Web.Gets or sets the tab index of the Web server control.

(Odziedziczone po WebControl)
TagKey

Pobiera HtmlTextWriterTag wartość odpowiadającą tej kontrolce serwera sieci Web.Gets the HtmlTextWriterTag value that corresponds to this Web server control. Ta właściwość jest używana głównie przez deweloperów kontroli.This property is used primarily by control developers.

(Odziedziczone po WebControl)
TagName

Pobiera nazwę tagu kontrolki.Gets the name of the control tag. Ta właściwość jest używana głównie przez deweloperów kontroli.This property is used primarily by control developers.

(Odziedziczone po WebControl)
TemplateControl

Pobiera lub ustawia odwołanie do szablonu, który zawiera tę kontrolkę.Gets or sets a reference to the template that contains this control.

(Odziedziczone po Control)
TemplateSourceDirectory

Pobiera katalog wirtualny Page lub zawierający UserControl bieżącą kontrolkę serwerową.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Odziedziczone po Control)
Text

Pobiera lub ustawia napis tekstowy wyświetlany w LinkButton kontrolce.Gets or sets the text caption displayed on the LinkButton control.

ToolTip

Pobiera lub ustawia tekst wyświetlany, gdy wskaźnik myszy znajduje się nad kontrolką serwera sieci Web.Gets or sets the text displayed when the mouse pointer hovers over the Web server control.

(Odziedziczone po WebControl)
UniqueID

Pobiera unikatowy, hierarchicznie kwalifikowany identyfikator dla kontrolki serwerowej.Gets the unique, hierarchically qualified identifier for the server control.

(Odziedziczone po Control)
ValidateRequestMode

Pobiera lub ustawia wartość wskazującą, czy formant sprawdza dane wejściowe klienta z przeglądarki pod kątem potencjalnie niebezpiecznych wartości.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Odziedziczone po Control)
ValidationGroup

Pobiera lub ustawia grupę kontrolek, dla których LinkButton formant powoduje uruchomienie walidacji, gdy odsyła na serwer.Gets or sets the group of controls for which the LinkButton control causes validation when it posts back to the server.

ViewState

Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu widoku kontrolki serwera w wielu żądaniach na tej samej stronie.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Odziedziczone po Control)
ViewStateIgnoresCase

Pobiera wartość wskazującą, czy w StateBag obiekcie nie jest rozróżniana wielkość liter.Gets a value that indicates whether the StateBag object is case-insensitive.

(Odziedziczone po Control)
ViewStateMode

Pobiera lub ustawia tryb widoku stanu tego formantu.Gets or sets the view-state mode of this control.

(Odziedziczone po Control)
Visible

Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera jest renderowana jako interfejs użytkownika na stronie.Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(Odziedziczone po Control)
Width

Pobiera lub ustawia szerokość kontrolki serwera sieci Web.Gets or sets the width of the Web server control.

(Odziedziczone po WebControl)

Metody

AddAttributesToRender(HtmlTextWriter)

Dodaje atrybuty LinkButton kontrolki do strumienia wyjściowego w celu renderowania na kliencie.Adds the attributes of the LinkButton control to the output stream for rendering on the client.

AddedControl(Control, Int32)

Wywołuje się po dodaniu formantu podrzędnego do Controls kolekcji Control obiektu.Called after a child control is added to the Controls collection of the Control object.

(Odziedziczone po Control)
AddParsedSubObject(Object)

Powiadamia formant o przeanalizowaniu elementu, XML lub HTML, a następnie dodaje element do ControlCollection obiektu formantu.Notifies the control that an element, either XML or HTML, was parsed, and adds the element to the control's ControlCollection object.

ApplyStyle(Style)

Kopiuje wszystkie niepuste elementy określonego stylu do kontrolki sieci Web, zastępując wszelkie istniejące elementy stylu formantu.Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. Ta metoda jest używana głównie przez deweloperów kontroli.This method is primarily used by control developers.

(Odziedziczone po WebControl)
ApplyStyleSheetSkin(Page)

Stosuje właściwości stylu zdefiniowane w arkuszu stylów strony do kontrolki.Applies the style properties defined in the page style sheet to the control.

(Odziedziczone po Control)
BeginRenderTracing(TextWriter, Object)

Rozpoczyna śledzenie danych renderowania w czasie projektowania.Begins design-time tracing of rendering data.

(Odziedziczone po Control)
BuildProfileTree(String, Boolean)

Zbiera informacje o formancie serwera i dostarcza go do Trace właściwości, która będzie wyświetlana po włączeniu śledzenia dla strony.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Odziedziczone po Control)
ClearCachedClientID()

Ustawia wartość w pamięci podręcznej ClientID na null .Sets the cached ClientID value to null.

(Odziedziczone po Control)
ClearChildControlState()

Usuwa informacje o stanie formantu dla kontrolek podrzędnych kontrolki serwerowej.Deletes the control-state information for the server control's child controls.

(Odziedziczone po Control)
ClearChildState()

Usuwa informacje o stanie widoku i kontroli dla wszystkich formantów podrzędnych formantu serwera.Deletes the view-state and control-state information for all the server control's child controls.

(Odziedziczone po Control)
ClearChildViewState()

Usuwa informacje o stanie widoku dla wszystkich formantów podrzędnych formantu serwera.Deletes the view-state information for all the server control's child controls.

(Odziedziczone po Control)
ClearEffectiveClientIDMode()

Ustawia ClientIDMode Właściwość bieżącego wystąpienia kontrolki i wszystkich formantów podrzędnych na Inherit .Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Odziedziczone po Control)
CopyBaseAttributes(WebControl)

Kopiuje właściwości, które nie są hermetyzowane przez Style obiekt z określonej kontrolki serwera sieci Web do kontrolki serwera sieci Web, z której ta metoda jest wywoływana.Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. Ta metoda jest używana głównie przez deweloperów kontroli.This method is used primarily by control developers.

(Odziedziczone po WebControl)
CreateChildControls()

Wywoływane przez platformę strony ASP.NET w celu powiadomienia formantów serwera, które używają implementacji opartej na kompozycjach, do tworzenia wszelkich formantów podrzędnych, które zawierają w przygotowaniu do ponownego ogłaszania lub renderowania.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

(Odziedziczone po Control)
CreateControlCollection()

Tworzy nowy ControlCollection obiekt do przechowywania formantów podrzędnych (zarówno literału, jak i serwera) formantu serwera.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Odziedziczone po Control)
CreateControlStyle()

Tworzy obiekt Style, który jest używany wewnętrznie przez WebControl klasę do implementowania wszystkich właściwości związanych z stylem.Creates the style object that is used internally by the WebControl class to implement all style related properties. Ta metoda jest używana głównie przez deweloperów kontroli.This method is used primarily by control developers.

(Odziedziczone po WebControl)
DataBind()

Tworzy powiązanie źródła danych z wywołaną kontrolką serwera i wszystkimi jego kontrolkami podrzędnymi.Binds a data source to the invoked server control and all its child controls.

(Odziedziczone po Control)
DataBind(Boolean)

Tworzy powiązanie źródła danych z wywoływanym formantem serwera i wszystkimi jego kontrolkami podrzędnymi z opcją podniesienia poziomu DataBinding zdarzenia.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Odziedziczone po Control)
DataBindChildren()

Tworzy powiązanie źródła danych z kontrolkami podrzędnymi formantu serwera.Binds a data source to the server control's child controls.

(Odziedziczone po Control)
Dispose()

Umożliwia formantowi serwera przeprowadzenie końcowego oczyszczania przed jego zwolnieniem z pamięci.Enables a server control to perform final clean up before it is released from memory.

(Odziedziczone po Control)
EndRenderTracing(TextWriter, Object)

Przerywa śledzenie danych renderowania w czasie projektowania.Ends design-time tracing of rendering data.

(Odziedziczone po Control)
EnsureChildControls()

Określa, czy formant serwera zawiera kontrolki podrzędne.Determines whether the server control contains child controls. Jeśli tak nie jest, tworzy kontrolki podrzędne.If it does not, it creates child controls.

(Odziedziczone po Control)
EnsureID()

Tworzy identyfikator dla kontrolek, które nie mają przypisanego identyfikatora.Creates an identifier for controls that do not have an identifier assigned.

(Odziedziczone po Control)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
FindControl(String)

Wyszukuje w bieżącym kontenerze nazewnictwa dla kontrolki serwera z określonym id parametrem.Searches the current naming container for a server control with the specified id parameter.

(Odziedziczone po Control)
FindControl(String, Int32)

Wyszukuje w bieżącym kontenerze nazewnictwa dla kontrolki serwera z określoną id i liczbą całkowitą, która jest określona w pathOffset parametrze, który ułatwia wyszukiwanie.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Nie należy przesłaniać tej wersji FindControl metody.You should not override this version of the FindControl method.

(Odziedziczone po Control)
Focus()

Ustawia fokus wprowadzania dla kontrolki.Sets input focus to a control.

(Odziedziczone po Control)
GetDesignModeState()

Pobiera dane czasu projektowania dla kontrolki.Gets design-time data for a control.

(Odziedziczone po Control)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetPostBackOptions()

Tworzy PostBackOptions obiekt, który reprezentuje LinkButton zachowanie ogłaszania zwrotnego kontrolki.Creates a PostBackOptions object that represents the LinkButton control's postback behavior.

GetRouteUrl(Object)

Pobiera adres URL odpowiadający zestawowi parametrów trasy.Gets the URL that corresponds to a set of route parameters.

(Odziedziczone po Control)
GetRouteUrl(RouteValueDictionary)

Pobiera adres URL odpowiadający zestawowi parametrów trasy.Gets the URL that corresponds to a set of route parameters.

(Odziedziczone po Control)
GetRouteUrl(String, Object)

Pobiera adres URL, który odnosi się do zestawu parametrów trasy i nazwy trasy.Gets the URL that corresponds to a set of route parameters and a route name.

(Odziedziczone po Control)
GetRouteUrl(String, RouteValueDictionary)

Pobiera adres URL, który odnosi się do zestawu parametrów trasy i nazwy trasy.Gets the URL that corresponds to a set of route parameters and a route name.

(Odziedziczone po Control)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
GetUniqueIDRelativeTo(Control)

Zwraca przedznaczoną część UniqueID właściwości określonej kontrolki.Returns the prefixed portion of the UniqueID property of the specified control.

(Odziedziczone po Control)
HasControls()

Określa, czy formant serwera zawiera wszystkie kontrolki podrzędne.Determines if the server control contains any child controls.

(Odziedziczone po Control)
HasEvents()

Zwraca wartość wskazującą czy zdarzenia są rejestrowane dla kontrolki lub wszelkich formantów podrzędnych.Returns a value indicating whether events are registered for the control or any child controls.

(Odziedziczone po Control)
IsLiteralContent()

Określa, czy formant serwera przechowuje tylko zawartość literału.Determines if the server control holds only literal content.

(Odziedziczone po Control)
LoadControlState(Object)

Przywraca informacje o stanie kontroli z poprzedniego żądania strony, które zostało zapisane przez SaveControlState() metodę.Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(Odziedziczone po Control)
LoadViewState(Object)

Przywraca informacje o stanie widoku z poprzedniego żądania, które zostało zapisane przy użyciu SaveViewState() metody.Restores view-state information from a previous request that was saved with the SaveViewState() method.

MapPathSecure(String)

Pobiera ścieżkę fizyczną, do której jest mapowana ścieżka wirtualna (absolutna lub względna).Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Odziedziczone po Control)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MergeStyle(Style)

Kopiuje wszystkie niepuste elementy określonego stylu do kontrolki sieci Web, ale nie zastępuje żadnych istniejących elementów stylu formantu.Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. Ta metoda jest używana głównie przez deweloperów kontroli.This method is used primarily by control developers.

(Odziedziczone po WebControl)
OnBubbleEvent(Object, EventArgs)

Określa, czy zdarzenie dla formantu serwera jest przenoszone do hierarchii kontroli serwera interfejsu użytkownika strony.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Odziedziczone po Control)
OnClick(EventArgs)

Podnosi Click zdarzenie LinkButton formantu.Raises the Click event of the LinkButton control.

OnCommand(CommandEventArgs)

Podnosi Command zdarzenie LinkButton formantu.Raises the Command event of the LinkButton control.

OnDataBinding(EventArgs)

Podnosi DataBinding zdarzenie.Raises the DataBinding event.

(Odziedziczone po Control)
OnInit(EventArgs)

Podnosi Init zdarzenie.Raises the Init event.

(Odziedziczone po Control)
OnLoad(EventArgs)

Podnosi Load zdarzenie.Raises the Load event.

(Odziedziczone po Control)
OnPreRender(EventArgs)

Podnosi PreRender zdarzenie.Raises the PreRender event.

OnUnload(EventArgs)

Podnosi Unload zdarzenie.Raises the Unload event.

(Odziedziczone po Control)
OpenFile(String)

Pobiera informacje Stream używane do odczytu pliku.Gets a Stream used to read a file.

(Odziedziczone po Control)
RaiseBubbleEvent(Object, EventArgs)

Przypisuje wszystkie źródła zdarzenia i informacje do elementu nadrzędnego formantu.Assigns any sources of the event and its information to the control's parent.

(Odziedziczone po Control)
RaisePostBackEvent(String)

Wywołuje zdarzenia dla LinkButton kontrolki, gdy zapisuje je na serwerze.Raises events for the LinkButton control when it posts back to the server.

RemovedControl(Control)

Wywoływana po usunięciu formantu podrzędnego z Controls kolekcji Control obiektu.Called after a child control is removed from the Controls collection of the Control object.

(Odziedziczone po Control)
Render(HtmlTextWriter)

Renderuje formant do określonego składnika zapisywania HTML.Renders the control to the specified HTML writer.

(Odziedziczone po WebControl)
RenderBeginTag(HtmlTextWriter)

Renderuje tag otwierającego HTML kontrolki do określonego składnika zapisywania.Renders the HTML opening tag of the control to the specified writer. Ta metoda jest używana głównie przez deweloperów kontroli.This method is used primarily by control developers.

(Odziedziczone po WebControl)
RenderChildren(HtmlTextWriter)

Wyprowadza zawartość elementu podrzędnego kontrolki serwera do podanego HtmlTextWriter obiektu, który zapisuje zawartość, która ma być renderowana na kliencie.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Odziedziczone po Control)
RenderContents(HtmlTextWriter)

Renderuje zawartość kontrolki do określonego składnika zapisywania.Renders the contents of the control to the specified writer.

RenderControl(HtmlTextWriter)

Wyprowadza zawartość kontrolki serwera do podanego HtmlTextWriter obiektu i przechowuje informacje o śledzeniu dla kontrolki, jeśli śledzenie jest włączone.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Odziedziczone po Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Wyprowadza zawartość kontrolki serwera do podanego HtmlTextWriter obiektu za pomocą podanego ControlAdapter obiektu.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Odziedziczone po Control)
RenderEndTag(HtmlTextWriter)

Renderuje tag zamykający HTML kontrolki do określonego składnika zapisywania.Renders the HTML closing tag of the control into the specified writer. Ta metoda jest używana głównie przez deweloperów kontroli.This method is used primarily by control developers.

(Odziedziczone po WebControl)
ResolveAdapter()

Pobiera adapter sterowania odpowiedzialny za renderowanie określonego formantu.Gets the control adapter responsible for rendering the specified control.

(Odziedziczone po Control)
ResolveClientUrl(String)

Pobiera adres URL, który może być używany przez przeglądarkę.Gets a URL that can be used by the browser.

(Odziedziczone po Control)
ResolveUrl(String)

Konwertuje adres URL na taki, który jest używany na żądającym klienta.Converts a URL into one that is usable on the requesting client.

(Odziedziczone po Control)
SaveControlState()

Zapisuje wszelkie zmiany stanu formantu serwera, które wystąpiły od momentu, gdy strona została opublikowana na serwerze.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(Odziedziczone po Control)
SaveViewState()

Zapisuje wszystkie Stany, które zostały zmodyfikowane po TrackViewState() wywołaniu metody.Saves any state that was modified after the TrackViewState() method was invoked.

(Odziedziczone po WebControl)
SetDesignModeState(IDictionary)

Ustawia dane czasu projektowania dla kontrolki.Sets design-time data for a control.

(Odziedziczone po Control)
SetRenderMethodDelegate(RenderMethod)

Przypisuje delegata programu obsługi zdarzeń, aby renderować formant serwera i jego zawartość w jego formancie nadrzędnym.Assigns an event handler delegate to render the server control and its content into its parent control.

(Odziedziczone po Control)
SetTraceData(Object, Object)

Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu klucza danych śledzenia i wartości danych śledzenia.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Odziedziczone po Control)
SetTraceData(Object, Object, Object)

Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu obiektu śledzenia, klucza danych śledzenia i wartości danych śledzenia.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Odziedziczone po Control)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
TrackViewState()

Powoduje, że formant śledzi zmiany stanu widoku, aby mogły być przechowywane we ViewState właściwości obiektu.Causes the control to track changes to its view state so they can be stored in the object's ViewState property.

(Odziedziczone po WebControl)

Zdarzenia

Click

Występuje, gdy LinkButton formant zostanie kliknięty.Occurs when the LinkButton control is clicked.

Command

Występuje, gdy LinkButton formant zostanie kliknięty.Occurs when the LinkButton control is clicked.

DataBinding

Występuje, gdy formant serwera wiąże się ze źródłem danych.Occurs when the server control binds to a data source.

(Odziedziczone po Control)
Disposed

Występuje, gdy formant serwera zostanie wystawiony z pamięci, który jest ostatnim etapem cyklu życia formantu serwera, gdy zażądano strony ASP.NET.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Odziedziczone po Control)
Init

Występuje po zainicjowaniu formantu serwera, który jest pierwszym krokiem w jego cyklu życia.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Odziedziczone po Control)
Load

Występuje, gdy kontrolka serwera jest załadowana do Page obiektu.Occurs when the server control is loaded into the Page object.

(Odziedziczone po Control)
PreRender

Występuje po Control załadowaniu obiektu, ale przed renderowaniem.Occurs after the Control object is loaded but prior to rendering.

(Odziedziczone po Control)
Unload

Występuje, gdy formant serwera zostanie zwolniony z pamięci.Occurs when the server control is unloaded from memory.

(Odziedziczone po Control)

Jawne implementacje interfejsu

IAttributeAccessor.GetAttribute(String)

Pobiera atrybut kontrolki sieci Web o podanej nazwie.Gets an attribute of the Web control with the specified name.

(Odziedziczone po WebControl)
IAttributeAccessor.SetAttribute(String, String)

Ustawia atrybut formantu sieci Web na określoną nazwę i wartość.Sets an attribute of the Web control to the specified name and value.

(Odziedziczone po WebControl)
IControlBuilderAccessor.ControlBuilder

Aby uzyskać opis tego elementu członkowskiego, zobacz ControlBuilder .For a description of this member, see ControlBuilder.

(Odziedziczone po Control)
IControlDesignerAccessor.GetDesignModeState()

Aby uzyskać opis tego elementu członkowskiego, zobacz GetDesignModeState() .For a description of this member, see GetDesignModeState().

(Odziedziczone po Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Aby uzyskać opis tego elementu członkowskiego, zobacz SetDesignModeState(IDictionary) .For a description of this member, see SetDesignModeState(IDictionary).

(Odziedziczone po Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Aby uzyskać opis tego elementu członkowskiego, zobacz SetOwnerControl(Control) .For a description of this member, see SetOwnerControl(Control).

(Odziedziczone po Control)
IControlDesignerAccessor.UserData

Aby uzyskać opis tego elementu członkowskiego, zobacz UserData .For a description of this member, see UserData.

(Odziedziczone po Control)
IDataBindingsAccessor.DataBindings

Aby uzyskać opis tego elementu członkowskiego, zobacz DataBindings .For a description of this member, see DataBindings.

(Odziedziczone po Control)
IDataBindingsAccessor.HasDataBindings

Aby uzyskać opis tego elementu członkowskiego, zobacz HasDataBindings .For a description of this member, see HasDataBindings.

(Odziedziczone po Control)
IExpressionsAccessor.Expressions

Aby uzyskać opis tego elementu członkowskiego, zobacz Expressions .For a description of this member, see Expressions.

(Odziedziczone po Control)
IExpressionsAccessor.HasExpressions

Aby uzyskać opis tego elementu członkowskiego, zobacz HasExpressions .For a description of this member, see HasExpressions.

(Odziedziczone po Control)
IParserAccessor.AddParsedSubObject(Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz AddParsedSubObject(Object) .For a description of this member, see AddParsedSubObject(Object).

(Odziedziczone po Control)
IPostBackEventHandler.RaisePostBackEvent(String)

Aby uzyskać opis tego elementu członkowskiego, zobacz RaisePostBackEvent(String) .For a description of this member, see RaisePostBackEvent(String).

Metody rozszerzania

FindDataSourceControl(Control)

Zwraca źródło danych skojarzone z kontrolką danych dla określonej kontrolki.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Zwraca szablon pola dla określonej kolumny w kontenerze nazewnictwa określonego formantu.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Zwraca obiekt obiektu z tabeli dla kontrolki zawierającej dane.Returns the metatable object for the containing data control.

Dotyczy

Zobacz też