Udostępnij za pośrednictwem


WebPart Klasa

Definicja

Służy jako klasa bazowa dla niestandardowych kontrolek składników Web Part ASP.NET, dodając do klasy bazowej Part niektóre dodatkowe właściwości interfejsu użytkownika, możliwość tworzenia połączeń i zachowania personalizacji.

public ref class WebPart abstract : System::Web::UI::WebControls::WebParts::Part, System::Web::UI::WebControls::WebParts::IWebActionable, System::Web::UI::WebControls::WebParts::IWebEditable, System::Web::UI::WebControls::WebParts::IWebPart
public abstract class WebPart : System.Web.UI.WebControls.WebParts.Part, System.Web.UI.WebControls.WebParts.IWebActionable, System.Web.UI.WebControls.WebParts.IWebEditable, System.Web.UI.WebControls.WebParts.IWebPart
type WebPart = class
    inherit Part
    interface IWebPart
    interface IWebActionable
    interface IWebEditable
Public MustInherit Class WebPart
Inherits Part
Implements IWebActionable, IWebEditable, IWebPart
Dziedziczenie
Pochodne
Implementuje

Przykłady

W poniższym przykładzie kodu pokazano, jak utworzyć kontrolkę WebPart i odwołać się do niej na stronie sieci Web.

Pierwsza część przykładu zawiera kod niestandardowej WebPart kontrolki o nazwie TextDisplayWebPart. Ta kontrolka pokazuje, jak utworzyć prostą kontrolkę niestandardową WebPart , która zapewnia dostęp do funkcji zestawu kontrolek składników Web Part. Aby przykład kodu został uruchomiony, należy skompilować ten kod źródłowy. Można je jawnie skompilować i umieścić wynikowy zestaw w folderze Bin witryny sieci Web lub globalnej pamięci podręcznej zestawów. Możesz też umieścić kod źródłowy w folderze App_Code witryny, w którym będzie dynamicznie kompilowany w czasie wykonywania. W tym przykładzie kodu przyjęto założenie, że skompilujesz kod źródłowy do zestawu, umieść go w podfolderze Bin aplikacji internetowej i odwołujesz się do zestawu dyrektywą Register na stronie sieci Web. Aby zapoznać się z przewodnikiem, który pokazuje obie metody kompilowania, zobacz Przewodnik: opracowywanie i używanie niestandardowej kontroli serwera sieci Web.

using System;
using System.Security.Permissions;
using System.Web;
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;

    public TextDisplayWebPart()
    {
      this.AllowClose = false;
    }

    [Personalizable(), WebBrowsable]
    public String ContentText
    {
      get { return _contentText; }
      set { _contentText = value; }
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      DisplayContent.BackColor = 
        System.Drawing.Color.LightBlue;
      DisplayContent.Text = this.ContentText;
      this.Controls.Add(DisplayContent);
      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);
      ChildControlsCreated = true;
    }

    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.Security.Permissions
Imports System.Web
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 input As TextBox
    Private DisplayContent As Label
    
    
    Public Sub New() 
      Me.AllowClose = False
    End Sub
    
    <Personalizable(), WebBrowsable()>  _
    Public Property ContentText() As String 
        Get
            Return _contentText
        End Get
        Set
            _contentText = value
        End Set
    End Property
     
    Protected Overrides Sub CreateChildControls() 
        Controls.Clear()
        DisplayContent = New Label()
        DisplayContent.Text = Me.ContentText
        DisplayContent.BackColor = _
          System.Drawing.Color.LightBlue
        Me.Controls.Add(DisplayContent)
        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)
        ChildControlsCreated = True
    
    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

W drugiej części przykładu pokazano, jak odwoływać się do kontrolki TextDisplayWebPart na stronie ASP.NET sieci Web. Zwróć uwagę, że wiele różnych WebPart właściwości można przypisać deklaratywnie do kontrolki niestandardowej.

<%@ page language="C#" %>
<%@ 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>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc" />
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" />
        </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>
<%@ page language="VB" %>
<%@ 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>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc" />
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" />
        </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>

Uwagi

Podczas tworzenia kontrolek za pomocą funkcji składników Web Part dostępne są dwie podstawowe opcje. Możesz utworzyć niestandardowe kontrolki pochodzące z WebPart klasy lub utworzyć lub użyć innych kontrolek serwera. Istniejące kontrolki ASP.NET, niestandardowe kontrolki serwera i kontrolki użytkownika mogą mieć pełną funkcjonalność składników Web Part, deklarując je w obrębie (lub dodając je programowo do) WebPartZone kontrolkę strefy, z wynikiem, że zostaną opakowane z obiektami GenericWebPart w czasie wykonywania i traktowane jako prawdziwe WebPart kontrolki. Aby uzyskać szczegółowe informacje, zobacz dokumentację GenericWebPart klasy. Aby przyspieszyć programowanie i maksymalne ponowne użycie kodu, użycie istniejących kontrolek serwera może być dobrym rozwiązaniem. Aby uzyskać maksymalną kontrolę programową nad zachowaniem i funkcjami składników Web Part kontrolek, tworzenie niestandardowej kontrolki dziedziczonej WebPart z klasy jest często najlepszą opcją.

Klasa abstrakcyjna WebPart dziedziczy z kontrolki podstawowej Part i udostępnia podstawowe elementy dla wszystkich WebPart kontrolek. Klasa zawiera wspólny zestaw właściwości, które wpływają na wygląd interfejsu użytkownika. Właściwości AllowClose, AllowConnect, , AllowHideAllowEdit, AllowMinimizei AllowZoneChange określają, czy użytkownik aplikacji sieci Web może wchodzić w interakcję z kontrolką części w sposób wskazany przez daną nazwę właściwości. Właściwości CatalogIconImageUrl, ChromeStateHeightTitleHiddenDescriptionChromeTypeTitleIconImageUrlTitleUrlHelpUrli Width określają rozmiar, widoczność, wygląd i zawartość pomocniczą WebPart (na przykład tytuł i opis) dla kontrolki.

Relacja kontrolki WebPart do jej kontekstu w zestawie kontrolek składników Web Part jest określana przez właściwości, takie jak WebPartManager, które zawierają odwołanie do skojarzonego WebPartManager obiektu kontrolki i Zone, który odwołuje WebZone się do kontrolki zawierającej kontrolkę. Może istnieć tylko jedna WebPartManager kontrolka na stronę, a każde wystąpienie kontrolki WebPart może znajdować się tylko w jednym WebZone miejscu.

Uwaga

Kontrolkę WebPart można umieścić poza strefą na stronie sieci Web, ale w tym przypadku działa ona jako normalna kontrola serwera i traci prawie wszystkie funkcje składników Web Part.

Kilka innych ważnych właściwości ma wpływ na unikatowe WebPart funkcje kontrolek. Właściwość AuthorizationFilter umożliwia deweloperom ustawienie dowolnego ciągu, którego można użyć jako filtru w czasie wykonywania w celu określenia, czy kontrolka jest dodawana do strony. Używana razem z funkcją, taką jak zarządzanie rolami, AuthorizationFilter właściwość zapewnia przydatny mechanizm tworzenia widoków na podstawie zdefiniowanych ról użytkownika. Właściwość ExportMode wskazuje, czy podczas eksportowania wszystkie dostępne dane właściwości kontrolki są eksportowane, czy tylko dane niewrażliwe. Dzięki temu deweloperzy mogą rozróżniać dane poufne i dane, które nie są przeznaczone do celów bezpieczeństwa. Właściwość WebBrowsableObject zwraca odwołanie do wystąpienia kontrolki WebPart , aby EditorPart kontrolka mogła ją edytować, gdy strona jest w trybie edycji. Na koniec istnieje kilka właściwości, które wskazują stan kontrolki względem pozostałej części strony. Właściwość IsClosed wskazuje, czy kontrolka jest zamknięta (a tym samym dodana do PageCatalogPart obiektu), czy też jest otwarta i dostępna na stronie. Właściwość IsShared wskazuje, czy kontrolka jest kontrolką współdzieloną (a kontrolką specyficzną dla użytkownika), co oznacza, że jest ona widoczna dla wszystkich użytkowników strony sieci Web. Właściwość IsStandalone wskazuje, czy kontrolka jest obecnie zawarta w strefie pochodnej WebPartZoneBase(na przykład WebPartZone). Wartość wskazuje false , że kontrolka znajduje się wewnątrz strefy i w związku z tym ma pełną funkcjonalność składników Web Part. Właściwość wskazuje, czy kontrolka IsStatic jest statyczna, czy dynamiczna. Statyczna kontrolka jest zadeklarowana w znacznikach strony sieci Web, podczas gdy kontrolka dynamiczna jest dodawana programowo.

Klasa WebPart udostępnia również kilka metod, które określają, co dzieje się w różnych punktach cyklu życia kontrolki. Na przykład OnConnectModeChanged metody i OnEditModeChanged mogą być zastępowane w klasie pochodnej w celu zapewnienia programowej kontroli nad renderowaniem zawartości kontrolki podczas zdarzenia odpowiadającego nazwie każdej metody.

Klasy pochodzące z WebPart programu mogą dodawać WebPartVerb obiekty do kolekcji Verbs . Czasowniki są renderowane w menu czasowników, które jest wyświetlane na pasku tytułu kontrolki WebPart . WebPartVerb obiekty zapewniają proste elementy interfejsu użytkownika dla typowych akcji użytkownika, takich jak ukrywanie lub minimalizowanie kontrolki lub wyświetlanie Pomocy.

Metoda CreateEditorParts tworzy kolekcję wszystkich kontrolek niestandardowych EditorPart skojarzonych z kontrolką WebPart . Deweloperzy mogą zastąpić tę metodę, aby tworzyła niestandardowe kontrolki zaprojektowane specjalnie do edytowania ich WebPart kontrolki. Metoda jest wywoływana, gdy użytkownik kliknie czasownik edycji kontrolki WebPart .

Konstruktory

WebPart()

Inicjuje klasę do użycia przez dziedziczone wystąpienie klasy. Ten konstruktor może być wywoływany tylko przez dziedziczonej klasy.

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)
AllowClose

Pobiera lub ustawia wartość wskazującą, czy użytkownik końcowy może zamknąć kontrolkę WebPart na stronie sieci Web.

AllowConnect

Pobiera lub ustawia wartość wskazującą, czy kontrolka WebPart umożliwia innym kontrolkom tworzenie z nim połączeń.

AllowEdit

Pobiera lub ustawia wartość wskazującą, czy użytkownik końcowy może zmodyfikować kontrolkę za pomocą interfejsu użytkownika udostępnionego przez co najmniej jedną EditorPart kontrolkęWebPart.

AllowHide

Pobiera lub ustawia wartość wskazującą, czy użytkownicy końcowi mogą ukryć kontrolkę WebPart .

AllowMinimize

Pobiera lub ustawia wartość wskazującą, czy użytkownicy końcowi mogą zminimalizować kontrolkę WebPart .

AllowZoneChange

Pobiera lub ustawia wartość wskazującą, czy użytkownik może przenieść kontrolkę WebPart między strefami WebPartZoneBase .

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)
AuthorizationFilter

Pobiera lub ustawia dowolny ciąg w celu określenia, czy kontrolka WebPart ma zostać dodana do strony.

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)
CatalogIconImageUrl

Pobiera lub ustawia adres URL na obraz reprezentujący kontrolkę składników Web Part w katalogu kontrolek.

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.

ChromeType

Pobiera lub ustawia typ obramowania, który zawiera kontrolkę składników Web 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)
ConnectErrorMessage

Otrzymuje komunikat o błędzie wyświetlany użytkownikom, jeśli podczas procesu połączenia wystąpią błędy.

Context

HttpContext Pobiera obiekt skojarzony z kontrolką serwera dla bieżącego żądania sieci Web.

(Odziedziczone po Control)
Controls

ControlCollection Pobiera obiekt zawierający 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

Pobiera lub ustawia identyfikator domyślnego przycisku zawartego w kontrolce Panel .

(Odziedziczone po Panel)
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.

DesignMode

Pobiera wartość wskazującą, czy kontrolka jest używana na powierzchni projektowej.

(Odziedziczone po Control)
Direction

Pobiera lub ustawia kierunek poziomy przepływa zawartości w kontrolce.

DisplayTitle

Pobiera ciąg zawierający pełny tekst tytułu wyświetlany na pasku tytułu wystąpienia kontrolki WebPart .

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)
ExportMode

Pobiera lub ustawia, czy wszystkie, niektóre lub żadne WebPart właściwości kontrolki nie mogą być eksportowane.

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)
HasSharedData

Pobiera wartość wskazującą, czy kontrolka WebPart ma skojarzone z nią jakiekolwiek udostępnione dane personalizacji.

HasUserData

Pobiera wartość wskazującą, czy kontrolka WebPart ma skojarzone z nią dane personalizacji użytkownika.

Height

Pobiera lub ustawia wysokość strefy.

HelpMode

Pobiera lub ustawia typ interfejsu użytkownika używanego do wyświetlania zawartości Pomocy dla kontrolki WebPart .

HelpUrl

Pobiera lub ustawia adres URL pliku Pomocy dla kontrolki WebPart .

Hidden

Pobiera lub ustawia wartość wskazującą, czy kontrolka WebPart jest wyświetlana na stronie sieci Web.

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)
ImportErrorMessage

Pobiera lub ustawia komunikat o błędzie, który jest używany, jeśli wystąpią błędy podczas importowania WebPart kontrolki.

IsChildControlStateCleared

Pobiera wartość wskazującą, czy kontrolki zawarte w tej kontrolce mają stan kontroli.

(Odziedziczone po Control)
IsClosed

Pobiera wartość wskazującą, czy kontrolka WebPart jest obecnie zamknięta na stronie składników Web Part.

IsEnabled

Pobiera wartość wskazującą, czy kontrolka jest włączona.

(Odziedziczone po WebControl)
IsShared

Pobiera wartość wskazującą, czy kontrolka WebPart jest współużytkowana, co oznacza, że jest ona widoczna dla wszystkich użytkowników strony składników Web Part.

IsStandalone

Pobiera wartość wskazującą, czy WebPart kontrolka jest autonomiczna, co oznacza, że nie jest ona zawarta w WebPartZoneBase strefie.

IsStatic

Pobiera wartość wskazującą, czy WebPart kontrolka jest statyczną kontrolką, co oznacza, że kontrolka jest zadeklarowana w znacznikach strony składników Web Part i nie jest dodawana do strony programowo.

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)
Subtitle

Pobiera ciąg połączony z wartością Title właściwości, aby utworzyć pełny tytuł kontrolki WebPart .

SupportsDisabledAttribute

Pobiera wartość wskazującą, czy kontrolka powinna ustawić disabled atrybut renderowanego elementu HTML na wartość "disabled", gdy właściwość kontrolki IsEnabled to false.

(Odziedziczone po Panel)
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 części.

TitleIconImageUrl

Pobiera lub ustawia adres URL obrazu używanego do reprezentowania kontrolki składników Web Part na pasku tytułu kontrolki.

TitleUrl

Pobiera lub ustawia adres URL na dodatkowe informacje o kontrolce WebPart .

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)
Verbs

Pobiera kolekcję niestandardowych czasowników skojarzonych z kontrolką WebPart .

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)
WebBrowsableObject

Pobiera odwołanie do kontrolki, WebPart aby umożliwić jej edycję za pomocą kontrolek niestandardowych EditorPart .

WebPartManager

Pobiera odwołanie do kontrolki WebPartManager skojarzonej z wystąpieniem kontrolki WebPart .

Width

Pobiera lub ustawia szerokość kontrolki serwera sieci Web.

Wrap

Pobiera lub ustawia wartość wskazującą, czy zawartość jest zawijana w panelu.

(Odziedziczone po Panel)
Zone

Pobiera strefę WebPartZoneBase , która obecnie zawiera kontrolkę WebPart .

ZoneIndex

Pobiera pozycję indeksu WebPart kontrolki w jej strefie.

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)
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 nullwartość .

(Odziedziczone po Control)
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)
CreateEditorParts()

Zwraca kolekcję kontrolek niestandardowych EditorPart , których można użyć do edycji WebPart kontrolki w trybie edycji.

DataBind()

Wiąże źródło danych z wywołaną kontrolką serwera i wszystkimi 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 id parametru.

(Odziedziczone po Control)
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 .

(Odziedziczone po Control)
Focus()

Ustawia fokus danych wejściowych na kontrolkę.

(Odziedziczone po Control)
GetDesignModeState()

Pobiera dane czasu 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 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)
OnClosing(EventArgs)

Umożliwia klasom pochodnym zapewnienie niestandardowej obsługi po WebPart zamknięciu kontrolki na stronie składników Web Part.

OnConnectModeChanged(EventArgs)

Umożliwia klasom pochodnym zapewnienie niestandardowej obsługi po WebPart rozpoczęciu lub zakończeniu procesu nawiązywania połączenia z innymi kontrolkami.

OnDataBinding(EventArgs)

DataBinding Zgłasza zdarzenie.

(Odziedziczone po Control)
OnDeleting(EventArgs)

Umożliwia klasom pochodnym zapewnienie niestandardowej obsługi, gdy kontrolka WebPart zostanie trwale usunięta ze strony składników Web Part.

OnEditModeChanged(EventArgs)

Umożliwia klasom pochodnym zapewnienie niestandardowej obsługi podczas WebPart wprowadzania lub opuszczania trybu edycji.

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)

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)

Ustawia dane czasu projektowania dla kontrolki.

(Odziedziczone po Control)
SetPersonalizationDirty()

Ustawia flagę wskazującą, że dane personalizacji uległy zmianie dla bieżącego WebPart wystąpienia kontrolki.

SetPersonalizationDirty(Control)

Ustawia flagę wskazującą, że dane personalizacji zostały zmienione dla określonej kontrolki serwera, która znajduje się w WebPartZoneBase strefie.

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)
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 .

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ż