HtmlGenericControl Klasa
Definicja
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 metody, właściwości i zdarzenia dla wszystkich elementów sterowania serwerem HTML, które nie są reprezentowane przez określoną klasę programu .NET Framework.
public ref class HtmlGenericControl : System::Web::UI::HtmlControls::HtmlContainerControl
public class HtmlGenericControl : System.Web.UI.HtmlControls.HtmlContainerControl
type HtmlGenericControl = class
inherit HtmlContainerControl
Public Class HtmlGenericControl
Inherits HtmlContainerControl
- Dziedziczenie
- Pochodne
Przykłady
W poniższym przykładzie kodu pokazano, jak używać HtmlGenericControl klasy do reprezentowania <body>
elementu.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void SubmitBtn_Click(object sender, EventArgs e)
{
Body.Attributes["bgcolor"] = ColorSelect.Value;
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>HtmlGenericControl Example</title>
</head>
<body id="Body"
runat="server">
<h3>HtmlGenericControl Example</h3>
<form id="form1" runat="server">
<div>
<br />
Select a background color for the page: <br />
<select id="ColorSelect"
runat="server">
<option>White</option>
<option>LightBlue</option>
<option>LightGreen</option>
<option>Yellow</option>
</select>
<input type="submit"
runat="server"
value="Apply"
onserverclick="SubmitBtn_Click" id="Submit1" />
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub SubmitBtn_Click(ByVal sender As Object, ByVal e As System.EventArgs)
Body.Attributes("bgcolor") = ColorSelect.Value
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>HtmlGenericControl Example</title>
</head>
<body id="Body"
runat="server">
<h3>HtmlGenericControl Example</h3>
<form id="form1" runat="server">
<div>
<br />
Select a background color for the page: <br />
<select id="ColorSelect"
runat="server">
<option>White</option>
<option>LightBlue</option>
<option>LightGreen</option>
<option>Yellow</option>
</select>
<input type="submit"
runat="server"
value="Apply"
onserverclick="SubmitBtn_Click" id="Submit1" />
</div>
</form>
</body>
</html>
Uwagi
Ta klasa służy do reprezentowania elementu sterowania serwerem HTML, który nie jest bezpośrednio reprezentowany przez klasę programu .NET Framework, taką jak <span>
, <div>
, <body>
lub <font>
.
Aby uzyskać listę początkowych wartości właściwości dla wystąpienia HtmlGenericControlklasy , zobacz HtmlGenericControl konstruktor.
Przestroga
Ta kontrolka może służyć do wyświetlania danych wejściowych użytkownika, które mogą obejmować złośliwy skrypt klienta. Przed wyświetleniem w aplikacji sprawdź informacje wysyłane z klienta pod kątem skryptu wykonywalnego, instrukcji SQL lub innego kodu. ASP.NET udostępnia funkcję weryfikacji żądania wejściowego w celu blokowania skryptu i kodu HTML w danych wejściowych użytkownika. Kontrolki serwera sprawdzania poprawności są również udostępniane w celu oceny danych wejściowych użytkownika. Aby uzyskać więcej informacji, zobacz Validation Server Control Syntax and Validating User Input in ASP.NET Web Pages ( Sprawdzanie poprawności składni sterowania serwerem i weryfikowanie danych wejściowych użytkownika na stronach internetowych ASP.NET).
Konstruktory
HtmlGenericControl() |
Inicjuje nowe wystąpienie klasy HtmlGenericControl z domyślnymi wartościami. |
HtmlGenericControl(String) |
Inicjuje HtmlGenericControl nowe wystąpienie klasy przy użyciu określonego tagu. |
Właściwości
Adapter |
Pobiera kartę specyficzną dla przeglądarki dla kontrolki. (Odziedziczone po Control) |
AppRelativeTemplateSourceDirectory |
Pobiera lub ustawia względny katalog Page wirtualny aplikacji obiektu lub UserControl , który zawiera tę kontrolkę. (Odziedziczone po Control) |
Attributes |
Pobiera kolekcję wszystkich par nazw atrybutów i wartości wyrażonych na tagu sterowania serwera na stronie ASP.NET. (Odziedziczone po HtmlControl) |
BindingContainer |
Pobiera kontrolkę zawierającą powiązanie danych tej kontrolki. (Odziedziczone po Control) |
ChildControlsCreated |
Pobiera wartość wskazującą, czy kontrolka podrzędna kontrolki serwera została utworzona. (Odziedziczone po Control) |
ClientID |
Pobiera identyfikator kontrolki dla znaczników HTML generowanych przez ASP.NET. (Odziedziczone po Control) |
ClientIDMode |
Pobiera lub ustawia algorytm używany do generowania wartości ClientID właściwości. (Odziedziczone po Control) |
ClientIDSeparator |
Pobiera wartość znaku reprezentującą znak separatora ClientID używany we właściwości . (Odziedziczone po Control) |
Context |
HttpContext Pobiera obiekt skojarzony z kontrolką serwera dla bieżącego żądania sieci Web. (Odziedziczone po Control) |
Controls |
ControlCollection Pobiera obiekt reprezentujący kontrolki podrzędne dla określonej kontrolki serwera w hierarchii interfejsu użytkownika. (Odziedziczone po Control) |
DataItemContainer |
Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataItemContainerelement . (Odziedziczone po Control) |
DataKeysContainer |
Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataKeysControlelement . (Odziedziczone po Control) |
DesignMode |
Pobiera wartość wskazującą, czy kontrolka jest używana na powierzchni projektowej. (Odziedziczone po Control) |
Disabled |
Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera HTML jest wyłączona. (Odziedziczone po HtmlControl) |
EnableTheming |
Pobiera lub ustawia wartość wskazującą, czy motywy mają zastosowanie do tej kontrolki. (Odziedziczone po Control) |
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. (Odziedziczone po Control) |
Events |
Pobiera listę delegatów programu obsługi zdarzeń dla kontrolki. Ta właściwość jest tylko do odczytu. (Odziedziczone po Control) |
HasChildViewState |
Pobiera wartość wskazującą, czy kontrolka podrzędna bieżącej kontrolki serwera ma jakiekolwiek zapisane ustawienia stanu widoku. (Odziedziczone po Control) |
ID |
Pobiera lub ustawia identyfikator programowy przypisany do kontrolki serwera. (Odziedziczone po Control) |
IdSeparator |
Pobiera znak używany do oddzielania identyfikatorów kontrolek. (Odziedziczone po Control) |
InnerHtml |
Pobiera lub ustawia zawartość znalezioną między tagami otwierania i zamykania określonego formantu serwera HTML. (Odziedziczone po HtmlContainerControl) |
InnerText |
Pobiera lub ustawia tekst między tagami otwierania i zamykania określonego formantu serwera HTML. (Odziedziczone po HtmlContainerControl) |
IsChildControlStateCleared |
Pobiera wartość wskazującą, czy kontrolki zawarte w tej kontrolce mają stan kontroli. (Odziedziczone po Control) |
IsTrackingViewState |
Pobiera wartość wskazującą, czy kontrolka serwera zapisuje zmiany w stanie widoku. (Odziedziczone po Control) |
IsViewStateEnabled |
Pobiera wartość wskazującą, czy stan widoku jest włączony dla tej kontrolki. (Odziedziczone po Control) |
LoadViewStateByID |
Pobiera wartość wskazującą, czy kontrolka uczestniczy w ładowaniu stanu ID widoku zamiast indeksu. (Odziedziczone po Control) |
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. (Odziedziczone po Control) |
Page |
Pobiera odwołanie do Page wystąpienia zawierającego kontrolkę serwera. (Odziedziczone po Control) |
Parent |
Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii kontrolek strony. (Odziedziczone po Control) |
RenderingCompatibility |
Pobiera wartość określającą wersję ASP.NET, z którą renderowany kod HTML będzie zgodny. (Odziedziczone po Control) |
Site |
Pobiera informacje o kontenerze hostujące bieżącą kontrolkę podczas renderowania na powierzchni projektowej. (Odziedziczone po Control) |
SkinID |
Pobiera lub ustawia skórę do zastosowania w kontrolce. (Odziedziczone po Control) |
Style |
Pobiera kolekcję wszystkich kaskadowych właściwości arkusza stylów (CSS) zastosowanych do określonej kontrolki serwera HTML w pliku ASP.NET. (Odziedziczone po HtmlControl) |
TagName |
Pobiera lub ustawia nazwę elementu HTML reprezentowanego przez kontrolkę HtmlGenericControl . |
TemplateControl |
Pobiera lub ustawia odwołanie do szablonu zawierającego tę kontrolkę. (Odziedziczone po Control) |
TemplateSourceDirectory |
Pobiera katalog wirtualny obiektu Page lub UserControl , który zawiera bieżącą kontrolkę serwera. (Odziedziczone po Control) |
UniqueID |
Pobiera unikatowy, hierarchicznie kwalifikowany identyfikator kontroli serwera. (Odziedziczone po Control) |
ValidateRequestMode |
Pobiera lub ustawia wartość wskazującą, czy kontrolka sprawdza dane wejściowe klienta z przeglądarki pod kątem potencjalnie niebezpiecznych wartości. (Odziedziczone po Control) |
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. (Odziedziczone po Control) |
ViewStateIgnoresCase |
Pobiera wartość wskazującą, czy HtmlControl w stanie widoku jest uwzględniana wielkość liter. (Odziedziczone po HtmlControl) |
ViewStateMode |
Pobiera lub ustawia tryb wyświetlania tej kontrolki. (Odziedziczone po Control) |
Visible |
Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera jest renderowana jako interfejs użytkownika na stronie. (Odziedziczone po Control) |
Metody
AddedControl(Control, Int32) |
Wywoływana po dodaniu kontrolki podrzędnej do Controls kolekcji Control obiektu. (Odziedziczone po Control) |
AddParsedSubObject(Object) |
Powiadamia kontrolkę serwera, że element , XML lub HTML, został przeanalizowany i dodaje element do obiektu kontrolki ControlCollection serwera. (Odziedziczone po Control) |
ApplyStyleSheetSkin(Page) |
Stosuje właściwości stylu zdefiniowane w arkuszu stylów strony do kontrolki. (Odziedziczone po Control) |
BeginRenderTracing(TextWriter, Object) |
Rozpoczyna śledzenie czasu projektowania danych renderowania. (Odziedziczone po Control) |
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. (Odziedziczone po Control) |
ClearCachedClientID() |
Ustawia wartość buforowanej ClientID na |
ClearChildControlState() |
Usuwa informacje o stanie kontroli dla kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control) |
ClearChildState() |
Usuwa informacje o stanie widoku i stanie kontroli dla wszystkich kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control) |
ClearChildViewState() |
Usuwa informacje o stanie widoku dla wszystkich kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control) |
ClearEffectiveClientIDMode() |
ClientIDMode Ustawia właściwość bieżącego wystąpienia kontrolki i wszystkich kontrolek podrzędnych na Inherit. (Odziedziczone po Control) |
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. (Odziedziczone po Control) |
CreateControlCollection() |
Tworzy nowy ControlCollection obiekt do przechowywania kontrolek podrzędnych (literał i serwer) kontrolki serwera. (Odziedziczone po HtmlContainerControl) |
DataBind() |
Wiąże źródło danych z wywołaną kontrolką serwera i wszystkimi kontrolkami podrzędnymi. (Odziedziczone po Control) |
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 . (Odziedziczone po Control) |
DataBindChildren() |
Wiąże źródło danych z kontrolkami podrzędnymi kontrolki serwera. (Odziedziczone po Control) |
Dispose() |
Umożliwia kontrolce serwera przeprowadzenie końcowego czyszczenia przed zwolnieniem z pamięci. (Odziedziczone po Control) |
EndRenderTracing(TextWriter, Object) |
Kończy śledzenie czasu projektowania danych renderowania. (Odziedziczone po Control) |
EnsureChildControls() |
Określa, czy kontrolka serwera zawiera kontrolki podrzędne. Jeśli tak nie jest, tworzy kontrolki podrzędne. (Odziedziczone po Control) |
EnsureID() |
Tworzy identyfikator kontrolek, które nie mają przypisanego identyfikatora. (Odziedziczone po Control) |
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 |
FindControl(String, Int32) |
Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera z określoną liczbą |
Focus() |
Ustawia fokus wejściowy na kontrolkę. (Odziedziczone po Control) |
GetAttribute(String) |
Pobiera wartość nazwanego atrybutu w kontrolce HtmlControl . (Odziedziczone po HtmlControl) |
GetDesignModeState() |
Pobiera dane w czasie projektowania dla kontrolki. (Odziedziczone po Control) |
GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
GetRouteUrl(Object) |
Pobiera adres URL odpowiadający zestawowi parametrów trasy. (Odziedziczone po Control) |
GetRouteUrl(RouteValueDictionary) |
Pobiera adres URL odpowiadający zestawowi parametrów trasy. (Odziedziczone po Control) |
GetRouteUrl(String, Object) |
Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy. (Odziedziczone po Control) |
GetRouteUrl(String, RouteValueDictionary) |
Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy. (Odziedziczone po Control) |
GetType() |
Type Pobiera bieżące wystąpienie. (Odziedziczone po Object) |
GetUniqueIDRelativeTo(Control) |
Zwraca prefiksowaną część UniqueID właściwości określonej kontrolki. (Odziedziczone po Control) |
HasControls() |
Określa, czy kontrolka serwera zawiera jakiekolwiek kontrolki podrzędne. (Odziedziczone po Control) |
HasEvents() |
Zwraca wartość wskazującą, czy zdarzenia są rejestrowane dla kontrolki, czy jakiekolwiek kontrolki podrzędne. (Odziedziczone po Control) |
IsLiteralContent() |
Określa, czy kontrolka serwera zawiera tylko zawartość literału. (Odziedziczone po Control) |
LoadControlState(Object) |
Przywraca informacje o stanie kontroli z poprzedniego żądania strony, które zostało zapisane przez metodę SaveControlState() . (Odziedziczone po Control) |
LoadViewState(Object) |
HtmlContainerControl Przywraca stan widoku kontrolki z poprzedniego żądania strony, które zostało zapisane przez metodęSaveViewState(). (Odziedziczone po HtmlContainerControl) |
MapPathSecure(String) |
Pobiera ścieżkę fizyczną, z którą jest mapowa ścieżka wirtualna , bezwzględna lub względna. (Odziedziczone po Control) |
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. (Odziedziczone po Control) |
OnDataBinding(EventArgs) |
DataBinding Zgłasza zdarzenie. (Odziedziczone po Control) |
OnInit(EventArgs) |
Init Zgłasza zdarzenie. (Odziedziczone po Control) |
OnLoad(EventArgs) |
Load Zgłasza zdarzenie. (Odziedziczone po Control) |
OnPreRender(EventArgs) |
PreRender Zgłasza zdarzenie. (Odziedziczone po Control) |
OnUnload(EventArgs) |
Unload Zgłasza zdarzenie. (Odziedziczone po Control) |
OpenFile(String) |
Stream Pobiera element używany do odczytywania pliku. (Odziedziczone po Control) |
RaiseBubbleEvent(Object, EventArgs) |
Przypisuje wszystkie źródła zdarzenia i jego informacje do elementu nadrzędnego kontrolki. (Odziedziczone po Control) |
RemovedControl(Control) |
Wywoływane po usunięciu kontrolki podrzędnej Controls z kolekcji Control obiektu. (Odziedziczone po Control) |
Render(HtmlTextWriter) |
Renderuje kontrolkę HtmlContainerControl do określonego HtmlTextWriter obiektu. (Odziedziczone po HtmlContainerControl) |
RenderAttributes(HtmlTextWriter) |
Renderuje HtmlContainerControl atrybuty kontrolki do określonego HtmlTextWriter obiektu. (Odziedziczone po HtmlContainerControl) |
RenderBeginTag(HtmlTextWriter) |
Renderuje otwierający tag HTML kontrolki do określonego HtmlTextWriter obiektu. (Odziedziczone po HtmlControl) |
RenderChildren(HtmlTextWriter) |
Zwraca zawartość elementów podrzędnych kontrolki serwera do udostępnionego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie. (Odziedziczone po Control) |
RenderControl(HtmlTextWriter) |
Generuje zawartość serwera kontrolującą podaną HtmlTextWriter obiekt i przechowują informacje o śledzeniu dotyczące kontrolki, jeśli śledzenie jest włączone. (Odziedziczone po Control) |
RenderControl(HtmlTextWriter, ControlAdapter) |
Dane wyjściowe kontrolują zawartość serwera w podanym HtmlTextWriter obiekcie przy użyciu podanego ControlAdapter obiektu. (Odziedziczone po Control) |
RenderEndTag(HtmlTextWriter) |
Renderuje tag zamykający kontrolki HtmlContainerControl do określonego HtmlTextWriter obiektu. (Odziedziczone po HtmlContainerControl) |
ResolveAdapter() |
Pobiera kartę kontrolną odpowiedzialną za renderowanie określonej kontrolki. (Odziedziczone po Control) |
ResolveClientUrl(String) |
Pobiera adres URL, który może być używany przez przeglądarkę. (Odziedziczone po Control) |
ResolveUrl(String) |
Konwertuje adres URL na adres, który może być używany przez klienta żądającego. (Odziedziczone po Control) |
SaveControlState() |
Zapisuje wszelkie zmiany stanu kontroli serwera, które wystąpiły od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po Control) |
SaveViewState() |
Zapisuje wszelkie zmiany stanu widoku kontroli serwera, które wystąpiły od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po Control) |
SetAttribute(String, String) |
Ustawia wartość nazwanego atrybutu w kontrolce HtmlControl . (Odziedziczone po HtmlControl) |
SetDesignModeState(IDictionary) |
Ustawia dane czasu projektowania dla kontrolki. (Odziedziczone po Control) |
SetRenderMethodDelegate(RenderMethod) |
Przypisuje delegata procedury obsługi zdarzeń, aby renderować kontrolkę serwera i jego zawartość do kontrolki nadrzędnej. (Odziedziczone po Control) |
SetTraceData(Object, Object) |
Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu klucza danych śledzenia i wartości danych śledzenia. (Odziedziczone po Control) |
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. (Odziedziczone po Control) |
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 . (Odziedziczone po Control) |
Zdarzenia
DataBinding |
Występuje, gdy kontrolka serwera wiąże się ze źródłem danych. (Odziedziczone po Control) |
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. (Odziedziczone po Control) |
Init |
Występuje, gdy kontrolka serwera jest inicjowana, co jest pierwszym krokiem w jego cyklu życia. (Odziedziczone po Control) |
Load |
Występuje, gdy kontrolka serwera jest ładowana do Page obiektu. (Odziedziczone po Control) |
PreRender |
Występuje po załadowaniu Control obiektu, ale przed renderowaniem. (Odziedziczone po Control) |
Unload |
Występuje, gdy kontrolka serwera jest zwalniana z pamięci. (Odziedziczone po Control) |
Jawne implementacje interfejsu
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. |