Control Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Definiuje właściwości, metody i zdarzenia, które są współużytkowane przez wszystkie kontrolki serwera ASP.NET.

public ref class Control : IDisposable, System::ComponentModel::IComponent, System::Web::UI::IDataBindingsAccessor, System::Web::UI::IParserAccessor

public ref class Control : IDisposable, System::ComponentModel::IComponent, System::Web::UI::IControlBuilderAccessor, System::Web::UI::IControlDesignerAccessor, System::Web::UI::IDataBindingsAccessor, System::Web::UI::IExpressionsAccessor, System::Web::UI::IParserAccessor, System::Web::UI::IUrlResolutionService

public class Control : IDisposable, System.ComponentModel.IComponent, System.Web.UI.IDataBindingsAccessor, System.Web.UI.IParserAccessor

[System.ComponentModel.Bindable(true)]
[System.Web.UI.Themeable(false)]
public class Control : IDisposable, System.ComponentModel.IComponent, System.Web.UI.IControlBuilderAccessor, System.Web.UI.IControlDesignerAccessor, System.Web.UI.IDataBindingsAccessor, System.Web.UI.IExpressionsAccessor, System.Web.UI.IParserAccessor, System.Web.UI.IUrlResolutionService

type Control = class
    interface IComponent
    interface IDisposable
    interface IParserAccessor
    interface IDataBindingsAccessor

[<System.ComponentModel.Bindable(true)>]
[<System.Web.UI.Themeable(false)>]
type Control = class
    interface IComponent
    interface IDisposable
    interface IParserAccessor
    interface IUrlResolutionService
    interface IDataBindingsAccessor
    interface IControlBuilderAccessor
    interface IControlDesignerAccessor
    interface IExpressionsAccessor

Public Class Control
Implements IComponent, IDataBindingsAccessor, IDisposable, IParserAccessor

Public Class Control
Implements IComponent, IControlBuilderAccessor, IControlDesignerAccessor, IDataBindingsAccessor, IDisposable, IExpressionsAccessor, IParserAccessor, IUrlResolutionService

Dziedziczenie: Object
Control

Pochodne: System.Web.DynamicData.DynamicControl

System.Web.DynamicData.DynamicDataManager

System.Web.DynamicData.DynamicEntity

System.Web.DynamicData.DynamicFilter

System.Web.DynamicData.EntityTemplate

Więcej…

Atrybuty: BindableAttribute ThemeableAttribute

Implementuje: IComponent IDisposable IDataBindingsAccessor IParserAccessor IControlBuilderAccessor IControlDesignerAccessor IExpressionsAccessor IUrlResolutionService

Przykłady

W poniższym przykładzie pokazano niestandardową kontrolkę serwera, która pochodzi z Control klasy . Klasa InnerContent zastępuje metodę Control.Render , sprawdza, czy klasa ma jakiekolwiek kontrolki podrzędne na stronie i określa, czy pierwszym elementem podrzędnym kontrolki jest kontrolka literału. Jeśli oba te warunki zostaną spełnione, metoda przesłonięć zapisuje ciąg <HTML H2>Twój komunikat:, zawartość kontrolki literału i zamykający </H2> tag na stronie Web Forms.

Ważne

Ten przykład zawiera pole tekstowe, które akceptuje dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web sprawdzają, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz Script Exploits Overview (Omówienie luk w zabezpieczeniach skryptów).

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

namespace SimpleControlSamples {

    public class InnerContent : Control {
    [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="Execution")]
       protected override void Render(HtmlTextWriter output) {

           if ( (HasControls()) && (Controls[0] is LiteralControl) ) {
               output.Write("<H2>Your message : ");
               Controls[0].RenderControl(output);
               output.Write("</H2>");
           }
       }
    }
}

Option Explicit
Option Strict

Imports System.Web
Imports System.Web.UI

Namespace SimpleControlSamples
    Public Class InnerContent
        Inherits Control
        <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="Execution")> _
        Protected Overrides Sub Render(output As HtmlTextWriter)
            
            If HasControls() And TypeOf Controls(0) Is LiteralControl Then
                output.Write("<H2>Your message : ")
                Controls(0).RenderControl(output)
                output.Write("</H2>")
            End If
        End Sub
    End Class
End Namespace 'SimpleControlSamples

Uwagi

Jest to klasa podstawowa, z której pochodzi podczas opracowywania niestandardowych kontrolek serwera ASP.NET. Control nie ma żadnych funkcji specyficznych dla interfejsu użytkownika. Jeśli tworzysz kontrolkę, która nie ma interfejsu użytkownika lub łączy inne kontrolki, które renderują własny interfejs użytkownika, pochodzą z elementu Control. Jeśli tworzysz kontrolkę, która ma interfejs użytkownika, pochodzi z WebControl lub dowolnej kontrolki w System.Web.UI.WebControls przestrzeni nazw, która zapewnia odpowiedni punkt wyjścia dla niestandardowej kontrolki.

Klasa Control jest klasą bazową dla wszystkich kontrolek serwera ASP.NET, w tym kontrolek niestandardowych, kontrolek użytkownika i stron. ASP.NET strony to wystąpienia Page klasy, które dziedziczą po Control klasie, i obsługują żądania dotyczące plików z rozszerzeniem aspx.

Klasa Control może być używana bezpośrednio lub pośrednio jako część interfejsu użytkownika aplikacji internetowej. W związku z tym należy je zbadać, aby upewnić się, że są przestrzegane najlepsze rozwiązania dotyczące pisania bezpiecznego kodu i zabezpieczania aplikacji.

Aby uzyskać ogólne informacje na temat tych tematów, zobacz Omówienie zagrożeń zabezpieczeń aplikacji internetowych, najlepsze rozwiązania dotyczące zasad zabezpieczeń i kluczowe pojęcia dotyczące zabezpieczeń. Aby uzyskać bardziej szczegółowe informacje, zobacz Zabezpieczanie standardowych kontrolek, Instrukcje: wyświetlanie bezpiecznych komunikatów o błędach, Instrukcje: ochrona przed programami wykorzystującymi luki w zabezpieczeniach skryptów w aplikacji internetowej przez zastosowanie kodowania HTML do ciągów i wprowadzenie do kontrolek walidacji.

Konstruktory

Control()

Inicjuje nowe wystąpienie klasy Control.

Właściwości

Adapter	Pobiera kartę specyficzną dla przeglądarki dla kontrolki.
AppRelativeTemplateSourceDirectory	Pobiera lub ustawia względny katalog Page wirtualny aplikacji obiektu lub UserControl , który zawiera tę kontrolkę.
BindingContainer	Pobiera kontrolkę zawierającą powiązanie danych tej kontrolki.
ChildControlsCreated	Pobiera wartość wskazującą, czy kontrolka podrzędna kontrolki serwera została utworzona.
ClientID	Pobiera identyfikator kontrolki dla znaczników HTML generowanych przez ASP.NET.
ClientIDMode	Pobiera lub ustawia algorytm używany do generowania wartości ClientID właściwości.
ClientIDSeparator	Pobiera wartość znaku reprezentującą znak separatora ClientID używany we właściwości .
Context	HttpContext Pobiera obiekt skojarzony z kontrolką serwera dla bieżącego żądania sieci Web.
Controls	ControlCollection Pobiera obiekt reprezentujący kontrolki podrzędne dla określonej kontrolki serwera w hierarchii interfejsu użytkownika.
DataItemContainer	Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataItemContainerelement .
DataKeysContainer	Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataKeysControlelement .
DesignMode	Pobiera wartość wskazującą, czy kontrolka jest używana na powierzchni projektowej.
EnableTheming	Pobiera lub ustawia wartość wskazującą, czy motywy mają zastosowanie do tej kontrolki.
EnableViewState	Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera utrzymuje stan widoku, oraz stan widoku wszystkich kontrolek podrzędnych, które zawiera, do klienta żądającego.
Events	Pobiera listę delegatów programu obsługi zdarzeń dla kontrolki. Ta właściwość jest tylko do odczytu.
HasChildViewState	Pobiera wartość wskazującą, czy kontrolka podrzędna bieżącej kontrolki serwera ma jakiekolwiek zapisane ustawienia stanu widoku.
ID	Pobiera lub ustawia identyfikator programowy przypisany do kontrolki serwera.
IdSeparator	Pobiera znak używany do oddzielania identyfikatorów kontrolek.
IsChildControlStateCleared	Pobiera wartość wskazującą, czy kontrolki zawarte w tej kontrolce mają stan kontroli.
IsTrackingViewState	Pobiera wartość wskazującą, czy kontrolka serwera zapisuje zmiany w stanie widoku.
IsViewStateEnabled	Pobiera wartość wskazującą, czy stan widoku jest włączony dla tej kontrolki.
LoadViewStateByID	Pobiera wartość wskazującą, czy kontrolka uczestniczy w ładowaniu stanu ID widoku zamiast indeksu.
NamingContainer	Pobiera odwołanie do kontenera nazewnictwa kontrolki serwera, który tworzy unikatową przestrzeń nazw do różnicowania między kontrolkami serwera o tej samej ID wartości właściwości.
Page	Pobiera odwołanie do Page wystąpienia zawierającego kontrolkę serwera.
Parent	Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii kontrolek strony.
RenderingCompatibility	Pobiera wartość określającą wersję ASP.NET, z którą renderowany kod HTML będzie zgodny.
Site	Pobiera informacje o kontenerze, który hostuje bieżącą kontrolkę podczas renderowania na powierzchni projektowej.
SkinID	Pobiera lub ustawia skórę do zastosowania w kontrolce.
TemplateControl	Pobiera lub ustawia odwołanie do szablonu zawierającego tę kontrolkę.
TemplateSourceDirectory	Pobiera katalog wirtualny obiektu Page lub UserControl , który zawiera bieżącą kontrolkę serwera.
UniqueID	Pobiera unikatowy, hierarchicznie kwalifikowany identyfikator kontroli serwera.
ValidateRequestMode	Pobiera lub ustawia wartość wskazującą, czy kontrolka sprawdza dane wejściowe klienta z przeglądarki pod kątem potencjalnie niebezpiecznych wartości.
ViewState	Pobiera słownik informacji o stanie, który pozwala zapisać i przywrócić stan widoku kontroli serwera w wielu żądaniach dla tej samej strony.
ViewStateIgnoresCase	Pobiera wartość wskazującą, czy StateBag obiekt nie uwzględnia wielkości liter.
ViewStateMode	Pobiera lub ustawia tryb wyświetlania tej kontrolki.
Visible	Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera jest renderowana jako interfejs użytkownika na stronie.

Metody

AddedControl(Control, Int32)	Wywoływana po dodaniu kontrolki podrzędnej do Controls kolekcji Control obiektu.
AddParsedSubObject(Object)	Powiadamia kontrolkę serwera, że element , XML lub HTML, został przeanalizowany i dodaje element do obiektu kontrolki ControlCollection serwera.
ApplyStyleSheetSkin(Page)	Stosuje właściwości stylu zdefiniowane w arkuszu stylów strony do kontrolki.
BeginRenderTracing(TextWriter, Object)	Rozpoczyna śledzenie czasu projektowania danych renderowania.
BuildProfileTree(String, Boolean)	Zbiera informacje o kontrolce serwera i dostarcza ją do Trace właściwości, która ma być wyświetlana po włączeniu śledzenia dla strony.
ClearCachedClientID()	Ustawia wartość buforowanej ClientID na `null`.
ClearChildControlState()	Usuwa informacje o stanie kontroli dla kontrolek podrzędnych kontrolki serwera.
ClearChildState()	Usuwa informacje o stanie widoku i stanie kontroli dla wszystkich kontrolek podrzędnych kontrolki serwera.
ClearChildViewState()	Usuwa informacje o stanie widoku dla wszystkich kontrolek podrzędnych kontrolki serwera.
ClearEffectiveClientIDMode()	ClientIDMode Ustawia właściwość bieżącego wystąpienia kontrolki i wszystkich kontrolek podrzędnych na Inherit.
CreateChildControls()	Wywoływana przez platformę stron ASP.NET w celu powiadamiania kontrolek serwera, które używają implementacji opartej na kompozycji w celu utworzenia wszelkich kontrolek podrzędnych, które zawierają w ramach przygotowania do publikowania z powrotem lub renderowania.
CreateControlCollection()	Tworzy nowy ControlCollection obiekt do przechowywania kontrolek podrzędnych (literału i serwera) kontrolki serwera.
DataBind()	Wiąże źródło danych z wywołaną kontrolką serwera i wszystkimi kontrolkami podrzędnymi.
DataBind(Boolean)	Wiąże źródło danych z wywołaną kontrolką serwera i wszystkie jego kontrolki podrzędne z opcją zgłaszania zdarzenia DataBinding .
DataBindChildren()	Wiąże źródło danych z kontrolkami podrzędnymi kontrolki serwera.
Dispose()	Umożliwia kontrolce serwera przeprowadzenie końcowego czyszczenia przed zwolnieniem z pamięci.
EndRenderTracing(TextWriter, Object)	Kończy śledzenie czasu projektowania danych renderowania.
EnsureChildControls()	Określa, czy kontrolka serwera zawiera kontrolki podrzędne. Jeśli tak nie jest, tworzy kontrolki podrzędne.
EnsureID()	Tworzy identyfikator kontrolek, które nie mają przypisanego identyfikatora.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
FindControl(String)	Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera przy użyciu określonego `id` parametru.
FindControl(String, Int32)	Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera z określoną liczbą `id` całkowitą określoną w parametrze `pathOffset` , co ułatwia wyszukiwanie. Nie należy zastąpić tej wersji FindControl metody.
Focus()	Ustawia fokus wejściowy na kontrolkę.
GetDesignModeState()	Pobiera dane w czasie projektowania dla kontrolki.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetRouteUrl(Object)	Pobiera adres URL odpowiadający zestawowi parametrów trasy.
GetRouteUrl(RouteValueDictionary)	Pobiera adres URL odpowiadający zestawowi parametrów trasy.
GetRouteUrl(String, Object)	Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy.
GetRouteUrl(String, RouteValueDictionary)	Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy.
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
GetUniqueIDRelativeTo(Control)	Zwraca prefiksowaną część UniqueID właściwości określonej kontrolki.
HasControls()	Określa, czy kontrolka serwera zawiera jakiekolwiek kontrolki podrzędne.
HasEvents()	Zwraca wartość wskazującą, czy zdarzenia są rejestrowane dla kontrolki, czy jakiekolwiek kontrolki podrzędne.
IsLiteralContent()	Określa, czy kontrolka serwera zawiera tylko zawartość literału.
LoadControlState(Object)	Przywraca informacje o stanie kontroli z poprzedniego żądania strony, które zostało zapisane przez metodę SaveControlState() .
LoadViewState(Object)	Przywraca informacje o stanie widoku z poprzedniego żądania strony, które zostało zapisane przez metodę SaveViewState() .
MapPathSecure(String)	Pobiera ścieżkę fizyczną, z którą jest mapowa ścieżka wirtualna , bezwzględna lub względna.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnBubbleEvent(Object, EventArgs)	Określa, czy zdarzenie kontroli serwera jest przekazywane w hierarchii kontroli serwera interfejsu użytkownika strony.
OnDataBinding(EventArgs)	DataBinding Zgłasza zdarzenie.
OnInit(EventArgs)	Init Zgłasza zdarzenie.
OnLoad(EventArgs)	Load Zgłasza zdarzenie.
OnPreRender(EventArgs)	PreRender Zgłasza zdarzenie.
OnUnload(EventArgs)	Unload Zgłasza zdarzenie.
OpenFile(String)	Stream Pobiera element używany do odczytywania pliku.
RaiseBubbleEvent(Object, EventArgs)	Przypisuje wszystkie źródła zdarzenia i jego informacje do elementu nadrzędnego kontrolki.
RemovedControl(Control)	Wywoływane po usunięciu kontrolki podrzędnej Controls z kolekcji Control obiektu.
Render(HtmlTextWriter)	Wysyła zawartość kontroli serwera do udostępnionego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie.
RenderChildren(HtmlTextWriter)	Wyprowadza zawartość elementów podrzędnych formantu serwera do dostarczonego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie.
RenderControl(HtmlTextWriter)	Dane wyjściowe serwera steruje zawartością dostarczonego HtmlTextWriter obiektu i przechowuje informacje śledzenia dotyczące kontrolki, jeśli śledzenie jest włączone.
RenderControl(HtmlTextWriter, ControlAdapter)	Dane wyjściowe serwera steruje zawartością dostarczonego HtmlTextWriter obiektu przy użyciu dostarczonego ControlAdapter obiektu.
ResolveAdapter()	Pobiera kartę sterową odpowiedzialną za renderowanie określonej kontrolki.
ResolveClientUrl(String)	Pobiera adres URL, który może być używany przez przeglądarkę.
ResolveUrl(String)	Konwertuje adres URL na adres, który może być używany przez klienta żądającego.
SaveControlState()	Zapisuje wszelkie zmiany stanu kontroli serwera, które wystąpiły od czasu opublikowania strony z powrotem na serwerze.
SaveViewState()	Zapisuje wszelkie zmiany stanu widoku kontroli serwera, które wystąpiły od czasu opublikowania strony z powrotem na serwerze.
SetDesignModeState(IDictionary)	Ustawia dane czasu projektowania dla kontrolki.
SetRenderMethodDelegate(RenderMethod)	Przypisuje delegata programu obsługi zdarzeń w celu renderowania kontrolki serwera i jego zawartości do kontrolki nadrzędnej.
SetTraceData(Object, Object)	Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu klucza danych śledzenia i wartości danych śledzenia.
SetTraceData(Object, Object, Object)	Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania, przy użyciu obiektu śledzonego, klucza danych śledzenia i wartości danych śledzenia.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
TrackViewState()	Powoduje śledzenie zmian stanu widoku w kontrolce serwera, dzięki czemu można je przechowywać w obiekcie kontrolki StateBag serwera. Ten obiekt jest dostępny za pośrednictwem ViewState właściwości .

Zdarzenia

DataBinding	Występuje, gdy kontrolka serwera wiąże się ze źródłem danych.
Disposed	Występuje, gdy kontrola serwera jest zwalniana z pamięci, co jest ostatnim etapem cyklu życia kontroli serwera, gdy jest żądana strona ASP.NET.
Init	Występuje, gdy kontrolka serwera jest inicjowana, co jest pierwszym krokiem w jego cyklu życia.
Load	Występuje, gdy kontrolka serwera jest ładowana do Page obiektu.
PreRender	Występuje po załadowaniu Control obiektu, ale przed renderowaniem.
Unload	Występuje, gdy kontrolka serwera jest zwalniana z pamięci.

Jawne implementacje interfejsu

IControlBuilderAccessor.ControlBuilder	Aby uzyskać opis tego członka, zobacz ControlBuilder.
IControlDesignerAccessor.GetDesignModeState()	Aby uzyskać opis tego członka, zobacz GetDesignModeState().
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Aby uzyskać opis tego członka, zobacz SetDesignModeState(IDictionary).
IControlDesignerAccessor.SetOwnerControl(Control)	Aby uzyskać opis tego członka, zobacz SetOwnerControl(Control).
IControlDesignerAccessor.UserData	Aby uzyskać opis tego członka, zobacz UserData.
IDataBindingsAccessor.DataBindings	Aby uzyskać opis tego członka, zobacz DataBindings.
IDataBindingsAccessor.HasDataBindings	Aby uzyskać opis tego członka, zobacz HasDataBindings.
IExpressionsAccessor.Expressions	Aby uzyskać opis tego członka, zobacz Expressions.
IExpressionsAccessor.HasExpressions	Aby uzyskać opis tego członka, zobacz HasExpressions.
IParserAccessor.AddParsedSubObject(Object)	Aby uzyskać opis tego członka, zobacz AddParsedSubObject(Object).

Metody rozszerzania

FindDataSourceControl(Control)	Zwraca źródło danych skojarzone z kontrolką danych dla określonej kontrolki.
FindFieldTemplate(Control, String)	Zwraca szablon pola dla określonej kolumny w kontenerze nazewnictwa określonej kontrolki.
FindMetaTable(Control)	Zwraca obiekt metatable dla kontrolki zawierającej dane.

Dotyczy