UserControl Klasa

Definicja

Reprezentuje plik. ascx, nazywany również kontrolką użytkownika, żądaną z serwera, który hostuje aplikację sieci Web ASP.NET.Represents an .ascx file, also known as a user control, requested from a server that hosts an ASP.NET Web application. Plik musi zostać wywołany ze strony formularzy sieci Web lub wystąpił błąd parsera.The file must be called from a Web Forms page or a parser error will occur.

public ref class UserControl : System::Web::UI::TemplateControl, System::Web::UI::IAttributeAccessor, System::Web::UI::IUserControlDesignerAccessor
public class UserControl : System.Web.UI.TemplateControl, System.Web.UI.IAttributeAccessor, System.Web.UI.IUserControlDesignerAccessor
type UserControl = class
    inherit TemplateControl
    interface IAttributeAccessor
    interface IUserControlDesignerAccessor
type UserControl = class
    inherit TemplateControl
    interface IAttributeAccessor
    interface INamingContainer
    interface IUserControlDesignerAccessor
Public Class UserControl
Inherits TemplateControl
Implements IAttributeAccessor, IUserControlDesignerAccessor
Dziedziczenie
Pochodne
Implementuje

Przykłady

Klasa zdefiniowana w poniższym przykładzie, SimpleControl, dziedziczy klasę UserControl i może być używana jako Klasa ASP.NET z kodem.The class defined in the following example, SimpleControl, inherits the UserControl class and can be used as an ASP.NET code-behind class. Używa kontrolek serwer sieci Web TextBox, Labeli Button i definiuje metodę myButton_Click, która przypisuje wartość właściwości TextBox.Text, wraz z dwoma ciągami, do właściwości Label.Text.It uses the TextBox, Label, and Button Web server controls and defines a myButton_Click method that assigns the TextBox.Text property value, along with two strings, to the Label.Text property.

Ważne

Ten przykład zawiera pole tekstowe akceptujące dane wejściowe użytkownika, które jest potencjalnym zagrożeniem bezpieczeństwa.This example has a text box that accepts user input, which is a potential security threat. Domyślnie strony sieci Web ASP.NET sprawdzają, czy dane wejściowe użytkownika nie obejmują elementów skryptu ani HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Aby uzyskać więcej informacji, zobacz Omówienie luk w zabezpieczeniach.For more information, see Script Exploits Overview.

using System;
using System.Web.UI;
using System.Web.UI.WebControls;

public class SimpleControl:UserControl
{

  public TextBox name;
  public Label output;
  public Button myButton;

  public void myButton_Click(object sender, EventArgs e)
  { 
    output.Text = "Hello, " + name.Text + ".";
  }
}
Imports System.Web.UI
Imports System.Web.UI.WebControls


Public Class SimpleControl
   Inherits UserControl
   Public name As TextBox
   Public output As Label
   Public myButton As Button
   
   
   Public Sub myButton_Click(sender As Object, e As EventArgs)

      output.Text = "Hello, " + name.Text + "."

   End Sub  

End Class

Poniższy przykład jest znacznikiem zawartym w pliku. ascx.The following example is markup contained in an .ascx file. Można użyć klasy SimpleControl zdefiniowanej w poprzednim przykładzie jako klasy związanej z kodem dla znaczników w tym pliku. ascx.You can use the SimpleControl class defined in the previous example as a code-behind class for the markup in this .ascx file.

<%@ control inherits = "SimpleControl" src = "SimpleControl.cs" %>

<table style="background-color:yellow;font: 10pt verdana;border-width:1;border-style:solid;border-color:black;" cellspacing="15">
<tr>
<td><b>Enter your name here: </b></td>
<td><ASP:TextBox id="name" runat="server"/></td>
</tr>
<tr>
<td><b><ASP:Label id="output" runat="server"/></b></td>
</tr>
<tr>
<td></td>
<td><asp:button id="myButton" text="Submit" OnClick="myButton_Click" runat="server" /></td>
</tr>
</table>
<%@ control inherits = "SimpleControl" src = "SimpleControl.vb" %>

<table style="background-color: yellow; font: 10pt verdana;border-width:1;border-style:solid;border-color:black;" cellspacing="15">
<tr>
<td><b>Enter your name here: </b></td>
<td><ASP:TextBox id="name" runat="server"/></td>
</tr>
<tr>
<td><b><ASP:Label id="output" runat="server"/></b></td>
</tr>
<tr>
<td></td>
<td><asp:button text="Submit" OnClick="myButton_Click" runat="server" /></td>
</tr>
</table>

Uwagi

Klasa UserControl jest skojarzona z plikami, które mają rozszerzenia. ascx.The UserControl class is associated with files that have .ascx extensions. Te pliki są kompilowane w czasie wykonywania jako UserControl obiektów i buforowanych w pamięci serwera.These files are compiled at run time as UserControl objects and cached in server memory.

Możesz zagnieżdżać kontrolki użytkownika, deklarując jeden plik. ascx w innym, łącznie z drugim na stronie formularzy sieci Web.You can nest user controls by declaring one .ascx file in another including the latter in a Web Forms page.

Formanty użytkownika są zawarte na stronach formularzy sieci Web ASP.NET i oferują deweloperom sieci Web łatwy sposób przechwytywania często używanego interfejsu użytkownika sieci Web.User controls are contained in ASP.NET Web Forms pages, and offer Web developers an easy way to capture commonly used Web UI. Są one tworzone i zapisywane w pamięci podręcznej w sposób podobny do Page obiektów.They are instantiated and cached in ways similar to Page objects. W przeciwieństwie do stron, formanty użytkownika nie mogą być wywoływane niezależnie.Unlike pages, however, user controls cannot be called independently. Mogą być wywoływane tylko ze strony lub innej kontrolki użytkownika, która ją zawiera.They can only be called from the page or other user control that contains them.

Dziedzicz z tej klasy, jeśli chcesz utworzyć kontrolkę użytkownika przy użyciu techniki związanej z kodem.Derive from this class if you want to create a user control using the code-behind technique. Jest to zalecane, jeśli tworzysz strony formularzy sieci Web za pomocą tej techniki.This is recommended if you are developing Web Forms pages using this technique.

Aby uzyskać informacje na temat tworzenia formantów użytkownika w sposób deklaratywny, zobacz ASP.NET User Controls.For information about creating user controls declaratively, see ASP.NET User Controls.

Konstruktory

UserControl()

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

Właściwości

Adapter

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

(Odziedziczone po Control)
Application

Pobiera obiekt Application dla bieżącego żądania sieci Web.Gets the Application object for the current Web request.

AppRelativeTemplateSourceDirectory

Pobiera lub ustawia katalog wirtualny względny dla aplikacji Page lub UserControl obiektu, 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)
AppRelativeVirtualPath

Pobiera lub ustawia ścieżkę katalogu wirtualnego względem aplikacji, z której formant jest analizowany i kompilowany.Gets or sets the application-relative, virtual directory path to the file from which the control is parsed and compiled.

(Odziedziczone po TemplateControl)
Attributes

Pobiera kolekcję wszystkich par nazw atrybutów i wartości zadeklarowanych w tagu kontroli użytkownika w pliku aspx.Gets a collection of all attribute name and value pairs declared in the user control tag within the .aspx file.

AutoHandlers

Właściwość AutoHandlers została uznana za przestarzałą w ASP.NET NET 2,0.The AutoHandlers property has been deprecated in ASP.NET NET 2.0. Jest on używany przez wygenerowane klasy i nie jest przeznaczony do użycia w kodzie.It is used by generated classes and is not intended for use within your code.

(Odziedziczone po TemplateControl)
BindingContainer

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

(Odziedziczone po Control)
Cache

Pobiera obiekt Cache, który jest skojarzony z aplikacją zawierającą kontrolkę użytkownika.Gets the Cache object that is associated with the application that contains the user control.

CachePolicy

Pobiera odwołanie do kolekcji parametrów buforowania dla tej kontrolki użytkownika.Gets a reference to a collection of caching parameters for this user control.

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 właściwości ClientID.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 właściwości ClientID.Gets a character value representing the separator character used in the ClientID property.

(Odziedziczone po Control)
Context

Pobiera obiekt HttpContext 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 obiekt ControlCollection, który reprezentuje 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)
DataItemContainer

Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje 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 implementuje 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)
EnableTheming

Pobiera lub ustawia wartość logiczną wskazującą, czy motywy stosują się do formantu, który jest pochodną klasy TemplateControl.Gets or sets a Boolean value indicating whether themes apply to the control that is derived from the TemplateControl class.

(Odziedziczone po TemplateControl)
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)
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)
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)
IsPostBack

Pobiera wartość wskazującą, czy formant użytkownika jest ładowany w odpowiedzi na zwrotne z klienta lub czy jest ładowany po raz pierwszy.Gets a value indicating whether the user control is being loaded in response to a client postback, or if it is being loaded and accessed for the first time.

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 zamiast indeksu.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 o tej samej wartości właściwości ID.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)
Page

Pobiera odwołanie do wystąpienia Page zawierającego 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)
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)
Request

Pobiera obiekt HttpRequest dla bieżącego żądania sieci Web.Gets the HttpRequest object for the current Web request.

Response

Pobiera obiekt HttpResponse dla bieżącego żądania sieci Web.Gets the HttpResponse object for the current Web request.

Server

Pobiera obiekt HttpServerUtility dla bieżącego żądania sieci Web.Gets the HttpServerUtility object for the current Web request.

Session

Pobiera obiekt HttpSessionState dla bieżącego żądania sieci Web.Gets the HttpSessionState object for the current Web request.

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 Control)
SupportAutoEvents

Pobiera wartość wskazującą, czy formant TemplateControl obsługuje zdarzenia automatyczne.Gets a value indicating whether the TemplateControl control supports automatic events.

(Odziedziczone po TemplateControl)
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 UserControl zawierający bieżącą kontrolkę serwerową.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Odziedziczone po Control)
Trace

Pobiera obiekt TraceContext dla bieżącego żądania sieci Web.Gets the TraceContext object for the current Web request.

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)
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 obiekt StateBag nie uwzględnia wielkości 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)

Metody

AddedControl(Control, Int32)

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

(Odziedziczone po Control)
AddParsedSubObject(Object)

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

(Odziedziczone po Control)
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 właściwości Trace, 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ść ClientID buforowanej 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 właściwość ClientIDMode bieżącego wystąpienia kontrolki i wszystkich formantów podrzędnych do Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Odziedziczone po Control)
Construct()

Wykonuje logikę czasu projektowania.Performs design-time logic.

(Odziedziczone po TemplateControl)
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 obiekt ControlCollection 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)
CreateResourceBasedLiteralControl(Int32, Int32, Boolean)

Uzyskuje dostęp do ciągów literałów przechowywanych w zasobie.Accesses literal strings stored in a resource. Metoda CreateResourceBasedLiteralControl(Int32, Int32, Boolean) nie jest przeznaczona do użycia w kodzie.The CreateResourceBasedLiteralControl(Int32, Int32, Boolean) method is not intended for use from within your code.

(Odziedziczone po TemplateControl)
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łaną kontrolką serwera i wszystkimi jego kontrolkami podrzędnymi z opcją podniesienia poziomu zdarzenia DataBinding.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)
DesignerInitialize()

Wykonuje wszelkie kroki inicjowania w kontrolce użytkownika, które są wymagane przez projektantów RAD.Performs any initialization steps on the user control that are required by RAD designers.

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)
Eval(String)

Oblicza wyrażenie powiązania danych.Evaluates a data-binding expression.

(Odziedziczone po TemplateControl)
Eval(String, String)

Oblicza wyrażenie powiązania danych przy użyciu określonego ciągu formatu w celu wyświetlenia wyniku.Evaluates a data-binding expression using the specified format string to display the result.

(Odziedziczone po TemplateControl)
FindControl(String)

Wyszukuje w bieżącym kontenerze nazewnictwa dla kontrolki serwera z określonym parametrem id.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 o określonym id i liczbie całkowitej, określonej w parametrze pathOffset, 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łonić tej wersji metody FindControl.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)
FrameworkInitialize()

Inicjuje formant pochodzący z klasy TemplateControl.Initializes the control that is derived from the TemplateControl class.

(Odziedziczone po TemplateControl)
GetDesignModeState()

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

(Odziedziczone po Control)
GetGlobalResourceObject(String, String)

Pobiera obiekt zasobów na poziomie aplikacji na podstawie określonych ClassKey i właściwości ResourceKey.Gets an application-level resource object based on the specified ClassKey and ResourceKey properties.

(Odziedziczone po TemplateControl)
GetGlobalResourceObject(String, String, Type, String)

Pobiera obiekt zasobów na poziomie aplikacji na podstawie określonych ClassKey i właściwości ResourceKey, typu obiektu i nazwy właściwości zasobu.Gets an application-level resource object based on the specified ClassKey and ResourceKey properties, object type, and property name of the resource.

(Odziedziczone po TemplateControl)
GetHashCode()

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

(Odziedziczone po Object)
GetLocalResourceObject(String)

Pobiera obiekt zasobów na poziomie strony na podstawie określonej właściwości ResourceKey.Gets a page-level resource object based on the specified ResourceKey property.

(Odziedziczone po TemplateControl)
GetLocalResourceObject(String, Type, String)

Pobiera obiekt zasobów na poziomie strony na podstawie określonej właściwości ResourceKey, typu obiektu i nazwy właściwości.Gets a page-level resource object based on the specified ResourceKey property, object type, and property name.

(Odziedziczone po TemplateControl)
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żącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
GetUniqueIDRelativeTo(Control)

Zwraca przedznaczoną część właściwości UniqueID 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)
InitializeAsUserControl(Page)

Inicjuje obiekt UserControl, który został utworzony deklaratywnie.Initializes the UserControl object that has been created declaratively. Ponieważ istnieją pewne różnice między stronami i kontrolkami użytkownika, ta metoda sprawdza, czy kontrolka użytkownika została prawidłowo zainicjowana.Since there are some differences between pages and user controls, this method makes sure that the user control is initialized properly.

IsLiteralContent()

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

(Odziedziczone po Control)
LoadControl(String)

Ładuje obiekt Control z pliku na podstawie określonej ścieżki wirtualnej.Loads a Control object from a file based on a specified virtual path.

(Odziedziczone po TemplateControl)
LoadControl(Type, Object[])

Ładuje obiekt Control na podstawie określonego typu i parametrów konstruktora.Loads a Control object based on a specified type and constructor parameters.

(Odziedziczone po TemplateControl)
LoadControlState(Object)

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

(Odziedziczone po Control)
LoadTemplate(String)

Uzyskuje wystąpienie ITemplate interfejsu z pliku zewnętrznego.Obtains an instance of the ITemplate interface from an external file.

(Odziedziczone po TemplateControl)
LoadViewState(Object)

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

MapPath(String)

Przypisuje ścieżkę pliku wirtualnego, bezwzględną lub względną, do ścieżki pliku fizycznego.Assigns a virtual file path, either absolute or relative, to a physical file path.

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 Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
OnAbortTransaction(EventArgs)

Podnosi zdarzenie AbortTransaction.Raises the AbortTransaction event.

(Odziedziczone po TemplateControl)
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)
OnCommitTransaction(EventArgs)

Podnosi zdarzenie CommitTransaction.Raises the CommitTransaction event.

(Odziedziczone po TemplateControl)
OnDataBinding(EventArgs)

Podnosi zdarzenie DataBinding.Raises the DataBinding event.

(Odziedziczone po Control)
OnError(EventArgs)

Podnosi zdarzenie Error.Raises the Error event.

(Odziedziczone po TemplateControl)
OnInit(EventArgs)

Podnosi zdarzenie Init.Raises the Init event.

OnLoad(EventArgs)

Podnosi zdarzenie Load.Raises the Load event.

(Odziedziczone po Control)
OnPreRender(EventArgs)

Podnosi zdarzenie PreRender.Raises the PreRender event.

(Odziedziczone po Control)
OnUnload(EventArgs)

Podnosi zdarzenie Unload.Raises the Unload event.

(Odziedziczone po Control)
OpenFile(String)

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

(Odziedziczone po Control)
ParseControl(String)

Analizuje ciąg wejściowy do obiektu Control na stronie formularzy sieci Web lub w kontrolce użytkownika.Parses an input string into a Control object on the Web Forms page or user control.

(Odziedziczone po TemplateControl)
ParseControl(String, Boolean)

Analizuje ciąg wejściowy w obiekcie Control na stronie sieci Web ASP.NET lub kontrolce użytkownika.Parses an input string into a Control object on the ASP.NET Web page or user control.

(Odziedziczone po TemplateControl)
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)
ReadStringResource()

Odczytuje zasób ciągu.Reads a string resource. Metoda ReadStringResource() nie jest przeznaczona do użycia w kodzie.The ReadStringResource() method is not intended for use from within your code.

(Odziedziczone po TemplateControl)
RemovedControl(Control)

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

(Odziedziczone po Control)
Render(HtmlTextWriter)

Wysyła zawartość kontrolki serwera do podanego obiektu HtmlTextWriter, który zapisuje zawartość, która ma być renderowana na kliencie.Sends server control content to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Odziedziczone po Control)
RenderChildren(HtmlTextWriter)

Wyprowadza zawartość elementu podrzędnego kontrolki serwera do podanego obiektu HtmlTextWriter, 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)
RenderControl(HtmlTextWriter)

Wyprowadza zawartość kontrolki serwera do podanego obiektu HtmlTextWriter i przechowuje informacje o śledzeniu dotyczące 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 obiektu HtmlTextWriter przy użyciu podanego obiektu ControlAdapter.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Odziedziczone po Control)
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 zmiany stanu widoku kontrolki użytkownika, które wystąpiły od czasu ostatniej strony.Saves any user control view-state changes that have occurred since the last page postback.

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)
SetStringResourcePointer(Object, Int32)

Ustawia wskaźnik do zasobu ciągu.Sets a pointer to a string resource. Metoda SetStringResourcePointer(Object, Int32) jest używana przez wygenerowane klasy i nie jest przeznaczona do użycia w kodzie.The SetStringResourcePointer(Object, Int32) method is used by generated classes and is not intended for use from within your code.

(Odziedziczone po TemplateControl)
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)
TestDeviceFilter(String)

Zwraca wartość logiczną wskazującą, czy filtr urządzenia dotyczy żądania HTTP.Returns a Boolean value indicating whether a device filter applies to the HTTP request.

(Odziedziczone po TemplateControl)
ToString()

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

(Odziedziczone po Object)
TrackViewState()

Powoduje śledzenie zmian stanu widoku w formancie serwera, aby mogły być przechowywane w obiekcie StateBag formantu serwera.Causes tracking of view-state changes to the server control so they can be stored in the server control's StateBag object. Ten obiekt jest dostępny za pomocą właściwości ViewState.This object is accessible through the ViewState property.

(Odziedziczone po Control)
TryUpdateModel<TModel>(TModel)

Próbuje zaktualizować wystąpienie modelu przy użyciu wartości z formantu powiązanego z danymi.Attempts to update the model instance by using the values from the data-bound control.

TryUpdateModel<TModel>(TModel, IValueProvider)

Próbuje zaktualizować wystąpienie modelu przy użyciu wartości z dostawcy wartości.Attempts to update the model instance using values from the value provider.

UpdateModel<TModel>(TModel)

Aktualizuje wystąpienie modelu przy użyciu wartości z formantu powiązanego z danymi.Updates the model instance by using values from the data-bound control.

UpdateModel<TModel>(TModel, IValueProvider)

Aktualizuje określone wystąpienie modelu przy użyciu wartości z dostawcy wartości kontrolki użytkownika.Updates the specified model instance using values from the value provider of the user control.

WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean)

Zapisuje ciąg zasobu do kontrolki HtmlTextWriter.Writes a resource string to an HtmlTextWriter control. Metoda WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean) jest używana przez wygenerowane klasy i nie jest przeznaczona do użycia w kodzie.The WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean) method is used by generated classes and is not intended for use from within your code.

(Odziedziczone po TemplateControl)
XPath(String)

Oblicza wyrażenie powiązania danych XPath.Evaluates an XPath data-binding expression.

(Odziedziczone po TemplateControl)
XPath(String, IXmlNamespaceResolver)

Oblicza wyrażenie powiązania danych XPath przy użyciu określonych mapowań prefiksu i przestrzeni nazw dla rozpoznawania przestrzeni nazw.Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution.

(Odziedziczone po TemplateControl)
XPath(String, String)

Oblicza wyrażenie powiązania danych XPath przy użyciu określonego ciągu formatu w celu wyświetlenia wyniku.Evaluates an XPath data-binding expression using the specified format string to display the result.

(Odziedziczone po TemplateControl)
XPath(String, String, IXmlNamespaceResolver)

Oblicza wyrażenie powiązania danych XPath przy użyciu określonych mapowań prefiksu i przestrzeni nazw dla rozpoznawania przestrzeni nazw i określonego ciągu formatu w celu wyświetlenia wyniku.Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution and the specified format string to display the result.

(Odziedziczone po TemplateControl)
XPathSelect(String)

Oblicza wyrażenie powiązania danych XPath i zwraca kolekcję węzłów implementującą interfejs IEnumerable.Evaluates an XPath data-binding expression and returns a node collection that implements the IEnumerable interface.

(Odziedziczone po TemplateControl)
XPathSelect(String, IXmlNamespaceResolver)

Oblicza wyrażenie powiązania danych XPath przy użyciu określonych mapowań prefiksu i przestrzeni nazw dla rozpoznawania przestrzeni nazw i zwraca kolekcję węzłów implementującą interfejs IEnumerable.Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution and returns a node collection that implements the IEnumerable interface.

(Odziedziczone po TemplateControl)

Zdarzenia

AbortTransaction

Występuje, gdy użytkownik skończy transakcję.Occurs when a user ends a transaction.

(Odziedziczone po TemplateControl)
CommitTransaction

Występuje po zakończeniu transakcji.Occurs when a transaction completes.

(Odziedziczone po TemplateControl)
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)
Error

Występuje, gdy zostanie zgłoszony nieobsługiwany wyjątek.Occurs when an unhandled exception is thrown.

(Odziedziczone po TemplateControl)
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 formant serwera zostanie załadowany do obiektu Page.Occurs when the server control is loaded into the Page object.

(Odziedziczone po Control)
PreRender

Występuje po załadowaniu obiektu Control, 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)

Zwraca wartość określonego atrybutu kontrolki użytkownika.Returns the value of the specified user control attribute.

IAttributeAccessor.SetAttribute(String, String)

Ustawia wartość określonego atrybutu kontrolki użytkownika.Sets the value of the specified user control attribute.

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)
IFilterResolutionService.CompareFilters(String, String)

Zwraca wartość wskazującą, czy relacja nadrzędny/podrzędny istnieje między dwoma określonymi filtrami urządzeń.Returns a value that indicates whether a parent/child relationship exists between two specified device filters.

(Odziedziczone po TemplateControl)
IFilterResolutionService.EvaluateFilter(String)

Zwraca wartość wskazującą, czy określony filtr jest typem bieżącego obiektu filtru.Returns a value that indicates whether the specified filter is a type of the current filter object.

(Odziedziczone po TemplateControl)
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)
IUserControlDesignerAccessor.InnerText

Pobiera lub ustawia tekst wyświetlany między tagiem otwierającym i zamykającym kontrolki użytkownika.Gets or sets the text that appears between the opening and closing tags of a user control.

IUserControlDesignerAccessor.TagName

Pobiera lub ustawia pełną nazwę tagu kontrolki użytkownika.Gets or sets the full tag name of the user control.

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.

GetDefaultValues(INamingContainer)

Pobiera kolekcję wartości domyślnych dla określonej kontrolki danych.Gets the collection of the default values for the specified data control.

GetMetaTable(INamingContainer)

Pobiera metadane tabeli dla określonej kontrolki danych.Gets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable)

Ustawia metadane tabeli dla określonej kontrolki danych.Sets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Ustawia metadane tabeli i mapowanie wartości domyślnej dla określonej kontrolki danych.Sets the table metadata and default value mapping for the specified data control.

SetMetaTable(INamingContainer, MetaTable, Object)

Ustawia metadane tabeli i mapowanie wartości domyślnej dla określonej kontrolki danych.Sets the table metadata and default value mapping for the specified data control.

TryGetMetaTable(INamingContainer, MetaTable)

Określa, czy metadane tabeli są dostępne.Determines whether table metadata is available.

EnableDynamicData(INamingContainer, Type)

Włącza dynamiczne zachowanie danych dla określonej kontrolki danych.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Włącza dynamiczne zachowanie danych dla określonej kontrolki danych.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, Object)

Włącza dynamiczne zachowanie danych dla określonej kontrolki danych.Enables Dynamic Data behavior for the specified data control.

Dotyczy

Zobacz też