AppearanceEditorPart 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.
Udostępnia kontrolkę edytora, która umożliwia użytkownikom końcowym edytowanie kilku właściwości interfejsu użytkownika w skojarzonej WebPart kontrolce. Klasa ta nie może być dziedziczona.
public ref class AppearanceEditorPart sealed : System::Web::UI::WebControls::WebParts::EditorPartpublic sealed class AppearanceEditorPart : System.Web.UI.WebControls.WebParts.EditorParttype AppearanceEditorPart = class
inherit EditorPartPublic NotInheritable Class AppearanceEditorPart
Inherits EditorPart- Dziedziczenie
Przykłady
W poniższym przykładzie kodu pokazano, jak zadeklarować kontrolkę AppearanceEditorPart na stronie sieci Web i umożliwić jej edytowanie kilku właściwości interfejsu użytkownika kontrolki WebPart . Przykładowy kod ma cztery części:
Kontrolka użytkownika, która umożliwia zmianę trybów wyświetlania na stronie składników Web Part.
Strona sieci Web zawierająca kontrolkę EditorZone i kontrolkę AppearanceEditorPart wraz z odwołaniem do kontrolki niestandardowej WebPart .
Klasa zawierająca kontrolkę niestandardową WebPart .
Wyjaśnienie działania przykładu podczas ładowania strony w przeglądarce.
Kod źródłowy kontrolki użytkownika pochodzi z innego tematu. Aby ten przykład kodu działał, należy uzyskać plik ascx dla kontrolki użytkownika z przewodnika: zmiana trybów wyświetlania w temacie Strona składników Web Part i umieścić plik w tym samym folderze co strona aspx w tym przykładzie kodu.
Drugą częścią przykładu kodu jest strona sieci Web. Zawiera ona deklaratywne odwołanie do EditorZone kontrolki z elementem podrzędnym <zonetemplate> zawierającym odwołania deklaratywne do kontrolki AppearanceEditorPart . Ponadto strona odwołuje się do kontrolki niestandardowej WebPart , używając Register dyrektywy dla zestawu i <aspSample:TextDisplayWebPart> elementu kontrolki.
<%@ page language="c#" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenu"
Src="DisplayModecs.ascx" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.CS.Controls"
Assembly="TextDisplayWebPartCS" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>
Text Display WebPart with AppearanceEditorPart
</title>
</head>
<body>
<form id="form1" runat="server">
<asp:webpartmanager id="WebPartManager1" runat="server" />
<uc1:DisplayModeMenu ID="DisplayModeMenu1" runat="server" />
<asp:webpartzone id="zone1" runat="server">
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart" />
</zonetemplate>
</asp:webpartzone>
<asp:EditorZone ID="EditorZone1" runat="server">
<ZoneTemplate>
<asp:AppearanceEditorPart ID="AppearanceEditorPart1"
runat="server"
Title="Edit TextDisplayWebPart Properties" />
</ZoneTemplate>
</asp:EditorZone>
</form>
</body>
</html>
<%@ page language="vb" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenu"
Src="DisplayModevb.ascx" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.VB.Controls"
Assembly="TextDisplayWebPartVB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>
Text Display WebPart with AppearanceEditorPart
</title>
</head>
<body>
<form id="form1" runat="server">
<asp:webpartmanager id="WebPartManager1" runat="server" />
<uc1:DisplayModeMenu ID="DisplayModeMenu1" runat="server" />
<asp:webpartzone id="zone1" runat="server">
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart" />
</zonetemplate>
</asp:webpartzone>
<asp:EditorZone ID="EditorZone1" runat="server">
<ZoneTemplate>
<asp:AppearanceEditorPart ID="AppearanceEditorPart1"
runat="server"
Title="Edit TextDisplayWebPart Properties" />
</ZoneTemplate>
</asp:EditorZone>
</form>
</body>
</html>
Trzecią częścią przykładu kodu jest klasa niestandardowa WebPart o nazwie TextDisplayWebPart, do której odwołuje się strona sieci Web. Aby można było uruchomić przykładowy kod, należy skompilować ten kod źródłowy. Można je skompilować jawnie i umieścić wynikowy zestaw w folderze Bin witryny sieci Web lub globalnej pamięci podręcznej zestawów. Alternatywnie można umieścić kod źródłowy w folderze App_Code witryny, w którym będzie dynamicznie kompilowany w czasie wykonywania. Aby zapoznać się z przewodnikiem, który pokazuje sposób kompilowania, zobacz Przewodnik: tworzenie i używanie niestandardowej kontrolki serwera sieci Web.
using System;
using System.Collections;
using System.ComponentModel;
using System.Drawing;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
namespace Samples.AspNet.CS.Controls
{
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
public class TextDisplayWebPart : WebPart
{
private String _contentText = null;
TextBox input;
Label DisplayContent;
Literal lineBreak;
[Personalizable(), WebBrowsable]
public String ContentText
{
get { return _contentText; }
set { _contentText = value; }
}
protected override void CreateChildControls()
{
Controls.Clear();
DisplayContent = new Label();
DisplayContent.BackColor = Color.LightBlue;
DisplayContent.Text = this.ContentText;
this.Controls.Add(DisplayContent);
lineBreak = new Literal();
lineBreak.Text = @"<br />";
Controls.Add(lineBreak);
input = new TextBox();
this.Controls.Add(input);
Button update = new Button();
update.Text = "Set Label Content";
update.Click += new EventHandler(this.submit_Click);
this.Controls.Add(update);
}
private void submit_Click(object sender, EventArgs e)
{
// Update the label string.
if (!string.IsNullOrEmpty(input.Text))
{
_contentText = input.Text + @"<br />";
input.Text = String.Empty;
DisplayContent.Text = this.ContentText;
}
}
}
}
Imports System.Collections
Imports System.ComponentModel
Imports System.Drawing
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Namespace Samples.AspNet.VB.Controls
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
Public Class TextDisplayWebPart
Inherits WebPart
Private _contentText As String = Nothing
Private _fontStyle As String = Nothing
Private input As TextBox
Private DisplayContent As Label
Private lineBreak As Literal
<Personalizable(), WebBrowsable()> _
Public Property ContentText() As String
Get
Return _contentText
End Get
Set(ByVal value As String)
_contentText = value
End Set
End Property
Protected Overrides Sub CreateChildControls()
Controls.Clear()
DisplayContent = New Label()
DisplayContent.BackColor = Color.LightBlue
DisplayContent.Text = Me.ContentText
Me.Controls.Add(DisplayContent)
lineBreak = New Literal()
lineBreak.Text = "<br />"
Controls.Add(lineBreak)
input = New TextBox()
Me.Controls.Add(input)
Dim update As New Button()
update.Text = "Set Label Content"
AddHandler update.Click, AddressOf Me.submit_Click
Me.Controls.Add(update)
End Sub
Private Sub submit_Click(ByVal sender As Object, _
ByVal e As EventArgs)
' Update the label string.
If input.Text <> String.Empty Then
_contentText = input.Text + "<br />"
input.Text = String.Empty
DisplayContent.Text = Me.ContentText
End If
End Sub
End Class
End Namespace
Po załadowaniu strony w przeglądarce możesz wybrać pozycję Tryb edycji w kontrolce rozwijanej Tryb wyświetlania , aby przełączyć się do trybu edycji. Możesz kliknąć menu czasowników (strzałkę w dół) na pasku TextDisplayWebPart tytułu kontrolki, a następnie kliknąć przycisk Edytuj , aby edytować kontrolkę. Gdy edytowany interfejs użytkownika jest widoczny, możesz zobaczyć kontrolkę AppearanceEditorPart . Jeśli wprowadzisz pewne zmiany w interfejsie użytkownika edycji i klikniesz przycisk Zastosuj , możesz użyć listy rozwijanej Tryb wyświetlania , aby zwrócić stronę do trybu przeglądania i zobaczyć pełny efekt zmian edycji.
Uwagi
Klasa AppearanceEditorPart jest kontrolką edytora, która pochodzi z EditorPart klasy i służy do edytowania właściwości, które mają wpływ na wygląd skojarzonej WebPart lub innej kontrolki serwera.
Kontrolka AppearanceEditorPart umożliwia użytkownikom końcowym edytowanie kilku właściwości interfejsu użytkownika kontrolki WebPart . Typ kontrolki wyświetlanej na stronie w celu edytowania każdej wartości właściwości znajduje się w sąsiedniej komórce poniższej tabeli.
| Właściwość | Kontrolka używana do edytowania właściwości |
|---|---|
| Title | Kontrolka TextBox służy do ustawiania tekstu tytułu. |
| ChromeType | Kontrolka DropDownList służy do wybierania typu opcji tytułu i obramowania. |
| Direction | Kontrolka DropDownList służy do wybierania kierunku przepływu zawartości na stronie. |
| Height | Kontrolka TextBox służy do ustawiania liczby wysokości, a kontrolka DropDownList służy do wybierania jednostek. |
| Width | Kontrolka TextBox służy do ustawiania liczby wysokości, a kontrolka DropDownList służy do wybierania jednostek. |
| Hidden | Kontrolka CheckBox służy do wskazywania, czy kontrolka jest ukryta. |
Kontrolka AppearanceEditorPart staje się widoczna tylko wtedy, gdy strona składników Web Part jest w trybie edycji, a po wybraniu określonej WebPart kontrolki do edycji. Kontrolka AppearanceEditorPart , podobnie jak wszystkie inne EditorPart kontrolki, znajduje się w EditorZone strefie.
Ważne
Strefa EditorZone może zawierać tylko EditorPart kontrolki i EditorPart nie można umieścić kontrolek w żadnym innym typie strefy.
Klasa AppearanceEditorPart ma minimalny zestaw właściwości. Właściwość służy do pobierania Title lub ustawiania ciągu, który jest wyświetlany jako tytuł, gdy kontrolka jest widoczna. Właściwość DefaultButton ustawia dziedziczona właściwość z kontrolki Panel , tak aby domyślna kontrolka, która odbiera fokus w AppearanceEditorPart kontrolce, jest taka sama jak domyślna w kontrolce podstawowej Panel .
Klasa AppearanceEditorPart ma również dwie ważne metody. Metoda SyncChanges zastępuje metodę bazową EditorPart z klasy . Ta metoda jest krytyczna, ponieważ umożliwia pobieranie wartości właściwości z WebPart kontrolki, która jest edytowana i przypisywanie ich do pól w kontrolce edytora. Metoda ApplyChanges jest również ważna, ponieważ pobiera wartości ustawione przez użytkownika w kontrolkach edycji i aktualizuje te wartości właściwości w edytowanej kontrolce.
W większości przypadków kontrolka AppearanceEditorPart powinna być używana w formacie trwałości strony, deklarując <asp:appearanceditorpart> element wewnątrz <zonetemplate> elementu, który z kolei jest zawarty przez <asp:editorzone> element na stronie sieci Web.
Aby edytować inne właściwości i zachowanie kontrolek, można użyć innych EditorPart kontrolek dostarczonych WebPart z zestawem kontrolek składników Web Part. Te kontrolki BehaviorEditorPartobejmują elementy , LayoutEditorParti PropertyGridEditorPart. Dostarczone EditorPart kontrolki powinny udostępniać większość funkcji edycji wymaganych do edycji WebPart kontrolek, ale można również utworzyć kontrolkę edytora niestandardowego, dziedzicując po EditorPart klasie. Aby zapoznać się z przykładem kodu, zobacz EditorPart temat omówienie klas.
Uwaga
Aby zwiększyć dostępność, kontrolka AppearanceEditorPart jest renderowana w elemecie <fieldset> . Element <fieldset> grupuje powiązany zestaw kontrolek używanych do edycji w kontrolce AppearanceEditorPart i ułatwia nawigację z kartami między tymi kontrolkami zarówno dla wizualizacji (takich jak zwykłe przeglądarki sieci Web) i agentów użytkowników zorientowanych na mowę (takich jak oprogramowanie do czytania ekranu).
Ułatwienia dostępu
Znaczniki renderowane domyślnie dla tej kontrolki mogą nie być zgodne ze standardami ułatwień dostępu, takimi jak wytyczne dotyczące ułatwień dostępu do zawartości sieci Web 1.0 (WCAG) priorytet 1. Aby uzyskać szczegółowe informacje na temat obsługi ułatwień dostępu dla tej kontrolki, zobacz ASP.NET Controls and Accessibility (Kontrolki i ułatwienia dostępu).
Konstruktory
| AppearanceEditorPart() |
Inicjuje nowe wystąpienie klasy AppearanceEditorPart. |
Właściwości
| AccessKey |
Pobiera lub ustawia klucz dostępu, który umożliwia szybkie przejście do kontroli serwera sieci Web. (Odziedziczone po WebControl) |
| 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ę dowolnych atrybutów (tylko do renderowania), które nie odpowiadają właściwościom kontrolki. (Odziedziczone po WebControl) |
| BackColor |
Pobiera lub ustawia kolor tła kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
| BackImageUrl |
Pobiera lub ustawia adres URL obrazu tła dla kontrolki panelu. (Odziedziczone po Panel) |
| BindingContainer |
Pobiera kontrolkę zawierającą powiązanie danych tego formantu. (Odziedziczone po Control) |
| BorderColor |
Pobiera lub ustawia kolor obramowania kontrolki Sieci Web. (Odziedziczone po WebControl) |
| BorderStyle |
Pobiera lub ustawia styl obramowania kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
| BorderWidth |
Pobiera lub ustawia szerokość obramowania kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
| ChildControlsCreated |
Pobiera wartość wskazującą, czy kontrolki podrzędne kontrolki serwera zostały utworzone. (Odziedziczone po Control) |
| ChromeState |
Pobiera lub ustawia, czy kontrolka części jest w stanie zminimalizowanym, czy normalnym. (Odziedziczone po Part) |
| ChromeType |
Pobiera lub ustawia typ obramowania, który zawiera kontrolkę składników Web Part. (Odziedziczone po Part) |
| ClientID |
Pobiera identyfikator kontrolki dla znaczników HTML generowanych przez ASP.NET. (Odziedziczone po Control) |
| ClientIDMode |
Pobiera lub ustawia algorytm używany do generowania ClientID wartości 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, który zawiera kontrolki podrzędne dla określonej kontrolki serwera w hierarchii interfejsu użytkownika. (Odziedziczone po Part) |
| ControlStyle |
Pobiera styl kontrolki serwera sieci Web. Ta właściwość jest używana głównie przez deweloperów sterujących. (Odziedziczone po WebControl) |
| ControlStyleCreated |
Pobiera wartość wskazującą Style , czy obiekt został utworzony dla ControlStyle właściwości. Ta właściwość jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl) |
| CssClass |
Pobiera lub ustawia klasę kaskadowego arkusza stylów (CSS) renderowaną przez kontrolkę serwera sieci Web na kliencie. (Odziedziczone po WebControl) |
| 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) |
| DefaultButton |
Zastępuje właściwość podstawową dziedziczona z kontrolki Panel , aby ukryć właściwość przed projektantami i uniemożliwić jej wpływ na motywy. Chociaż jest ona publiczna, ta właściwość jest używana do domyślnego renderowania tej kontrolki i nie ma być wywoływana z kodu dewelopera. |
| Description |
Pobiera lub ustawia krótką frazę, która podsumowuje działanie kontrolki części do użycia w etykietkach narzędzi i katalogach kontrolek części. (Odziedziczone po Part) |
| DesignMode |
Pobiera wartość wskazującą, czy kontrolka jest używana na powierzchni projektowej. (Odziedziczone po Control) |
| Direction |
Pobiera lub ustawia kierunek wyświetlania kontrolek zawierających tekst w kontrolce Panel . (Odziedziczone po Panel) |
| Display |
Pobiera wartość wskazującą, czy kontrolka powinna być wyświetlana, gdy skojarzona WebPart z nią kontrolka jest w trybie edycji. (Odziedziczone po EditorPart) |
| DisplayTitle |
Pobiera ciąg zawierający tekst tytułu wyświetlany na pasku tytułu kontrolki EditorPart . (Odziedziczone po EditorPart) |
| Enabled |
Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera sieci Web jest włączona. (Odziedziczone po WebControl) |
| EnableTheming |
Pobiera lub ustawia wartość wskazującą, czy motywy mają zastosowanie do tej kontrolki. (Odziedziczone po WebControl) |
| 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. (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) |
| Font |
Pobiera właściwości czcionki skojarzone z kontrolką serwera sieci Web. (Odziedziczone po WebControl) |
| ForeColor |
Pobiera lub ustawia kolor pierwszego planu (zazwyczaj kolor tekstu) kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
| GroupingText |
Pobiera lub ustawia podpis dla grupy kontrolek zawartych w kontrolce panelu. (Odziedziczone po Panel) |
| HasAttributes |
Pobiera wartość wskazującą, czy kontrolka ma ustawione atrybuty. (Odziedziczone po WebControl) |
| HasChildViewState |
Pobiera wartość wskazującą, czy kontrolki podrzędne bieżącego formantu serwera mają zapisane ustawienia stanu widoku. (Odziedziczone po Control) |
| Height |
Pobiera lub ustawia wysokość kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
| HorizontalAlign |
Pobiera lub ustawia wyrównanie poziome zawartości w panelu. (Odziedziczone po Panel) |
| 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) |
| IsChildControlStateCleared |
Pobiera wartość wskazującą, czy kontrolki zawarte w tej kontrolce mają stan kontroli. (Odziedziczone po Control) |
| IsEnabled |
Pobiera wartość wskazującą, czy kontrolka jest włączona. (Odziedziczone po WebControl) |
| IsTrackingViewState |
Pobiera wartość wskazującą, czy kontrolka serwera zapisuje zmiany w stanie widoku. (Odziedziczone po Control) |
| IsViewStateEnabled |
Pobiera wartość wskazującą, czy dla tej kontrolki jest włączony stan widoku. (Odziedziczone po Control) |
| LoadViewStateByID |
Pobiera wartość wskazującą, czy kontrolka uczestniczy w ładowaniu stanu widoku przez ID zamiast indeksu. (Odziedziczone po Control) |
| 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. (Odziedziczone po Control) |
| Page |
Pobiera odwołanie do Page wystąpienia, które zawiera kontrolkę serwera. (Odziedziczone po Control) |
| Parent |
Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii sterowania stronami. (Odziedziczone po Control) |
| RenderingCompatibility |
Pobiera wartość określającą wersję ASP.NET, z którą renderowany kod HTML będzie zgodny. (Odziedziczone po Control) |
| ScrollBars |
Pobiera lub ustawia widoczność i położenie pasków przewijania w kontrolce Panel . (Odziedziczone po Panel) |
| 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 do kontrolki. (Odziedziczone po WebControl) |
| Style |
Pobiera kolekcję atrybutów tekstowych, które będą renderowane jako atrybut stylu na zewnętrznym tagu kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
| SupportsDisabledAttribute |
Pobiera wartość wskazującą, czy kontrolka powinna ustawić |
| TabIndex |
Pobiera lub ustawia indeks tabulacji kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
| TagKey |
Pobiera wartość odpowiadającą HtmlTextWriterTag tej kontroli serwera sieci Web. Ta właściwość jest używana głównie przez deweloperów sterujących. (Odziedziczone po WebControl) |
| TagName |
Pobiera nazwę tagu kontrolki. Ta właściwość jest używana głównie przez deweloperów sterujących. (Odziedziczone po WebControl) |
| TemplateControl |
Pobiera lub ustawia odwołanie do szablonu zawierającego tę kontrolkę. (Odziedziczone po Control) |
| TemplateSourceDirectory |
Pobiera katalog wirtualny elementu Page lub UserControl , który zawiera bieżącą kontrolkę serwera. (Odziedziczone po Control) |
| Title |
Pobiera lub ustawia tytuł kontrolki edytora. |
| ToolTip |
Pobiera lub ustawia tekst wyświetlany po umieszczeniu wskaźnika myszy na kontrolce serwera sieci Web. (Odziedziczone po WebControl) |
| 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 umożliwia zapisanie i przywrócenie stanu widoku kontrolki serwera w wielu żądaniach dla tej samej strony. (Odziedziczone po Control) |
| ViewStateIgnoresCase |
Pobiera wartość wskazującą, czy StateBag obiekt jest niewrażliwy na wielkość liter. (Odziedziczone po Control) |
| ViewStateMode |
Pobiera lub ustawia tryb stanu widoku 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) |
| WebPartManager |
Pobiera odwołanie do kontrolki WebPartManager skojarzonej z bieżącą stroną sieci Web. (Odziedziczone po EditorPart) |
| WebPartToEdit |
Pobiera odwołanie do kontrolki WebPart , która jest obecnie edytowana. (Odziedziczone po EditorPart) |
| Width |
Pobiera lub ustawia szerokość kontrolki serwera sieci Web. (Odziedziczone po WebControl) |
| Wrap |
Pobiera lub ustawia wartość wskazującą, czy zawartość jest zawijana w panelu. (Odziedziczone po Panel) |
| Zone |
Pobiera odwołanie do EditorZoneBase strefy zawierającej kontrolkę EditorPart . (Odziedziczone po EditorPart) |
Metody
| AddAttributesToRender(HtmlTextWriter) |
Dodaje informacje o obrazie tła, wyrównaniu, zawijeniu i kierunku do listy atrybutów do renderowania. (Odziedziczone po Panel) |
| AddedControl(Control, Int32) |
Wywoływane po dodaniu kontrolki podrzędnej do Controls kolekcji Control obiektu. (Odziedziczone po Control) |
| AddParsedSubObject(Object) |
Powiadamia formant serwera, że element ( XML lub HTML) został przeanalizowany i dodaje element do obiektu kontrolki ControlCollection serwera. (Odziedziczone po Control) |
| ApplyChanges() |
Zapisuje wartości z AppearanceEditorPart kontrolki do odpowiednich właściwości w skojarzonej WebPart kontrolce. |
| ApplyStyle(Style) |
Kopiuje wszystkie elementy inne niż elementy określonego stylu do kontrolki Sieci Web, zastępując wszystkie istniejące elementy stylu kontrolki. Ta metoda jest używana głównie przez deweloperów kontrolek. (Odziedziczone po WebControl) |
| ApplyStyleSheetSkin(Page) |
Stosuje właściwości stylu zdefiniowane w arkuszu stylów strony do kontrolki. (Odziedziczone po Control) |
| BeginRenderTracing(TextWriter, Object) |
Rozpoczyna śledzenie danych renderowania w czasie projektowania. (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 sterowania dla kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control) |
| ClearChildState() |
Usuwa informacje o stanie widoku i stanie sterowania 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 Inheritwartość . (Odziedziczone po Control) |
| CopyBaseAttributes(WebControl) |
Kopiuje właściwości, które nie są hermetyzowane przez Style obiekt z określonej kontrolki serwera sieci Web do kontrolki serwera sieci Web, z którego jest wywoływana ta metoda. Ta metoda jest używana głównie przez deweloperów sterujących. (Odziedziczone po WebControl) |
| 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. (Odziedziczone po Control) |
| CreateControlCollection() |
Tworzy nowy ControlCollection obiekt do przechowywania kontrolek podrzędnych (literał i serwer) kontrolki serwera. (Odziedziczone po Control) |
| CreateControlStyle() |
Tworzy obiekt stylu, który jest używany wewnętrznie przez kontrolkę Panel w celu zaimplementowania wszystkich właściwości pokrewnych stylu. (Odziedziczone po Panel) |
| DataBind() |
Wiąże źródło danych z wywołaną kontrolką serwera i wszystkimi jej kontrolkami podrzędnymi. (Odziedziczone po Part) |
| 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. (Odziedziczone po Control) |
| DataBindChildren() |
Wiąże źródło danych z kontrolkami podrzędnymi kontrolki serwera. (Odziedziczone po Control) |
| Dispose() |
Umożliwia kontroli serwera przeprowadzenie końcowego czyszczenia przed zwolnieniem z pamięci. (Odziedziczone po Control) |
| EndRenderTracing(TextWriter, Object) |
Kończy śledzenie danych renderowania w czasie projektowania. (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 danych wejściowych na kontrolkę. (Odziedziczone po Control) |
| GetDesignModeState() |
Pobiera bieżący stan strefy nadrzędnej EditorPart kontrolki. (Odziedziczone po EditorPart) |
| 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 wartość bieżącego wystąpienia. (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ą zarejestrowane dla kontrolki, czy dla kontrolek podrzędnych. (Odziedziczone po Control) |
| IsLiteralContent() |
Określa, czy kontrolka serwera przechowuje 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) |
Przywraca informacje o stanie widoku z poprzedniego żądania, które zostało zapisane za pomocą SaveViewState() metody . (Odziedziczone po WebControl) |
| MapPathSecure(String) |
Pobiera ścieżkę fizyczną, z którą mapuje się ścieżka wirtualna , bezwzględna lub względna. (Odziedziczone po Control) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
| MergeStyle(Style) |
Kopiuje wszystkie elementy inne niż elementy określonego stylu do kontrolki Sieci Web, ale nie zastąpi żadnych istniejących elementów stylu kontrolki. Ta metoda jest używana głównie przez deweloperów sterujących. (Odziedziczone po WebControl) |
| 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 EditorPart) |
| OnUnload(EventArgs) |
Unload Zgłasza zdarzenie. (Odziedziczone po Control) |
| OpenFile(String) |
Pobiera element Stream 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 z Controls kolekcji Control obiektu. (Odziedziczone po Control) |
| Render(HtmlTextWriter) |
Renderuje kontrolkę do określonego składnika zapisywania HTML. (Odziedziczone po WebControl) |
| RenderBeginTag(HtmlTextWriter) |
Renderuje tag otwierający HTML kontrolki Panel do określonego składnika zapisywania. (Odziedziczone po Panel) |
| RenderChildren(HtmlTextWriter) |
Wyprowadza zawartość elementów podrzędnych formantu serwera do dostarczonego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie. (Odziedziczone po Control) |
| RenderContents(HtmlTextWriter) |
Renderuje zawartość kontrolki do określonego składnika zapisywania. Ta metoda jest używana głównie przez deweloperów sterujących. (Odziedziczone po WebControl) |
| 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. (Odziedziczone po Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Dane wyjściowe serwera steruje zawartością dostarczonego HtmlTextWriter obiektu przy użyciu dostarczonego ControlAdapter obiektu. (Odziedziczone po Control) |
| RenderEndTag(HtmlTextWriter) |
Renderuje tag zamykający HTML kontrolki Panel do określonego składnika zapisywania. (Odziedziczone po Panel) |
| ResolveAdapter() |
Pobiera kartę sterową 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 dowolny stan, który został zmodyfikowany po TrackViewState() wywołaniu metody. (Odziedziczone po WebControl) |
| SetDesignModeState(IDictionary) |
Stosuje cechy stanu trybu projektowania do bieżącej EditorZoneBase strefy, która zawiera kontrolkę EditorPart . (Odziedziczone po EditorPart) |
| SetRenderMethodDelegate(RenderMethod) |
Przypisuje delegata programu obsługi zdarzeń w celu renderowania kontrolki serwera i jego zawartości 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) |
| SyncChanges() |
Pobiera wartości właściwości z WebPart kontrolki i przypisuje je do skojarzonej AppearanceEditorPart kontrolki. |
| ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
| TrackViewState() |
Powoduje, że kontrolka będzie śledzić zmiany stanu widoku, dzięki czemu mogą być przechowywane we właściwości obiektu ViewState . (Odziedziczone po WebControl) |
Zdarzenia
| DataBinding |
Występuje, gdy kontrolka serwera wiąże się ze źródłem danych. (Odziedziczone po Control) |
| 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. (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
| IAttributeAccessor.GetAttribute(String) |
Pobiera atrybut kontrolki Sieci Web o określonej nazwie. (Odziedziczone po WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Ustawia atrybut kontrolki Sieci Web na określoną nazwę i wartość. (Odziedziczone po WebControl) |
| ICompositeControlDesignerAccessor.RecreateChildControls() |
Umożliwia deweloperowi projektanta kontrolki części złożonej ponowne utworzenie kontrolek podrzędnych kontrolki kontrolki na powierzchni projektowej. (Odziedziczone po Part) |
| IControlBuilderAccessor.ControlBuilder |
Aby uzyskać opis tego elementu członkowskiego, zobacz ControlBuilder. (Odziedziczone po Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Aby uzyskać opis tego elementu członkowskiego, zobacz GetDesignModeState(). (Odziedziczone po Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Aby uzyskać opis tego elementu członkowskiego, zobacz SetDesignModeState(IDictionary). (Odziedziczone po Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Aby uzyskać opis tego elementu członkowskiego, zobacz SetOwnerControl(Control). (Odziedziczone po Control) |
| IControlDesignerAccessor.UserData |
Aby uzyskać opis tego elementu członkowskiego, zobacz UserData. (Odziedziczone po Control) |
| IDataBindingsAccessor.DataBindings |
Aby uzyskać opis tego elementu członkowskiego, zobacz DataBindings. (Odziedziczone po Control) |
| IDataBindingsAccessor.HasDataBindings |
Aby uzyskać opis tego elementu członkowskiego, zobacz HasDataBindings. (Odziedziczone po Control) |
| IExpressionsAccessor.Expressions |
Aby uzyskać opis tego elementu członkowskiego, zobacz Expressions. (Odziedziczone po Control) |
| IExpressionsAccessor.HasExpressions |
Aby uzyskać opis tego elementu członkowskiego, zobacz HasExpressions. (Odziedziczone po Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Aby uzyskać opis tego elementu członkowskiego, zobacz AddParsedSubObject(Object). (Odziedziczone po Control) |
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. |
| GetDefaultValues(INamingContainer) |
Pobiera kolekcję wartości domyślnych dla określonej kontrolki danych. |
| GetMetaTable(INamingContainer) |
Pobiera metadane tabeli dla określonej kontrolki danych. |
| SetMetaTable(INamingContainer, MetaTable) |
Ustawia metadane tabeli dla określonej kontrolki danych. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Ustawia metadane tabeli i domyślne mapowanie wartości dla określonej kontrolki danych. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Ustawia metadane tabeli i domyślne mapowanie wartości dla określonej kontrolki danych. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Określa, czy metadane tabeli są dostępne. |
| EnableDynamicData(INamingContainer, Type) |
Włącza zachowanie danych dynamicznych dla określonej kontrolki danych. |
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Włącza zachowanie danych dynamicznych dla określonej kontrolki danych. |
| EnableDynamicData(INamingContainer, Type, Object) |
Włącza zachowanie danych dynamicznych dla określonej kontrolki danych. |
Dotyczy
Zobacz też
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla