Udostępnij za pośrednictwem


MasterPage Klasa

Definicja

Działa jako szablon i scalanie kontenera dla stron, które składają się tylko z Content kontrolek i ich odpowiednich kontrolek podrzędnych.

public ref class MasterPage : System::Web::UI::UserControl
public class MasterPage : System.Web.UI.UserControl
type MasterPage = class
    inherit UserControl
Public Class MasterPage
Inherits UserControl
Dziedziczenie

Przykłady

Ta sekcja zawiera cztery przykłady kodu:

  • W pierwszym przykładzie kodu pokazano, jak deklaratywnie utworzyć stronę wzorcową.

  • Drugi przykład kodu reprezentuje stronę zawartości skojarzona ze stroną wzorcową utworzoną w pierwszym przykładzie kodu.

  • W trzecim przykładzie kodu pokazano, jak dodać właściwość do strony wzorcowej.

  • W czwartym przykładzie kodu pokazano, jak używać strony zawartości do uzyskiwania dostępu do właściwości publicznej na stronie wzorcowej.

W poniższym przykładzie pokazano, jak deklaratywnie utworzyć stronę wzorcową i dodać do niej pewną zawartość przy użyciu strony zawartości. Pierwsza strona sieci Web to strona wzorcowa o nazwie MasterPageSample_1.master.

<%@ Master Language="C#" %>  
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">  
<html >  
<head runat="server">  
    <title>MasterPage Example</title>  
</head>  
<body>  
    <form id="form1" runat="server">  
    <div>  
        <asp:contentplaceholder id="ContentPlaceHolder1" runat="server" />  
    </div>  
    </form>  
</body>  
</html>  
<%@ Master Language="VB" %>  
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">  
<html >  
<head runat="server">  
    <title>MasterPage Example</title>  
</head>  
<body>  
    <form id="form1" runat="server">  
    <div>  
        <asp:contentplaceholder id="ContentPlaceHolder1" runat="server" />  
    </div>  
    </form>  
</body>  
</html>  

Poniższy przykład reprezentuje stronę zawartości skojarzona z elementem MasterPageSample_1.master. Zawiera kontrolkę i identyfikuje kontrolkę ContentContentPlaceHolder , z którą jest skojarzona zawartość przy użyciu ContentPlaceHolderID właściwości .

<%@ Page Language="C#" MasterPageFile="~/MasterPageSample_1cs.master" Title="Content Page"%>  

<asp:content   
    runat="server"  
    contentplaceholderid="ContentPlaceHolder1" >Hello, Master Pages!</asp:content>  
<%@ Page Language="VB" MasterPageFile="~/MasterPageSample_1vb.master" Title="Content Page"%>  

<asp:content   
    runat="server"  
    contentplaceholderid="ContentPlaceHolder1" >Hello, Master Pages!</asp:content>  

W poniższym przykładzie pokazano, jak dodać właściwość do strony wzorcowej. Atrybut ClassName jest używany do nadawania nazwy stronie wzorcowej.

<%@ Master Language="C#" ClassName="MasterExample" %>  

<script runat="server">  
        public string SiteName  
        {  
            get { return "My Site Name"; }  
        }  
</script>  

<html >  
<head runat="server">  
    <title>MasterPage Example</title>  
</head>  
<body>  
    <form id="form1" runat="server">  
    <div>  
        <asp:contentplaceholder id="ContentPlaceHolder1" runat="server">  
        </asp:contentplaceholder>  
    </div>  
    </form>  
</body>  
</html>  
<%@ Master Language="VB" ClassName="MasterExample" %>  

<script runat="server">  
  Public ReadOnly Property SiteName() As String  
    Get  
      Return "My Site Name"  
    End Get  
  End Property  

</script>  

<html >  
<head runat="server">  
    <title>MasterPage Example</title>  
</head>  
<body>  
    <form id="form1" runat="server">  
    <div>  
        <asp:contentplaceholder id="ContentPlaceHolder1" runat="server">  
        </asp:contentplaceholder>  
    </div>  
    </form>  
</body>  
</html>  

W poniższym przykładzie pokazano, jak za pomocą strony zawartości uzyskać dostęp do właściwości SiteName publicznej na stronie wzorcowej w poprzednim przykładzie kodu.

<%@ Page Language="C#" MasterPageFile="~/MasterPage.master" Title="MasterPage Example" %>  

<script runat="server">  
  protected void Page_Load(object sender, EventArgs e)  
  {  
    MasterExample m = (MasterExample)Page.Master;  
    mylabel.Text = m.SiteName;  
  }  
</script>  

<asp:Content ID="Content1" ContentPlaceHolderID="ContentPlaceHolder1" runat="Server">  
    Hello, Master Pages!  
    <asp:Label runat="server" Text="Label" ID="mylabel"></asp:Label>  
</asp:Content>  
<%@ Page Language="VB" MasterPageFile="~/MasterPage.master" Title="MasterPage Example" %>  

<script runat="server">  

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)  
    Dim m As MasterExample = CType(Page.Master, MasterPage)  
    mylabel.Text = m.SiteName  
  End Sub  
</script>  

<asp:Content ID="Content1" ContentPlaceHolderID="ContentPlaceHolder1" runat="Server">  
    Hello, Master Pages!  
    <asp:Label runat="server" Text="Label" ID="mylabel"></asp:Label>  
</asp:Content>  

Uwagi

Strona wzorcowa działa jako kontener szablonu i strona scalania stron zawartości w aplikacji internetowej ASP.NET. Strony wzorcowe zapewniają wygodny sposób udostępniania struktury i zawartości w zestawie stron zawartości. Symbole zastępcze zawartości służą do definiowania sekcji strony wzorcowej w celu zastąpienia zawartością ze stron zawartości.

W przypadku używania strony wzorcowej i powiązanych z nią stron zawartości wymagane tagi dokumentów XHTML (takie jak html, headi body) są dodawane tylko do strony wzorcowej i nie są już tworzone inne pliki .aspx (ASP.NET stron) jako autonomiczne strony sieci Web. Strony zawartości definiują zawartość do wstawienia do symboli zastępczych na stronie wzorcowej.

Gdy żądanie HTTP jest wykonywane dla strony w czasie wykonywania, strona wzorcowa i strony zawartości są łączone w jedną klasę o tej samej nazwie co strony zawartości. Wynikowa skompilowana, scalona klasa pochodzi z Page klasy .

Strona wzorcowa może zawierać bezpośrednie znaczniki i kontrolki serwera, a także kontrolki kontenera. Każdy element umieszczony na stronie wzorcowej poza kontrolką ContentPlaceHolder jest renderowany na wszystkich stronach, które wynikają ze scalania strony wzorcowej i stron zawartości.

Każda strona zawartości powiązana ze stroną wzorcową musi odwoływać się do strony wzorcowej w atrybucie MasterPageFile dyrektywy @ Page . Strony zawartości mogą zawierać tylko dyrektywę i co najmniej jedną Content kontrolkę@ Page. Wszystkie kontrolki tekstu strony, znaczników i serwera muszą być umieszczone w kontrolkach Content . Możesz zidentyfikować kontrolkę ContentPlaceHolder strony wzorcowej, Content z którą jest skojarzona kontrolka, ustawiając ContentPlaceHolderID właściwość kontrolki Content .

W czasie wykonywania zawartość dynamiczna z każdej Content kontrolki na żądanej stronie jest scalona ze stroną wzorcową w dokładnej lokalizacji powiązanej ContentPlaceHolder kontrolki. Nie ma to wpływu na inne znaczniki i kontrolki na stronie wzorcowej. Programy obsługi zdarzeń można zdefiniować zarówno w klasie master, jak i na stronie zawartości. Aby uzyskać więcej informacji, zobacz Zdarzenia na stronach wzorcowych i zawartości ASP.NET.

Klasa MasterPage jest skojarzona z plikami, które mają rozszerzenie master. Te pliki są kompilowane w czasie wykonywania jako MasterPage obiekty i są buforowane w pamięci serwera.

Strona wzorcowa jest udostępniana stronie zawartości za pośrednictwem Master właściwości klasy bazowej Page . Właściwość Master zwraca wystąpienie strony wzorcowej, ale jest wpisywana jako klasa bazowa MasterPage . Aby uzyskać dostęp do kontrolek, właściwości i funkcji strony wzorcowej, Master właściwość można rzutować na MasterPage obiekt. Nazwa klasy strony wzorcowej jest definiowana przy użyciu ClassName atrybutu dyrektywy @ Master .

Uwaga

Pliki z rozszerzeniami master nie są obsługiwane w przeglądarce.

Dyrektywy, które są prawidłowe na stronie wzorcowej, są takie same jak te, które są dostępne w UserControl obiekcie. Mogą zawierać następujące atrybuty:

  • AutoEventWireup

  • ClassName

  • CodeFile

  • CompilerMode

  • CompilerOptions

  • Debug

  • Description

  • EnableTheming

  • EnableViewState

  • Explicit

  • Inherits

  • Language

  • LinePragmas

  • MasterPageFile

  • Src

  • Strict

  • WarningLevel

Dyrektywy strony wzorcowej nie zastępują dyrektyw na poszczególnych stronach zawartości.

Strony wzorcowe są najczęściej tworzone deklaratywnie. Jeśli chcesz programowo utworzyć stronę wzorcową, utwórz bezpośrednio z MasterPage klasy . Oprócz rozszerzenia MasterPage klasy należy utworzyć plik master, aby wizualnie wyświetlić interfejs użytkownika skojarzony z klasami wywoływanymi w pliku źródłowym.

Uwaga

Podczas tworzenia strony wzorcowej, tworząc najpierw własną klasę, należy uwzględnić wszystkie przestrzenie nazw wymagane dla klas używanych przez stronę.

Aby uzyskać więcej informacji na temat stron wzorcowych, zobacz ASP.NET stron wzorcowych.

Konstruktory

MasterPage()

Tworzy nowe wystąpienie klasy MasterPage.

Właściwości

Adapter

Pobiera kartę specyficzną dla przeglądarki dla kontrolki.

(Odziedziczone po Control)
Application

Application Pobiera obiekt dla bieżącego żądania sieci Web.

(Odziedziczone po UserControl)
AppRelativeTemplateSourceDirectory

Pobiera lub ustawia względny katalog Page wirtualny aplikacji obiektu lub UserControl , który zawiera tę kontrolkę.

(Odziedziczone po Control)
AppRelativeVirtualPath

Pobiera lub ustawia względną aplikację, ścieżkę katalogu wirtualnego do pliku, z którego kontrolka jest analizowana i skompilowana.

(Odziedziczone po TemplateControl)
Attributes

Pobiera kolekcję wszystkich par nazw atrybutów i wartości zadeklarowanych w tagu kontrolki użytkownika w pliku .aspx.

(Odziedziczone po UserControl)
AutoHandlers
Przestarzałe.

Właściwość AutoHandlers została wycofana w ASP.NET NET 2.0. Jest on używany przez wygenerowane klasy i nie jest przeznaczony do użycia w kodzie.

(Odziedziczone po TemplateControl)
BindingContainer

Pobiera kontrolkę zawierającą powiązanie danych tego formantu.

(Odziedziczone po Control)
Cache

Cache Pobiera obiekt skojarzony z aplikacją zawierającą kontrolkę użytkownika.

(Odziedziczone po UserControl)
CachePolicy

Pobiera odwołanie do kolekcji parametrów buforowania dla tej kontrolki użytkownika.

(Odziedziczone po UserControl)
ChildControlsCreated

Pobiera wartość wskazującą, czy kontrolki podrzędne kontrolki serwera zostały utworzone.

(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 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)
ContentPlaceHolders

Pobiera listę kontrolek używanych ContentPlaceHolder przez stronę wzorcową do definiowania różnych regionów zawartości.

ContentTemplates

Pobiera listę kontrolek zawartości skojarzonych ze stroną wzorcową.

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

Pobiera lub ustawia wartość logiczną wskazującą, czy motywy mają zastosowanie do kontrolki pochodzącej TemplateControl z klasy.

(Odziedziczone po TemplateControl)
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)
HasChildViewState

Pobiera wartość wskazującą, czy kontrolki podrzędne bieżącego formantu serwera mają 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)
IsChildControlStateCleared

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

(Odziedziczone po Control)
IsPostBack

Pobiera wartość wskazującą, czy kontrolka użytkownika jest ładowana w odpowiedzi na powrót klienta, czy też jest ładowana i uzyskiwana dostęp po raz pierwszy.

(Odziedziczone po UserControl)
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)
Master

Pobiera nadrzędną stronę wzorcową bieżącego wzorca w scenariuszach zagnieżdżonych stron wzorcowych.

MasterPageFile

Pobiera lub ustawia nazwę strony wzorcowej zawierającej bieżącą zawartość.

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

HttpRequest Pobiera obiekt dla bieżącego żądania sieci Web.

(Odziedziczone po UserControl)
Response

HttpResponse Pobiera obiekt dla bieżącego żądania sieci Web.

(Odziedziczone po UserControl)
Server

HttpServerUtility Pobiera obiekt dla bieżącego żądania sieci Web.

(Odziedziczone po UserControl)
Session

HttpSessionState Pobiera obiekt dla bieżącego żądania sieci Web.

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

Pobiera wartość wskazującą, czy kontrolka TemplateControl obsługuje zdarzenia automatyczne.

(Odziedziczone po TemplateControl)
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)
Trace

TraceContext Pobiera obiekt dla bieżącego żądania sieci Web.

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

Metody

AddContentTemplate(String, ITemplate)

Dodaje kontrolkę Content do słownika ContentTemplates .

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)
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)
Construct()

Wykonuje logikę czasu projektowania.

(Odziedziczone po TemplateControl)
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)
CreateResourceBasedLiteralControl(Int32, Int32, Boolean)

Uzyskuje dostęp do ciągów literałów przechowywanych w zasobie. Metoda nie jest przeznaczona CreateResourceBasedLiteralControl(Int32, Int32, Boolean) do użycia z poziomu kodu.

(Odziedziczone po TemplateControl)
DataBind()

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

(Odziedziczone po Control)
DataBindChildren()

Wiąże źródło danych z kontrolkami podrzędnymi kontrolki serwera.

(Odziedziczone po Control)
DesignerInitialize()

Wykonuje wszelkie kroki inicjowania w kontrolce użytkownika, które są wymagane przez projektantów RAD.

(Odziedziczone po UserControl)
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)
Eval(String)

Oblicza wyrażenie powiązania danych.

(Odziedziczone po TemplateControl)
Eval(String, String)

Oblicza wyrażenie powiązania danych przy użyciu określonego ciągu formatu w celu wyświetlenia wyniku.

(Odziedziczone po TemplateControl)
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)
FrameworkInitialize()

Inicjuje kontrolkę, która pochodzi z TemplateControl klasy.

(Odziedziczone po TemplateControl)
GetDesignModeState()

Pobiera dane czasu projektowania dla kontrolki.

(Odziedziczone po Control)
GetGlobalResourceObject(String, String)

Pobiera obiekt zasobu na poziomie aplikacji na podstawie określonych ClassKey właściwości i ResourceKey .

(Odziedziczone po TemplateControl)
GetGlobalResourceObject(String, String, Type, String)

Pobiera obiekt zasobu na poziomie aplikacji na podstawie określonych ClassKey właściwości i ResourceKey , typu obiektu i nazwy właściwości zasobu.

(Odziedziczone po TemplateControl)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetLocalResourceObject(String)

Pobiera obiekt zasobu na poziomie strony na podstawie określonej ResourceKey właściwości.

(Odziedziczone po TemplateControl)
GetLocalResourceObject(String, Type, String)

Pobiera obiekt zasobu na poziomie strony na podstawie określonej ResourceKey właściwości, typu obiektu i nazwy właściwości.

(Odziedziczone po TemplateControl)
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)
InitializeAsUserControl(Page)

Inicjuje UserControl obiekt, który został utworzony deklaratywnie. Ponieważ istnieją pewne różnice między stronami i kontrolkami użytkownika, ta metoda zapewnia prawidłowe zainicjowanie kontrolki użytkownika.

(Odziedziczone po UserControl)
InstantiateInContentPlaceHolder(Control, ITemplate)

Udostępnia metodę ustawiania bieżącej kontrolki szablonu na stronę, która jest właścicielem strony wzorcowej.

IsLiteralContent()

Określa, czy kontrolka serwera przechowuje tylko zawartość literału.

(Odziedziczone po Control)
LoadControl(String)

Control Ładuje obiekt z pliku na podstawie określonej ścieżki wirtualnej.

(Odziedziczone po TemplateControl)
LoadControl(Type, Object[])

Control Ładuje obiekt na podstawie określonego typu i parametrów konstruktora.

(Odziedziczone po TemplateControl)
LoadControlState(Object)

Przywraca informacje o stanie kontroli z poprzedniego żądania strony, które zostało zapisane przez metodę SaveControlState() .

(Odziedziczone po Control)
LoadTemplate(String)

Uzyskuje wystąpienie interfejsu ITemplate z pliku zewnętrznego.

(Odziedziczone po TemplateControl)
LoadViewState(Object)

Przywraca informacje o stanie widoku z poprzedniego żądania kontroli użytkownika, które zostało zapisane przez metodę SaveViewState() .

(Odziedziczone po UserControl)
MapPath(String)

Przypisuje ścieżkę pliku wirtualnego , bezwzględną lub względną do ścieżki pliku fizycznego.

(Odziedziczone po UserControl)
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)
OnAbortTransaction(EventArgs)

AbortTransaction Zgłasza zdarzenie.

(Odziedziczone po TemplateControl)
OnBubbleEvent(Object, EventArgs)

Określa, czy zdarzenie kontroli serwera jest przekazywane w hierarchii kontroli serwera interfejsu użytkownika strony.

(Odziedziczone po Control)
OnCommitTransaction(EventArgs)

CommitTransaction Zgłasza zdarzenie.

(Odziedziczone po TemplateControl)
OnDataBinding(EventArgs)

DataBinding Zgłasza zdarzenie.

(Odziedziczone po Control)
OnError(EventArgs)

Error Zgłasza zdarzenie.

(Odziedziczone po TemplateControl)
OnInit(EventArgs)

Init Zgłasza zdarzenie.

(Odziedziczone po UserControl)
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)
ParseControl(String)

Analizuje ciąg wejściowy do Control obiektu na stronie formularzy sieci Web lub w kontrolce użytkownika.

(Odziedziczone po TemplateControl)
ParseControl(String, Boolean)

Analizuje ciąg wejściowy do Control obiektu na stronie internetowej ASP.NET lub kontrolce użytkownika.

(Odziedziczone po TemplateControl)
RaiseBubbleEvent(Object, EventArgs)

Przypisuje wszystkie źródła zdarzenia i jego informacje do elementu nadrzędnego kontrolki.

(Odziedziczone po Control)
ReadStringResource()

Odczytuje zasób ciągu. Metoda nie jest przeznaczona ReadStringResource() do użycia z poziomu kodu.

(Odziedziczone po TemplateControl)
RemovedControl(Control)

Wywoływane po usunięciu kontrolki podrzędnej z Controls kolekcji Control obiektu.

(Odziedziczone po Control)
Render(HtmlTextWriter)

Wysyła zawartość kontroli serwera do dostarczonego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie.

(Odziedziczone po Control)
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)
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)
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 wszelkie zmiany stanu widoku kontroli użytkownika, które wystąpiły od czasu ostatniego powrotu strony.

(Odziedziczone po UserControl)
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)
SetStringResourcePointer(Object, Int32)

Ustawia wskaźnik na zasób ciągu. Metoda SetStringResourcePointer(Object, Int32) jest używana przez wygenerowane klasy i nie jest przeznaczona do użycia z poziomu kodu.

(Odziedziczone po TemplateControl)
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)
TestDeviceFilter(String)

Zwraca wartość logiczną wskazującą, czy filtr urządzenia ma zastosowanie do żądania HTTP.

(Odziedziczone po TemplateControl)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)
TrackViewState()

Powoduje śledzenie zmian stanu widoku w kontrolce serwera, dzięki czemu mogą być przechowywane w obiekcie kontroli StateBag serwera. Ten obiekt jest dostępny za pośrednictwem ViewState właściwości .

(Odziedziczone po Control)
TryUpdateModel<TModel>(TModel)

Próbuje zaktualizować wystąpienie modelu przy użyciu wartości kontrolki powiązanej z danymi.

(Odziedziczone po UserControl)
TryUpdateModel<TModel>(TModel, IValueProvider)

Próbuje zaktualizować wystąpienie modelu przy użyciu wartości od dostawcy wartości.

(Odziedziczone po UserControl)
UpdateModel<TModel>(TModel)

Aktualizuje wystąpienie modelu przy użyciu wartości z kontrolki powiązanej z danymi.

(Odziedziczone po UserControl)
UpdateModel<TModel>(TModel, IValueProvider)

Aktualizuje określone wystąpienie modelu przy użyciu wartości od dostawcy wartości kontrolki użytkownika.

(Odziedziczone po UserControl)
WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean)

Zapisuje ciąg zasobu w kontrolce HtmlTextWriter . Metoda WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean) jest używana przez wygenerowane klasy i nie jest przeznaczona do użycia z poziomu kodu.

(Odziedziczone po TemplateControl)
XPath(String)

Oblicza wyrażenie powiązania danych XPath.

(Odziedziczone po TemplateControl)
XPath(String, IXmlNamespaceResolver)

Ocenia wyrażenie powiązania danych XPath przy użyciu określonego prefiksu i mapowań przestrzeni nazw na potrzeby rozpoznawania przestrzeni nazw.

(Odziedziczone po TemplateControl)
XPath(String, String)

Oblicza wyrażenie powiązania danych XPath przy użyciu określonego ciągu formatu w celu wyświetlenia wyniku.

(Odziedziczone po TemplateControl)
XPath(String, String, IXmlNamespaceResolver)

Oblicza wyrażenie powiązania danych XPath przy użyciu określonego prefiksu i mapowań przestrzeni nazw dla rozpoznawania przestrzeni nazw i określonego ciągu formatu w celu wyświetlenia wyniku.

(Odziedziczone po TemplateControl)
XPathSelect(String)

Oblicza wyrażenie powiązania danych XPath i zwraca kolekcję węzłów, która implementuje IEnumerable interfejs.

(Odziedziczone po TemplateControl)
XPathSelect(String, IXmlNamespaceResolver)

Oblicza wyrażenie powiązania danych XPath przy użyciu określonego prefiksu i mapowań przestrzeni nazw dla rozpoznawania przestrzeni nazw i zwraca kolekcję węzłów, która implementuje IEnumerable interfejs.

(Odziedziczone po TemplateControl)

Zdarzenia

AbortTransaction

Występuje, gdy użytkownik kończy transakcję.

(Odziedziczone po TemplateControl)
CommitTransaction

Występuje po zakończeniu transakcji.

(Odziedziczone po TemplateControl)
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)
Error

Występuje, gdy zgłaszany jest nieobsługiwany wyjątek.

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

Zwraca wartość określonego atrybutu kontrolki użytkownika.

(Odziedziczone po UserControl)
IAttributeAccessor.SetAttribute(String, String)

Ustawia wartość określonego atrybutu kontrolki użytkownika.

(Odziedziczone po UserControl)
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)
IFilterResolutionService.CompareFilters(String, String)

Zwraca wartość wskazującą, czy relacja nadrzędna/podrzędna istnieje między dwoma określonymi filtrami urządzeń.

(Odziedziczone po TemplateControl)
IFilterResolutionService.EvaluateFilter(String)

Zwraca wartość wskazującą, czy określony filtr jest typem bieżącego obiektu filtru.

(Odziedziczone po TemplateControl)
IParserAccessor.AddParsedSubObject(Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz AddParsedSubObject(Object).

(Odziedziczone po Control)
IUserControlDesignerAccessor.InnerText

Pobiera lub ustawia tekst wyświetlany między tagami otwierania i zamykania kontrolki użytkownika.

(Odziedziczone po UserControl)
IUserControlDesignerAccessor.TagName

Pobiera lub ustawia pełną nazwę tagu kontrolki użytkownika.

(Odziedziczone po UserControl)

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ż