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 Formularze sieci Web.

Ważne

W tym przykładzie znajduje się pole tekstowe, które akceptuje dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web weryfikują, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz 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 utworzona podczas tworzenia 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 renderujące własny interfejs użytkownika, pochodzą z Controlelementu . 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 kontrolki niestandardowej.

Klasa Control jest klasą bazową dla wszystkich kontrolek serwera ASP.NET, w tym kontrolek niestandardowych, kontrolek użytkownika i stron. ASP.NET strony są wystąpieniami Page klasy, która dziedziczy z Control klasy i obsługuje żądania dotyczące plików, które mają rozszerzenie .aspx.

Klasa Control może być używana bezpośrednio lub pośrednio jako część interfejsu użytkownika dla aplikacji internetowej, a w związku z tym powinna być analizowana, 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, najlepszych rozwiązań dotyczących zasad zabezpieczeń i kluczowych pojęć dotyczących 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 tego formantu.
ChildControlsCreated	Pobiera wartość wskazującą, czy kontrolki podrzędne kontrolki serwera zostały utworzone.
ClientID	Pobiera identyfikator kontrolki dla znaczników HTML generowanych przez ASP.NET.
ClientIDMode	Pobiera lub ustawia algorytm używany do generowania ClientID wartości 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 wysyłającego żądanie.
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 kontrolki podrzędne bieżącego formantu serwera mają 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 dla tej kontrolki jest włączony stan widoku.
LoadViewStateByID	Pobiera wartość wskazującą, czy kontrolka uczestniczy w ładowaniu stanu widoku przez ID zamiast indeksu.
NamingContainer	Pobiera odwołanie do kontenera nazewnictwa kontrolki serwera, który tworzy unikatową przestrzeń nazw do rozróżniania między kontrolkami serwera o tej samej ID wartości właściwości.
Page	Pobiera odwołanie do Page wystąpienia, które zawiera kontrolkę serwera.
Parent	Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii sterowania stronami.
RenderingCompatibility	Pobiera wartość określającą wersję ASP.NET, z którą renderowany kod HTML będzie zgodny.
Site	Pobiera informacje o kontenerze hostujące bieżącą kontrolkę podczas renderowania na powierzchni projektowej.
SkinID	Pobiera lub ustawia skórę do zastosowania do kontrolki.
TemplateControl	Pobiera lub ustawia odwołanie do szablonu zawierającego tę kontrolkę.
TemplateSourceDirectory	Pobiera katalog wirtualny elementu 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 umożliwia zapisanie i przywrócenie stanu widoku kontrolki serwera w wielu żądaniach dla tej samej strony.
ViewStateIgnoresCase	Pobiera wartość wskazującą, czy StateBag obiekt jest niewrażliwy na wielkość liter.
ViewStateMode	Pobiera lub ustawia tryb stanu widoku 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ływane po dodaniu kontrolki podrzędnej do Controls kolekcji Control obiektu.
AddParsedSubObject(Object)	Powiadamia formant 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 danych renderowania w czasie projektowania.
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`wartość .
ClearChildControlState()	Usuwa informacje o stanie sterowania dla kontrolek podrzędnych kontrolki serwera.
ClearChildState()	Usuwa informacje o stanie widoku i stanie sterowania 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 Inheritwartość .
CreateChildControls()	Wywoływana przez platformę strony 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ł i serwer) kontrolki serwera.
DataBind()	Wiąże źródło danych z wywołaną kontrolką serwera i wszystkimi jej kontrolkami podrzędnymi.
DataBind(Boolean)	Wiąże źródło danych z wywołaną kontrolką serwera i wszystkie jego kontrolki podrzędne z opcją wywołania DataBinding zdarzenia.
DataBindChildren()	Wiąże źródło danych z kontrolkami podrzędnymi kontrolki serwera.
Dispose()	Umożliwia kontroli serwera przeprowadzenie końcowego czyszczenia przed zwolnieniem z pamięci.
EndRenderTracing(TextWriter, Object)	Kończy śledzenie danych renderowania w czasie projektowania.
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` , która ułatwia wyszukiwanie. Nie należy zastępować tej wersji FindControl metody .
Focus()	Ustawia fokus danych wejściowych na kontrolkę.
GetDesignModeState()	Pobiera dane czasu 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 wartość bieżącego wystąpienia. (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ą zarejestrowane dla kontrolki, czy dla kontrolek podrzędnych.
IsLiteralContent()	Określa, czy kontrolka serwera przechowuje 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ą mapuje się ś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)	Pobiera element Stream 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 z Controls kolekcji Control obiektu.
Render(HtmlTextWriter)	Wysyła zawartość kontroli serwera do dostarczonego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie.
RenderChildren(HtmlTextWriter)	Zwraca zawartość elementów podrzędnych kontrolki serwera do udostępnionego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie.
RenderControl(HtmlTextWriter)	Generuje zawartość serwera kontrolującą podaną HtmlTextWriter obiekt i przechowują informacje o śledzeniu dotyczące kontrolki, jeśli śledzenie jest włączone.
RenderControl(HtmlTextWriter, ControlAdapter)	Dane wyjściowe kontrolują zawartość serwera w podanym HtmlTextWriter obiekcie przy użyciu podanego ControlAdapter obiektu.
ResolveAdapter()	Pobiera kartę kontrolną 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 procedury obsługi zdarzeń, aby renderować kontrolkę serwera i jego zawartość 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 mogą być przechowywane w obiekcie kontroli 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 kontrolka serwera jest zwalniana z pamięci, która jest ostatnim etapem cyklu życia kontroli serwera po zażądaniu strony 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 elementu członkowskiego, zobacz ControlBuilder.
IControlDesignerAccessor.GetDesignModeState()	Aby uzyskać opis tego elementu członkowskiego, zobacz GetDesignModeState().
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Aby uzyskać opis tego elementu członkowskiego, zobacz SetDesignModeState(IDictionary).
IControlDesignerAccessor.SetOwnerControl(Control)	Aby uzyskać opis tego elementu członkowskiego, zobacz SetOwnerControl(Control).
IControlDesignerAccessor.UserData	Aby uzyskać opis tego elementu członkowskiego, zobacz UserData.
IDataBindingsAccessor.DataBindings	Aby uzyskać opis tego elementu członkowskiego, zobacz DataBindings.
IDataBindingsAccessor.HasDataBindings	Aby uzyskać opis tego elementu członkowskiego, zobacz HasDataBindings.
IExpressionsAccessor.Expressions	Aby uzyskać opis tego elementu członkowskiego, zobacz Expressions.
IExpressionsAccessor.HasExpressions	Aby uzyskać opis tego elementu członkowskiego, zobacz HasExpressions.
IParserAccessor.AddParsedSubObject(Object)	Aby uzyskać opis tego elementu członkowskiego, 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

Udostępnij za pośrednictwem