Control Klasa

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 pierwszy element podrzędny kontrolki jest kontrolką 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 formularzy sieci Web.

Ważna

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 sprawdzają, czy dane wejściowe użytkownika nie zawierają skryptu 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 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, 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 początkowy 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 stron są wystąpieniami klasy Page, która dziedziczy z klasy Control 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 w ramach interfejsu użytkownika dla 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 internetowej, 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 skryptach w aplikacji internetowej przez zastosowanie kodowania HTML do ciągów i wprowadzenie do kontrolek walidacji.

Konstruktory

Nazwa	Opis
Control()	Inicjuje nowe wystąpienie klasy Control.

Właściwości

Nazwa	Opis
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 wartości ClientID właściwości.
ClientIDSeparator	Pobiera wartość znaku reprezentującą znak separatora używany we ClientID 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 kontrolki podrzędne bieżącej kontrolki 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 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 kontroli 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 do kontrolki.
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 umożliwia zapisywanie i przywracanie stanu widoku kontroli serwera w wielu żądaniach dla tej samej strony.
ViewStateIgnoresCase	Pobiera wartość wskazującą, czy StateBag obiekt jest bez uwzględniania 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

Nazwa	Opis
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 buforowana ClientID wartość 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 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ł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ą wywołania DataBinding zdarzenia.
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, Int32)	Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera z określoną `id` liczbą całkowitą określoną w parametrze `pathOffset` , która ułatwia wyszukiwanie. Nie należy zastępować tej wersji FindControl metody.
FindControl(String)	Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera przy użyciu określonego `id` parametru.
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 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ą 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 Wywołuje zdarzenie.
OnInit(EventArgs)	Init Wywołuje zdarzenie.
OnLoad(EventArgs)	Load Wywołuje zdarzenie.
OnPreRender(EventArgs)	PreRender Wywołuje zdarzenie.
OnUnload(EventArgs)	Unload Wywołuje 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ływana 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 dostarczonego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie.
RenderControl(HtmlTextWriter, ControlAdapter)	Zwraca kontrolę zawartości serwera do dostarczonego obiektu przy użyciu podanego HtmlTextWriter ControlAdapter obiektu.
RenderControl(HtmlTextWriter)	Dane wyjściowe serwera kontrolują zawartość w podanym HtmlTextWriter obiekcie i przechowują informacje śledzenia dotyczące kontrolki, jeśli śledzenie jest włączone.
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ń, aby renderować kontrolkę serwera i jego zawartość do kontrolki nadrzędnej.
SetTraceData(Object, Object, Object)	Ustawia dane śledzenia do śledzenia czasu projektowania danych renderowania przy użyciu obiektu śledzenia, klucza danych śledzenia i wartości danych śledzenia.
SetTraceData(Object, Object)	Ustawia dane śledzenia na potrzeby śledzenia czasu projektowania danych renderowania przy użyciu 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, aby można je było przechowywać w obiekcie kontrolki StateBag serwera. Ten obiekt jest dostępny za pośrednictwem ViewState właściwości .

Zdarzenia

Nazwa	Opis
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óry jest ostatnim etapem cyklu życia kontroli serwera, gdy żądana jest 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

Nazwa	Opis
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

Nazwa	Opis
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

Zobacz też

Opinia

Czy ta strona była pomocna?