Sdílet prostřednictvím


SiteMapPath Třída

Definice

Zobrazí sadu textových nebo obrázkových hypertextových odkazů, které uživatelům umožňují snadnější navigaci na webu a zároveň zabírají minimální místo na stránce.

public ref class SiteMapPath : System::Web::UI::WebControls::CompositeControl
public class SiteMapPath : System.Web.UI.WebControls.CompositeControl
type SiteMapPath = class
    inherit CompositeControl
Public Class SiteMapPath
Inherits CompositeControl
Dědičnost

Příklady

Následující příklad kódu používá SiteMapPath ovládací prvek deklarativně na stránce webové formuláře. Tento příklad ukazuje některá pravidla priority, která řídí pořadí, se kterým jsou šablony a styly použity na SiteMapPath uzly.

<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">

            <!-- The following example demonstrates some of the orders
                 of precedence when applying styles and templates to
                 functional nodes of a SiteMapPath.

                 The NodeStyle and RootNodeStyle define the same attributes,
                 but are different and conflict with each other: the
                 RootNodeStyle supersedes NodeStyle, and is the style
                 rendered. Notice, however, that the underline style
                 defined by NodeStyle is still applied.

                 Both a CurrentNodeStyle and a CurrentNodeTemplate are
                 defined. A template supersedes a style for a node
                 type, so CurrentNodeTemplate is displayed and CurrentNodeStyle
                 is ignored. -->

            <asp:SiteMapPath ID="SiteMapPath1" runat="server"
                RenderCurrentNodeAsLink="true"
                NodeStyle-Font-Names="Franklin Gothic Medium"
                NodeStyle-Font-Underline="true"
                NodeStyle-Font-Bold="true"
                RootNodeStyle-Font-Names="Symbol"
                RootNodeStyle-Font-Bold="false"
                CurrentNodeStyle-Font-Names="Verdana"
                CurrentNodeStyle-Font-Size="10pt"
                CurrentNodeStyle-Font-Bold="true"
                CurrentNodeStyle-ForeColor="red"
                CurrentNodeStyle-Font-Underline="false">
                <CURRENTNODETEMPLATE>
                        <asp:Image id="Image1" runat="server" ImageUrl="WebForm2.jpg" AlternateText="WebForm2"/>
                </CURRENTNODETEMPLATE>
            </asp:SiteMapPath>


        </form>
    </body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">

            <!-- The following example demonstrates some of the orders
                 of precedence when applying styles and templates to
                 functional nodes of a SiteMapPath.

                 The NodeStyle and RootNodeStyle define the same attributes,
                 but are different and conflict with each other: the
                 RootNodeStyle supersedes NodeStyle, and is the style
                 rendered. Notice, however, that the underline style
                 defined by NodeStyle is still applied.

                 Both a CurrentNodeStyle and a CurrentNodeTemplate are
                 defined. A template supersedes a style for a node
                 type, so CurrentNodeTemplate is displayed and CurrentNodeStyle
                 is ignored. -->

            <asp:SiteMapPath ID="SiteMapPath1" runat="server"
                RenderCurrentNodeAsLink="true"
                NodeStyle-Font-Names="Franklin Gothic Medium"
                NodeStyle-Font-Underline="true"
                NodeStyle-Font-Bold="true"
                RootNodeStyle-Font-Names="Symbol"
                RootNodeStyle-Font-Bold="false"
                CurrentNodeStyle-Font-Names="Verdana"
                CurrentNodeStyle-Font-Size="10pt"
                CurrentNodeStyle-Font-Bold="true"
                CurrentNodeStyle-ForeColor="red"
                CurrentNodeStyle-Font-Underline="false">
                <CURRENTNODETEMPLATE>
                        <asp:Image id="Image1" runat="server" ImageUrl="WebForm2.jpg" AlternateText="WebForm2"/>
                </CURRENTNODETEMPLATE>
            </asp:SiteMapPath>


        </form>
    </body>
</html>

Předchozí příklad používá výchozího zprostředkovatele mapy webu a soubor Web.sitemap s následující strukturou.

<siteMap>
  <siteMapNode title="WebForm1" description="WebForm1" url="WebForm1.aspx" >
    <siteMapNode title="WebForm2" description="WebForm2" url="WebForm2.aspx"/>
  </siteMapNode>
</siteMap>

Následující příklad kódu ukazuje rozšíření SiteMapPath ovládacího prvku a přidá do něj nové funkce přepsáním InitializeItem metody . Ovládací DropDownSiteMapPath prvek přidá DropDownList za aktuální uzel , aby bylo možné snadno přejít na stránky, které jsou podřízenými uzly aktuální stránky. Tento příklad ukazuje, jak pracovat s SiteMapNodeItem objekty, včetně kontroly jejich SiteMapNodeItemType a volání OnItemCreated metody po vytvoření položek.

using System;
using System.Collections;
using System.ComponentModel;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

// The DropDownNavigationPath is a class that extends the SiteMapPath
// control and renders a DropDownList after the CurrentNode. The
// DropDownList displays a list of pages found further down the site map
// hierarchy from the current one. Selecting an item in the DropDownList
// redirects to that page.
//
// For simplicity, the DropDownNavigationPath assumes the
// RootToCurrent PathDirection, and does not apply styles
// or templates the current node.
//
[AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
public class DropDownNavigationPath : SiteMapPath {
    // Override the InitializeItem method to add a PathSeparator
    // and DropDownList to the current node.
    protected override void InitializeItem(SiteMapNodeItem item) {

        // The only node that must be handled is the CurrentNode.
        if (item.ItemType == SiteMapNodeItemType.Current)
        {
            HyperLink hLink = new HyperLink();

            // No Theming for the HyperLink.
            hLink.EnableTheming = false;
            // Enable the link of the SiteMapPath is enabled.
            hLink.Enabled = this.Enabled;

            // Set the properties of the HyperLink to
            // match those of the corresponding SiteMapNode.
            hLink.NavigateUrl = item.SiteMapNode.Url;
            hLink.Text        = item.SiteMapNode.Title;
            if (ShowToolTips) {
                hLink.ToolTip = item.SiteMapNode.Description;
            }

            // Apply styles or templates to the HyperLink here.
            // ...
            // ...

            // Add the item to the Controls collection.
            item.Controls.Add(hLink);

            AddDropDownListAfterCurrentNode(item);
        }
        else {
            base.InitializeItem(item);
        }
    }
    private void AddDropDownListAfterCurrentNode(SiteMapNodeItem item) {

        SiteMapNodeCollection childNodes = item.SiteMapNode.ChildNodes;

        // Only do this work if there are child nodes.
        if (childNodes != null) {

            // Add another PathSeparator after the CurrentNode.
            SiteMapNodeItem finalSeparator =
                new SiteMapNodeItem(item.ItemIndex,
                                    SiteMapNodeItemType.PathSeparator);

            SiteMapNodeItemEventArgs eventArgs =
                new SiteMapNodeItemEventArgs(finalSeparator);

            InitializeItem(finalSeparator);
            // Call OnItemCreated every time a SiteMapNodeItem is
            // created and initialized.
            OnItemCreated(eventArgs);

            // The pathSeparator does not bind to any SiteMapNode, so
            // do not call DataBind on the SiteMapNodeItem.
            item.Controls.Add(finalSeparator);

            // Create a DropDownList and populate it with the children of the
            // CurrentNode. There are no styles or templates that are applied
            // to the DropDownList control. If OnSelectedIndexChanged is raised,
            // the event handler redirects to the page selected.
            // The CurrentNode has child nodes.
            DropDownList ddList = new DropDownList();
            ddList.AutoPostBack = true;

            ddList.SelectedIndexChanged += new EventHandler(this.DropDownNavPathEventHandler);

            // Add a ListItem to the DropDownList for every node in the
            // SiteMapNodes collection.
            foreach (SiteMapNode node in childNodes) {
                ddList.Items.Add(new ListItem(node.Title, node.Url));
            }

            item.Controls.Add(ddList);
        }
    }

    // The sender is the DropDownList.
    private void DropDownNavPathEventHandler(object sender,EventArgs e) {
        DropDownList ddL = sender as DropDownList;

        // Redirect to the page the user chose.
        if (Context != null)
            Context.Response.Redirect(ddL.SelectedValue);
    }
}
Imports System.Collections
Imports System.ComponentModel
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace Samples.AspNet

' The DropDownNavigationPath is a class that extends the SiteMapPath
' control and renders a DropDownList after the CurrentNode. The
' DropDownList displays a list of pages found further down the site map
' hierarchy from the current one. Selecting an item in the DropDownList
' redirects to that page.
'
' For simplicity, the DropDownNavigationPath assumes the
' RootToCurrent PathDirection, and does not apply styles
' or templates the current node.
'
<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
Public Class DropDownNavigationPath
   Inherits SiteMapPath

   ' Override the InitializeItem method to add a PathSeparator
   ' and DropDownList to the current node.
   Protected Overrides Sub InitializeItem(item As SiteMapNodeItem)

      ' The only node that must be handled is the CurrentNode.
      If item.ItemType = SiteMapNodeItemType.Current Then
         Dim hLink As New HyperLink()

         ' No Theming for the HyperLink.
         hLink.EnableTheming = False
         ' Enable the link of the SiteMapPath is enabled.
         hLink.Enabled = Me.Enabled

         ' Set the properties of the HyperLink to
         ' match those of the corresponding SiteMapNode.
         hLink.NavigateUrl = item.SiteMapNode.Url
         hLink.Text = item.SiteMapNode.Title
         If ShowToolTips Then
            hLink.ToolTip = item.SiteMapNode.Description
         End If

         ' Apply styles or templates to the HyperLink here.
         ' ...
         ' ...
         ' Add the item to the Controls collection.
         item.Controls.Add(hLink)

         AddDropDownListAfterCurrentNode(item)
      Else
         MyBase.InitializeItem(item)
      End If
   End Sub

   Private Sub AddDropDownListAfterCurrentNode(item As SiteMapNodeItem)

      Dim childNodes As SiteMapNodeCollection = item.SiteMapNode.ChildNodes

      ' Only do this work if there are child nodes.
      If Not (childNodes Is Nothing) Then

         ' Add another PathSeparator after the CurrentNode.
         Dim finalSeparator As New SiteMapNodeItem(item.ItemIndex, SiteMapNodeItemType.PathSeparator)

         Dim eventArgs As New SiteMapNodeItemEventArgs(finalSeparator)

         InitializeItem(finalSeparator)
         ' Call OnItemCreated every time a SiteMapNodeItem is
         ' created and initialized.
         OnItemCreated(eventArgs)

         ' The pathSeparator does not bind to any SiteMapNode, so
         ' do not call DataBind on the SiteMapNodeItem.
         item.Controls.Add(finalSeparator)

         ' Create a DropDownList and populate it with the children of the
         ' CurrentNode. There are no styles or templates that are applied
         ' to the DropDownList control. If OnSelectedIndexChanged is raised,
         ' the event handler redirects to the page selected.
         ' The CurrentNode has child nodes.
         Dim ddList As New DropDownList()
         ddList.AutoPostBack = True

         AddHandler ddList.SelectedIndexChanged, AddressOf Me.DropDownNavPathEventHandler

         ' Add a ListItem to the DropDownList for every node in the
         ' SiteMapNodes collection.
         Dim node As SiteMapNode
         For Each node In  childNodes
            ddList.Items.Add(New ListItem(node.Title, node.Url))
         Next node

         item.Controls.Add(ddList)
      End If
   End Sub

   ' The sender is the DropDownList.
   Private Sub DropDownNavPathEventHandler(sender As Object, e As EventArgs)
      Dim ddL As DropDownList = CType(sender, DropDownList)

      ' Redirect to the page the user chose.
      If Not (Context Is Nothing) Then
         Context.Response.Redirect(ddL.SelectedValue)
      End If

   End Sub
End Class
End Namespace

Poznámky

V tomto tématu:

Úvod

Ovládací SiteMapPath prvek je ovládací prvek navigace webu, který odráží data poskytnutá objektem SiteMap . Poskytuje prostorově úsporný způsob snadné navigace na webu a slouží jako referenční bod pro umístění aktuálně zobrazené stránky v rámci webu. Tento typ ovládacího prvku se běžně označuje jako popis cesty nebo obočí, protože zobrazuje hierarchickou cestu s názvy stránek s hypertextovými odkazy, která poskytuje řídicí prvek v hierarchii stránek z aktuálního umístění. SiteMapDataSource. Je SiteMapPath užitečná pro weby, které mají hluboké hierarchické struktury stránek, ale kde TreeViewMenu nebo může vyžadovat příliš mnoho místa na stránce.

Ovládací SiteMapPath prvek pracuje přímo s daty mapy webu webu. Pokud ho použijete na stránce, která není znázorněna v mapě webu, nezobrazí se. Další informace o mapách webů najdete v tématu ASP.NET Navigace na webu.

Uzly

Je SiteMapPath tvořen uzly. Každý prvek v cestě se nazývá uzel a je reprezentován objektem SiteMapNodeItem . Uzel, který ukotvuje cestu a představuje základ hierarchického stromu, se nazývá kořenový uzel. Uzel, který představuje aktuálně zobrazenou stránku, je aktuálním uzlem. Jakýkoli jiný uzel mezi aktuálním a kořenovým uzlem je nadřazeným uzlem. Následující tabulka popisuje tři různé typy uzlů.

Typ uzlu Description
kořen Uzel, který ukotvuje hierarchickou sadu uzlů.
Nadřazené Uzel, který má jeden nebo více podřízených uzlů, ale není aktuálním uzlem.
aktuální Uzel, který představuje aktuálně zobrazenou stránku.

Vzhled uzlu

Každý uzel zobrazený pomocí SiteMapPath je ovládací prvek HyperLink nebo Literal , na který můžete použít šablonu nebo styl. Šablony a styly se na uzly použijí podle dvou pravidel priority:

  • Pokud je šablona definovaná pro uzel, přepíše jakýkoli styl definovaný pro uzel.

  • Šablony a styly specifické pro typy uzlů přepisují obecné šablony a styly definované pro všechny uzly.

Vlastnosti NodeStyle a NodeTemplate se použijí na všechny uzly bez ohledu na jejich typ uzlu. Pokud jsou definovány obě tyto vlastnosti, NodeTemplate bude mít přednost .

Vlastnosti CurrentNodeTemplate a CurrentNodeStyle se použijí na uzly, které představují aktuálně zobrazenou stránku. Pokud je kromě CurrentNodeTemplateobjektu NodeTemplate definována hodnota , bude ignorována. Pokud je kromě CurrentNodeStyleobjektu NodeStyle definována hodnota , je sloučena s objektem CurrentNodeStyle , aby se vytvořil sloučený styl. Tento sloučený styl používá všechny prvky objektu CurrentNodeStylea všechny další prvky objektu NodeStyle , které nejsou v konfliktu s objektem CurrentNodeStyle.

Vlastnosti RootNodeTemplate a RootNodeStyle se použijí na uzel, který představuje kořen hierarchie navigace webu. Pokud je kromě RootNodeTemplateobjektu NodeTemplate definována hodnota , bude ignorována. Pokud je kromě RootNodeStyleobjektu NodeStyle definována hodnota , je sloučena s objektem RootNodeStyle , aby se vytvořil sloučený styl. Tento sloučený styl používá všechny prvky objektu RootNodeStylea všechny další prvky objektu NodeStyle , které nebyly v konfliktu s objektem CurrentNodeStyle. Pokud je aktuálně zobrazená stránka kořenovou stránkou webu, RootNodeTemplate použijí se a RootNodeStyle místo CurrentNodeTemplateCurrentNodeStylenebo .

Ovládací SiteMapPath prvek používá zprostředkovatele mapy webu identifikované vlastností SiteMapProvider jako zdroj dat pro informace o navigaci na webu. Pokud není zadán žádný zprostředkovatel, použije výchozího zprostředkovatele pro lokalitu, který je identifikovaný SiteMap.Provider ve vlastnosti . Obvykle se jedná o instanci výchozího zprostředkovatele mapy webu pro ASP.NET .XmlSiteMapProvider Pokud je SiteMapPath ovládací prvek použit v rámci lokality, ale není nakonfigurován žádný zprostředkovatel mapy webu, vyvolá HttpException ovládací prvek výjimku.

Událost

Ovládací SiteMapPath prvek také poskytuje události, se kterými můžete programovat. To vám umožní spustit vlastní rutinu při každém výskytu události. Následující tabulka uvádí události, které SiteMapPath ovládací prvek podporuje.

Událost Description
ItemCreated Vyvolá se, SiteMapPath když ovládací prvek poprvé vytvoří a přidruží SiteMapNodeItem ho k SiteMapNode.
ItemDataBound Vyvolá se v případě, že SiteMapNodeItem je vázán na data mapy webu obsažená v objektu SiteMapNode.

Přizpůsobení ovládacího prvku SiteMapPath

Třídy, které jsou odvozeny od SiteMapPath přepsání InitializeItem metody přizpůsobení SiteMapNodeItem ovládacích prvků obsažených navigační ovládací prvek. Pro úplnou kontrolu nad způsobem, jakým SiteMapNodeItem jsou objekty vytvořeny a přidány do SiteMapPath, odvozené třídy přepisují metodu CreateControlHierarchy .

Usnadnění

Informace o konfiguraci tohoto ovládacího prvku tak, aby vygeneroval značky, které odpovídají standardům přístupnosti, najdete v tématech Usnadnění v sadě Visual Studio a ASP.NET a ASP.NET Ovládací prvky a přístupnost.

Deklarativní syntaxe

<asp:SiteMapPath
    AccessKey="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CssClass="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnItemCreated="ItemCreated event handler"
    OnItemDataBound="ItemDataBound event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    ParentLevelsDisplayed="integer"
    PathDirection="RootToCurrent|CurrentToRoot"
    PathSeparator="string"
    RenderCurrentNodeAsLink="True|False"
    runat="server"
    ShowToolTips="True|False"
    SiteMapProvider="string"
    SkinID="string"
    SkipLinkText="string"
    Style="string"
    TabIndex="integer"
    ToolTip="string"
    Visible="True|False"
    Width="size"
>
        <CurrentNodeStyle />
        <CurrentNodeTemplate>
            <!-- child controls -->
        </CurrentNodeTemplate>
        <NodeStyle />
        <NodeTemplate>
            <!-- child controls -->
        </NodeTemplate>
        <PathSeparatorStyle />
        <PathSeparatorTemplate>
            <!-- child controls -->
        </PathSeparatorTemplate>
        <RootNodeStyle />
        <RootNodeTemplate>
            <!-- child controls -->
        </RootNodeTemplate>
</asp:SiteMapPath>

Konstruktory

SiteMapPath()

Inicializuje novou instanci SiteMapPath třídy .

Vlastnosti

AccessKey

Získá nebo nastaví přístupový klíč, který umožňuje rychle přejít na ovládací prvek webového serveru.

(Zděděno od WebControl)
Adapter

Získá adaptér specifické pro prohlížeč pro ovládací prvek.

(Zděděno od Control)
AppRelativeTemplateSourceDirectory

Získá nebo nastaví aplikaci relativní virtuální adresář nebo UserControl objektuPage, který obsahuje tento ovládací prvek.

(Zděděno od Control)
Attributes

Získá kolekci libovolných atributů (pouze pro vykreslování), které neodpovídají vlastnostem ovládacího prvku.

(Zděděno od WebControl)
BackColor

Získá nebo nastaví barvu pozadí ovládacího prvku webového serveru.

(Zděděno od WebControl)
BindingContainer

Získá ovládací prvek, který obsahuje datové vazby tohoto ovládacího prvku.

(Zděděno od Control)
BorderColor

Získá nebo nastaví barvu ohraničení webového ovládacího prvku.

(Zděděno od WebControl)
BorderStyle

Získá nebo nastaví styl ohraničení ovládacího prvku webového serveru.

(Zděděno od WebControl)
BorderWidth

Získá nebo nastaví šířku ohraničení ovládacího prvku webového serveru.

(Zděděno od WebControl)
ChildControlsCreated

Získá hodnotu, která označuje, zda byly vytvořeny podřízené ovládací prvky serverového ovládacího prvku.

(Zděděno od Control)
ClientID

Získá ID ovládacího prvku pro kód HTML, který je generován ASP.NET.

(Zděděno od Control)
ClientIDMode

Získá nebo nastaví algoritmus, který se používá k vygenerování hodnoty ClientID vlastnosti.

(Zděděno od Control)
ClientIDSeparator

Získá hodnotu znaku představující znak oddělovače použitý ve ClientID vlastnosti .

(Zděděno od Control)
Context

HttpContext Získá objekt přidružený k ovládacímu prvku serveru pro aktuální webový požadavek.

(Zděděno od Control)
Controls

ControlCollection Získá objekt, který představuje podřízené ovládací prvky v objektu CompositeControl.

(Zděděno od CompositeControl)
ControlStyle

Získá styl ovládacího prvku webového serveru. Tuto vlastnost používají primárně vývojáři ovládacích prvků.

(Zděděno od WebControl)
ControlStyleCreated

Získá hodnotu označující, zda Style objekt byl vytvořen pro ControlStyle vlastnost. Tuto vlastnost primárně používají vývojáři ovládacích prvků.

(Zděděno od WebControl)
CssClass

Získá nebo nastaví kaskádové šablony stylů (CSS) třídy vykreslené ovládacím prvkem webového serveru v klientovi.

(Zděděno od WebControl)
CurrentNodeStyle

Získá styl použitý pro zobrazovaný text pro aktuální uzel.

CurrentNodeTemplate

Získá nebo nastaví šablonu ovládacího prvku pro použití pro uzel navigační cesty webu, která představuje aktuálně zobrazenou stránku.

DataItemContainer

Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataItemContainer.

(Zděděno od Control)
DataKeysContainer

Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataKeysControl.

(Zděděno od Control)
DesignMode

Získá hodnotu označující, zda je ovládací prvek použit na návrhové ploše.

(Zděděno od Control)
Enabled

Získá nebo nastaví hodnotu označující, zda je povolen ovládací prvek webového serveru.

(Zděděno od WebControl)
EnableTheming

Získá nebo nastaví hodnotu označující, zda motivy použít pro tento ovládací prvek.

(Zděděno od WebControl)
EnableViewState

Získá nebo nastaví hodnotu označující, zda serverový ovládací prvek zachová svůj stav zobrazení a stav zobrazení všech podřízených ovládacích prvků, které obsahuje, do žádajícího klienta.

(Zděděno od Control)
Events

Získá seznam delegátů obslužné rutiny události pro ovládací prvek. Tato vlastnost je jen ke čtení.

(Zděděno od Control)
Font

Získá vlastnosti písma přidružené k ovládacímu prvku webového serveru.

(Zděděno od WebControl)
ForeColor

Získá nebo nastaví barvu popředí (obvykle barvu textu) ovládacího prvku webového serveru.

(Zděděno od WebControl)
HasAttributes

Získá hodnotu označující, zda ovládací prvek má nastaveny atributy.

(Zděděno od WebControl)
HasChildViewState

Získá hodnotu označující, zda podřízené ovládací prvky aktuálního serveru mají nějaké uložené nastavení stavu zobrazení.

(Zděděno od Control)
Height

Získá nebo nastaví výšku ovládacího prvku webového serveru.

(Zděděno od WebControl)
ID

Získá nebo nastaví programový identifikátor přiřazený k ovládacímu prvku serveru.

(Zděděno od Control)
IdSeparator

Získá znak použitý k oddělení identifikátorů ovládacích prvků.

(Zděděno od Control)
IsChildControlStateCleared

Získá hodnotu označující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav řízení.

(Zděděno od Control)
IsEnabled

Získá hodnotu označující, zda je povolen ovládací prvek.

(Zděděno od WebControl)
IsTrackingViewState

Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do stavu zobrazení.

(Zděděno od Control)
IsViewStateEnabled

Získá hodnotu označující, zda je stav zobrazení povolen pro tento ovládací prvek.

(Zděděno od Control)
LoadViewStateByID

Získá hodnotu označující, zda se ovládací prvek účastní načítání stavu zobrazení namísto ID indexu.

(Zděděno od Control)
NamingContainer

Získá odkaz na názvový kontejner serverového ovládacího prvku, který vytvoří jedinečný obor názvů pro odlizení mezi ovládacími prvky serveru se stejnou ID hodnotou vlastnosti.

(Zděděno od Control)
NodeStyle

Získá styl použitý pro zobrazovaný text pro všechny uzly v cestě navigace webu.

NodeTemplate

Získá nebo nastaví šablonu ovládacího prvku pro použití pro všechny funkční uzly navigační cesty webu.

Page

Získá odkaz na Page instanci, která obsahuje serverový ovládací prvek.

(Zděděno od Control)
Parent

Získá odkaz na nadřazený ovládací prvek serveru v hierarchii ovládacích prvků stránky.

(Zděděno od Control)
ParentLevelsDisplayed

Získá nebo nastaví počet úrovní nadřazených uzlů ovládacího prvku vzhledem k aktuálně zobrazený uzel.

PathDirection

Získá nebo nastaví pořadí, ve které jsou vykreslovány uzly navigační cesty.

PathSeparator

Získá nebo nastaví řetězec, který odlizuje SiteMapPath uzly v vykreslené navigační cestě.

PathSeparatorStyle

Získá styl použitý pro PathSeparator řetězec.

PathSeparatorTemplate

Získá nebo nastaví šablonu ovládacího prvku pro použití pro oddělovač cesty navigační cesty webu.

Provider

Získá nebo nastaví, SiteMapProvider který je přidružen k ovládacímu prvku webového serveru.

RenderCurrentNodeAsLink

Určuje, zda je uzel navigace webu, který představuje aktuálně zobrazenou stránku, vykreslen jako hypertextový odkaz.

RenderingCompatibility

Získá hodnotu, která určuje ASP.NET verze, která vykreslovala HTML bude kompatibilní s.

(Zděděno od Control)
RootNodeStyle

Získá styl pro zobrazovaný text kořenového uzlu.

RootNodeTemplate

Získá nebo nastaví šablonu ovládacího prvku použít pro kořenový uzel navigační cesty webu.

ShowToolTips

Získá nebo nastaví hodnotu označující, zda SiteMapPath ovládací prvek zapíše další atribut hypertextového odkazu pro hypertextové odkazy navigační uzly. V závislosti na podpoře klienta se při najetí myší na hypertextový odkaz, který má nastavený další atribut, zobrazí popis.

Site

Získá informace o kontejneru, který je hostitelem aktuálního ovládacího prvku při vykreslení na návrhové ploše.

(Zděděno od Control)
SiteMapProvider

Získá nebo nastaví název použité k SiteMapProvider vykreslení ovládacího prvku navigace webu.

SkinID

Získá nebo nastaví vzhled pro použití ovládacího prvku.

(Zděděno od WebControl)
SkipLinkText

Získá nebo nastaví hodnotu, která se používá k vykreslení alternativního textu pro čtečky obrazovky přeskočit obsah ovládacího prvku.

Style

Získá kolekci textových atributů, které budou vykresleny jako atribut stylu na vnější značku webového serveru ovládacího prvku.

(Zděděno od WebControl)
SupportsDisabledAttribute

Získá hodnotu, která označuje, zda má ovládací prvek nastavit disabled atribut vykresleného elementu HTML na "zakázáno", pokud je vlastnost ovládacího prvku IsEnabled je false.

(Zděděno od CompositeControl)
TabIndex

Získá nebo nastaví index tabulátoru ovládacího prvku webového serveru.

(Zděděno od WebControl)
TagKey

HtmlTextWriterTag Získá hodnotu, která odpovídá ovládacího prvku webového serveru. Tuto vlastnost používají primárně vývojáři ovládacích prvků.

(Zděděno od WebControl)
TagName

Získá název značky ovládacího prvku. Tuto vlastnost používají primárně vývojáři ovládacích prvků.

(Zděděno od WebControl)
TemplateControl

Získá nebo nastaví odkaz na šablonu, která obsahuje tento ovládací prvek.

(Zděděno od Control)
TemplateSourceDirectory

Získá virtuální adresář Page nebo UserControl , který obsahuje aktuální serverový ovládací prvek.

(Zděděno od Control)
ToolTip

Získá nebo nastaví text zobrazený, když ukazatel myši najede na ovládací prvek webového serveru.

(Zděděno od WebControl)
UniqueID

Získá jedinečný hierarchicky kvalifikovaný identifikátor serverového ovládacího prvku.

(Zděděno od Control)
ValidateRequestMode

Získá nebo nastaví hodnotu, která označuje, zda ovládací prvek kontroluje vstup klienta z prohlížeče pro potenciálně nebezpečné hodnoty.

(Zděděno od Control)
ViewState

Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení serverového ovládacího prvku napříč více požadavky na stejnou stránku.

(Zděděno od Control)
ViewStateIgnoresCase

Získá hodnotu, která označuje, zda StateBag objekt nerozlišuje malá a velká písmena.

(Zděděno od Control)
ViewStateMode

Získá nebo nastaví režim zobrazení stavu tohoto ovládacího prvku.

(Zděděno od Control)
Visible

Získá nebo nastaví hodnotu, která označuje, zda je serverový ovládací prvek vykreslen jako uživatelské rozhraní na stránce.

(Zděděno od Control)
Width

Získá nebo nastaví šířku ovládacího prvku webového serveru.

(Zděděno od WebControl)

Metody

AddAttributesToRender(HtmlTextWriter)

Přidá atributy a styly HTML, které je potřeba vykreslit do zadaného HtmlTextWriterTag. Tuto metodu používají především vývojáři ovládacích prvků.

(Zděděno od WebControl)
AddedControl(Control, Int32)

Volá se po přidání podřízeného ovládacího prvku do Controls kolekce objektu Control .

(Zděděno od Control)
AddParsedSubObject(Object)

Upozorní ovládací prvek serveru, že byl analyzován element XML nebo HTML, a přidá element do objektu serverového ControlCollection ovládacího prvku.

(Zděděno od Control)
ApplyStyle(Style)

Zkopíruje všechny neprázdné prvky zadaného stylu do webového ovládacího prvku a přepíše všechny existující prvky stylu ovládacího prvku. Tuto metodu primárně používají vývojáři ovládacích prvků.

(Zděděno od WebControl)
ApplyStyleSheetSkin(Page)

Použije na ovládací prvek vlastnosti stylu definované v šabloně stylů stránky.

(Zděděno od Control)
BeginRenderTracing(TextWriter, Object)

Začíná trasování vykreslovaných dat v době návrhu.

(Zděděno od Control)
BuildProfileTree(String, Boolean)

Shromáždí informace o serverovém ovládacím prvku a předá je vlastnosti Trace , která se má zobrazit, když je pro stránku povoleno trasování.

(Zděděno od Control)
ClearCachedClientID()

Nastaví hodnotu v ClientID mezipaměti na null.

(Zděděno od Control)
ClearChildControlState()

Odstraní informace o stavu ovládacího prvku pro podřízené ovládací prvky serveru.

(Zděděno od Control)
ClearChildState()

Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky serveru.

(Zděděno od Control)
ClearChildViewState()

Odstraní informace o stavu zobrazení pro všechny podřízené ovládací prvky serveru.

(Zděděno od Control)
ClearEffectiveClientIDMode()

ClientIDMode Nastaví vlastnost instance aktuálního ovládacího prvku a všech podřízených ovládacích prvků na Inherit.

(Zděděno od Control)
CopyBaseAttributes(WebControl)

Zkopíruje vlastnosti neza zapouzdřené objektem Style ze zadaného ovládacího prvku webového serveru do ovládacího prvku webového serveru, ze kterého je volána tato metoda. Tuto metodu používají především vývojáři ovládacích prvků.

(Zděděno od WebControl)
CreateChildControls()

Vymaže aktuální kolekci podřízených ovládacích prvků a znovu ji vytvoří voláním CreateControlHierarchy() metody .

CreateControlCollection()

Vytvoří nový ControlCollection objekt, který bude obsahovat podřízené ovládací prvky (literál i server) serverového ovládacího prvku.

(Zděděno od Control)
CreateControlHierarchy()

Prozkoumá strukturu mapy webu poskytovanou objektem SiteMapProvider a vytvoří kolekci podřízených ovládacích prvků na základě stylů a šablon definovaných pro funkční uzly.

CreateControlStyle()

Vytvoří objekt stylu, který je interně používán třídou k implementaci všech vlastností souvisejících se stylem WebControl . Tuto metodu používají především vývojáři ovládacích prvků.

(Zděděno od WebControl)
DataBind()

Vytvoří vazbu zdroje dat na SiteMapPath ovládací prvek a jeho podřízené ovládací prvky.

DataBind(Boolean)

Vytvoří vazbu zdroje dat na vyvolaný ovládací prvek serveru a všechny jeho podřízené ovládací prvky s možností vyvolat DataBinding událost.

(Zděděno od Control)
DataBindChildren()

Vytvoří vazbu zdroje dat na podřízené ovládací prvky serveru.

(Zděděno od Control)
Dispose()

Umožňuje ovládacímu prvku serveru provést konečné vyčištění před uvolněním z paměti.

(Zděděno od Control)
EndRenderTracing(TextWriter, Object)

Ukončí trasování doby návrhu vykreslovaných dat.

(Zděděno od Control)
EnsureChildControls()

Určuje, zda serverový ovládací prvek obsahuje podřízené ovládací prvky. Pokud ne, vytvoří podřízené ovládací prvky.

(Zděděno od Control)
EnsureID()

Vytvoří identifikátor pro ovládací prvky, které nemají přiřazený identifikátor.

(Zděděno od Control)
Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
FindControl(String)

Vyhledá v aktuálním názvovém kontejneru serverový ovládací prvek se zadaným id parametrem.

(Zděděno od Control)
FindControl(String, Int32)

Vyhledá v aktuálním kontejneru pojmenování serverový ovládací prvek se zadaným id a celočíselným číslem zadaným v parametru pathOffset , což pomáhá při hledání. Tuto verzi metody byste neměli FindControl přepsat.

(Zděděno od Control)
Focus()

Nastaví fokus vstupu na ovládací prvek.

(Zděděno od Control)
GetDesignModeState()

Získá data v době návrhu pro ovládací prvek.

(Zděděno od Control)
GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetRouteUrl(Object)

Získá adresu URL, která odpovídá sadě parametrů trasy.

(Zděděno od Control)
GetRouteUrl(RouteValueDictionary)

Získá adresu URL, která odpovídá sadě parametrů trasy.

(Zděděno od Control)
GetRouteUrl(String, Object)

Získá adresu URL, která odpovídá sadě parametrů trasy a název trasy.

(Zděděno od Control)
GetRouteUrl(String, RouteValueDictionary)

Získá adresu URL, která odpovídá sadě parametrů trasy a název trasy.

(Zděděno od Control)
GetType()

Type Získá z aktuální instance.

(Zděděno od Object)
GetUniqueIDRelativeTo(Control)

Vrátí část UniqueID vlastnosti zadaného ovládacího prvku s předponou.

(Zděděno od Control)
HasControls()

Určuje, zda serverový ovládací prvek obsahuje nějaké podřízené ovládací prvky.

(Zděděno od Control)
HasEvents()

Vrátí hodnotu označující, zda jsou události registrovány pro ovládací prvek nebo jakékoli podřízené ovládací prvky.

(Zděděno od Control)
InitializeItem(SiteMapNodeItem)

Naplní SiteMapNodeItem, což je ovládací prvek webového serveru, který představuje SiteMapNode, sadou podřízených ovládacích prvků na základě funkce uzlu a zadaných šablon a stylů pro uzel.

IsLiteralContent()

Určuje, zda serverový ovládací prvek obsahuje pouze obsah literálu.

(Zděděno od Control)
LoadControlState(Object)

Obnoví informace o stavu řízení z předchozího požadavku stránky, který byl uložen metodou SaveControlState() .

(Zděděno od Control)
LoadViewState(Object)

Obnoví informace o stavu zobrazení z předchozího požadavku, který byl uložen s metodou SaveViewState() .

MapPathSecure(String)

Načte fyzickou cestu, na kterou se mapuje virtuální cesta, absolutní nebo relativní.

(Zděděno od Control)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
MergeStyle(Style)

Zkopíruje všechny neprázdné prvky zadaného stylu do webového ovládacího prvku, ale nepřepíše žádné existující prvky stylu ovládacího prvku. Tuto metodu používají především vývojáři ovládacích prvků.

(Zděděno od WebControl)
OnBubbleEvent(Object, EventArgs)

Určuje, zda je událost serverového ovládacího prvku předána hierarchii serveru uživatelského rozhraní stránky.

(Zděděno od Control)
OnDataBinding(EventArgs)

Přepíše metodu OnDataBinding(EventArgs)CompositeControl třídy a vyvolá DataBinding událost.

OnInit(EventArgs)

Init Vyvolá událost.

(Zděděno od Control)
OnItemCreated(SiteMapNodeItemEventArgs)

ItemCreated Vyvolá událost SiteMapPath ovládacího prvku.

OnItemDataBound(SiteMapNodeItemEventArgs)

ItemDataBound Vyvolá událost SiteMapPath ovládacího prvku.

OnLoad(EventArgs)

Load Vyvolá událost.

(Zděděno od Control)
OnPreRender(EventArgs)

PreRender Vyvolá událost.

(Zděděno od Control)
OnUnload(EventArgs)

Unload Vyvolá událost.

(Zděděno od Control)
OpenFile(String)

Stream Získá používá ke čtení souboru.

(Zděděno od Control)
RaiseBubbleEvent(Object, EventArgs)

Přiřadí všechny zdroje události a její informace nadřazené ovládacímu prvku.

(Zděděno od Control)
RecreateChildControls()

Znovu vytvoří podřízené ovládací prvky v ovládacím prvku odvozeného z CompositeControl.

(Zděděno od CompositeControl)
RemovedControl(Control)

Volá se po odebrání podřízeného ovládacího prvku z Controls kolekce objektu Control .

(Zděděno od Control)
Render(HtmlTextWriter)

Zapíše CompositeControl obsah do zadaného HtmlTextWriter objektu pro zobrazení na klientovi.

RenderBeginTag(HtmlTextWriter)

Vykreslí levou značku HTML ovládacího prvku určenému zapisovači. Tuto metodu používají především vývojáři ovládacích prvků.

(Zděděno od WebControl)
RenderChildren(HtmlTextWriter)

Vypíše obsah podřízených položek serverového ovládacího prvku do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit na klientovi.

(Zděděno od Control)
RenderContents(HtmlTextWriter)

Vykreslí uzly v ovládacím SiteMapPath prvku.

RenderControl(HtmlTextWriter)

Vypíše obsah ovládacího prvku serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je trasování povoleno.

(Zděděno od Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Vypíše obsah řízení serveru do zadaného HtmlTextWriter objektu pomocí zadaného ControlAdapter objektu.

(Zděděno od Control)
RenderEndTag(HtmlTextWriter)

Vykreslí koncovou značku HTML ovládacího prvku do zadaného zapisovače. Tuto metodu používají především vývojáři ovládacích prvků.

(Zděděno od WebControl)
ResolveAdapter()

Získá adaptér ovládacího prvku zodpovědný za vykreslení zadaného ovládacího prvku.

(Zděděno od Control)
ResolveClientUrl(String)

Získá adresu URL, kterou lze použít v prohlížeči.

(Zděděno od Control)
ResolveUrl(String)

Převede adresu URL na adresu URL, která je použitelná v žádajícím klientovi.

(Zděděno od Control)
SaveControlState()

Uloží všechny změny stavu ovládacích prvků serveru, ke kterým došlo od okamžiku, kdy byla stránka odeslána zpět na server.

(Zděděno od Control)
SaveViewState()

Uloží změny stavu zobrazení SiteMapPath ovládacího prvku.

SetDesignModeState(IDictionary)

Nastaví data v době návrhu ovládacího prvku.

(Zděděno od Control)
SetRenderMethodDelegate(RenderMethod)

Přiřadí delegáta obslužné rutiny události pro vykreslení serverového ovládacího prvku a jeho obsahu do nadřazeného ovládacího prvku.

(Zděděno od Control)
SetTraceData(Object, Object)

Nastaví trasovací data pro trasování vykreslovaných dat v době návrhu pomocí datového klíče trasování a hodnoty dat trasování.

(Zděděno od Control)
SetTraceData(Object, Object, Object)

Nastaví trasovací data pro trasování vykreslovaných dat v době návrhu pomocí trasovaného objektu, datového klíče trasování a hodnoty dat trasování.

(Zděděno od Control)
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)
TrackViewState()

Sleduje změny SiteMapPath stavu zobrazení ovládacího prvku.

Událost

DataBinding

Vyvolá se při vytvoření vazby serverového ovládacího prvku na zdroj dat.

(Zděděno od Control)
Disposed

Vyvolá se při uvolnění serverového ovládacího prvku z paměti, což je poslední fáze životního cyklu řízení serveru, když je požadována ASP.NET stránka.

(Zděděno od Control)
Init

Vyvolá se při inicializaci serverového ovládacího prvku, což je první krok v jeho životním cyklu.

(Zděděno od Control)
ItemCreated

Vyvolá se při vytvoření objektu SiteMapNodeItem a je přidružena k příslušnému SiteMapNodeobjektu SiteMapPath . Tato událost je vyvolána metodou OnItemCreated(SiteMapNodeItemEventArgs) .

ItemDataBound

Nastane poté, co SiteMapNodeItem byl svázán se svými podkladovými SiteMapNode daty objektem SiteMapPath. Tato událost je vyvolána metodou OnItemDataBound(SiteMapNodeItemEventArgs) .

Load

Vyvolá se při načtení serverového ovládacího prvku do objektu Page .

(Zděděno od Control)
PreRender

Vyvolá se po načtení objektu Control , ale před vykreslením.

(Zděděno od Control)
Unload

Vyvolá se při uvolnění serverového ovládacího prvku z paměti.

(Zděděno od Control)

Explicitní implementace rozhraní

IAttributeAccessor.GetAttribute(String)

Získá atribut webového ovládacího prvku se zadaným názvem.

(Zděděno od WebControl)
IAttributeAccessor.SetAttribute(String, String)

Nastaví atribut webového ovládacího prvku na zadaný název a hodnotu.

(Zděděno od WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()

Umožňuje návrháři znovu vytvořit kolekci podřízených ovládacích prvků složeného ovládacího prvku v prostředí návrhu.

(Zděděno od CompositeControl)
IControlBuilderAccessor.ControlBuilder

Popis tohoto člena najdete v tématu ControlBuilder.

(Zděděno od Control)
IControlDesignerAccessor.GetDesignModeState()

Popis tohoto člena najdete v tématu GetDesignModeState().

(Zděděno od Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Popis tohoto člena najdete v tématu SetDesignModeState(IDictionary).

(Zděděno od Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Popis tohoto člena najdete v tématu SetOwnerControl(Control).

(Zděděno od Control)
IControlDesignerAccessor.UserData

Popis tohoto člena najdete v tématu UserData.

(Zděděno od Control)
IDataBindingsAccessor.DataBindings

Popis tohoto člena najdete v tématu DataBindings.

(Zděděno od Control)
IDataBindingsAccessor.HasDataBindings

Popis tohoto člena najdete v tématu HasDataBindings.

(Zděděno od Control)
IExpressionsAccessor.Expressions

Popis tohoto člena najdete v tématu Expressions.

(Zděděno od Control)
IExpressionsAccessor.HasExpressions

Popis tohoto člena najdete v tématu HasExpressions.

(Zděděno od Control)
IParserAccessor.AddParsedSubObject(Object)

Popis tohoto člena najdete v tématu AddParsedSubObject(Object).

(Zděděno od Control)

Metody rozšíření

FindDataSourceControl(Control)

Vrátí zdroj dat přidružený k ovládacímu prvku dat pro zadaný ovládací prvek.

FindFieldTemplate(Control, String)

Vrátí šablonu pole pro zadaný sloupec v kontejneru názvů zadaného ovládacího prvku.

FindMetaTable(Control)

Vrátí objekt metatable pro ovládací prvek obsahující data.

GetDefaultValues(INamingContainer)

Získá kolekci výchozích hodnot pro zadaný ovládací prvek dat.

GetMetaTable(INamingContainer)

Získá metadata tabulky pro zadaný ovládací prvek dat.

SetMetaTable(INamingContainer, MetaTable)

Nastaví metadata tabulky pro zadaný ovládací prvek dat.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Nastaví mapování metadat tabulky a výchozí hodnoty pro zadaný ovládací prvek dat.

SetMetaTable(INamingContainer, MetaTable, Object)

Nastaví mapování metadat tabulky a výchozí hodnoty pro zadaný ovládací prvek dat.

TryGetMetaTable(INamingContainer, MetaTable)

Určuje, zda jsou k dispozici metadata tabulky.

EnableDynamicData(INamingContainer, Type)

Umožňuje dynamické chování dat pro zadaný datový ovládací prvek.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Umožňuje dynamické chování dat pro zadaný datový ovládací prvek.

EnableDynamicData(INamingContainer, Type, Object)

Umožňuje dynamické chování dat pro zadaný datový ovládací prvek.

Platí pro

Viz také