SiteMapPath Třída

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Zobrazí sadu textových nebo obrázkových hypertextových odkazů, které uživatelům umožňují snadněji procházet web a současně s minimálním množstvím místa 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: Object

Control

WebControl

CompositeControl
SiteMapPath

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í, podle kterého se šablony a styly použijí 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.mapa webu 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, který umožňuje snadnou navigaci 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:

Introduction
Uzly
Vzhled uzlu
Události
Přizpůsobení ovládacího prvku SiteMapPath
Přístupnost
Deklarativní syntaxe

Introduction

Ovládací SiteMapPath prvek je ovládací prvek navigace webu, který odráží data poskytnutá objektem SiteMap . Poskytuje způsob, jak snadno procházet web a sloužit jako referenční bod pro místo, kde se aktuálně zobrazená stránka nachází na webu. Tento typ ovládacího prvku se běžně označuje jako popis cesty nebo obočí, protože zobrazuje hierarchickou cestu k názvům hypertextových stránek, která poskytuje řídicí znak hierarchie stránek z aktuálního umístění. SiteMapDataSource. To SiteMapPath je užitečné pro weby, které mají hloubkové hierarchické struktury stránek, ale kde může TreeView Menu vyžadovat příliš mnoho místa na stránce.

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

Uzly

Skládá SiteMapPath se z uzlů. Každý prvek v cestě se nazývá uzel a je reprezentován objektem SiteMapNodeItem . Uzel, který cestu ukotvení 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í uzel. Jakýkoli jiný uzel mezi aktuálním uzlem a kořenovým uzlem je nadřazený uzel. Následující tabulka popisuje tři různé typy uzlů.

Typ uzlu	Description
kořen	Uzel, který ukotví hierarchickou sadu uzlů.
nadřazený objekt	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 ovládacího prvku nebo HyperLink Literal ovládacího prvku, na který můžete použít šablonu nebo styl. Šablony a styly se použijí na uzly podle dvou pravidel priority:

Pokud je šablona definovaná pro uzel, přepíše libovolný styl definovaný pro uzel.
Šablony a styly specifické pro typy uzlů přepíší obecné šablony a styly definované pro všechny uzly.

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

Vlastnosti a CurrentNodeTemplate CurrentNodeStyle vlastnosti se použijí na uzly, které představují aktuálně zobrazenou stránku. NodeTemplate Pokud je kromě něj CurrentNodeTemplatedefinována, bude ignorována. Pokud je kromě objektu definována NodeStyle položka , je sloučena s objektem CurrentNodeStyle pro vytvoření sloučeného CurrentNodeStylestylu. Tento sloučený styl používá všechny prvky CurrentNodeStyle, plus všechny další prvky NodeStyle , které nejsou v konfliktu s CurrentNodeStyle.

Vlastnosti a RootNodeTemplate RootNodeStyle vlastnosti se použijí na uzel, který představuje kořen hierarchie navigace na webu. NodeTemplate Pokud je kromě něj RootNodeTemplatedefinována, bude ignorována. Pokud je kromě objektu definována NodeStyle položka , je sloučena s objektem RootNodeStyle pro vytvoření sloučeného RootNodeStylestylu. Tento sloučený styl používá všechny prvky RootNodeStyle, plus všechny další prvky NodeStyle , které nebyly v konfliktu s CurrentNodeStyle. A konečně, pokud je aktuálně zobrazená stránka kořenovou stránkou webu, RootNodeTemplate použije CurrentNodeTemplate se místo RootNodeStyle nebo CurrentNodeStyle.

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

Events

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

Zvláštní událost	Description
ItemCreated	Nastane, když SiteMapPath ovládací prvek poprvé vytvoří SiteMapNodeItem a přidruží ho k .SiteMapNode
ItemDataBound	Nastane v případě, že SiteMapNodeItem je vázána na data mapy webu obsažena v objektu SiteMapNode.

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

Třídy odvozené od SiteMapPath přepsání InitializeItem metody pro přizpůsobení SiteMapNodeItem ovládacích prvků obsažených v navigačním ovládacím prvku. Pro úplnou kontrolu nad způsobem vytváření SiteMapNodeItem a přidání objektů do SiteMapPathodvozených tříd přepsat metodu CreateControlHierarchy .

Přístupnost

Informace o tom, jak tento ovládací prvek nakonfigurovat tak, aby vygeneroval značky odpovídající standardům přístupnosti, najdete v tématu Přístupnost 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

Name	Description
SiteMapPath()	Inicializuje novou instanci SiteMapPath třídy.

Vlastnosti

Name	Description
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í relativní virtuální adresář Page aplikace nebo UserControl objektu, 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 datovou vazbu 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 ovládacího prvku serveru. (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í oddělovač znak 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 urč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í cascading style sheet (CSS) třídy vykreslované 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 použít pro uzel cesty navigace webu, který představuje aktuálně zobrazenou stránku.
DataItemContainer	Získá odkaz na kontejner pojmenování, pokud pojmenování kontejner implementuje IDataItemContainer. (Zděděno od Control)
DataKeysContainer	Získá odkaz na kontejner pojmenování, pokud pojmenování kontejner implementuje IDataKeysControl. (Zděděno od Control)
DesignMode	Získá hodnotu určující, zda se ovládací prvek používá na návrhové ploše. (Zděděno od Control)
Enabled	Získá nebo nastaví hodnotu určující, zda je ovládací prvek webového serveru povolen. (Zděděno od WebControl)
EnableTheming	Získá nebo nastaví hodnotu označující, zda motivy platí pro tento ovládací prvek. (Zděděno od WebControl)
EnableViewState	Získá nebo nastaví hodnotu urč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 webovému serveru ovládacího prvku. (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 určující, zda ovládací prvek má nastaveny atributy. (Zděděno od WebControl)
HasChildViewState	Získá hodnotu určující, zda aktuální serverový ovládací prvky podřízené ovládací prvky mají jakékoli 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ý 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 určující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav ovládacího prvku. (Zděděno od Control)
IsEnabled	Získá hodnotu označující, zda je ovládací prvek povolen. (Zděděno od WebControl)
IsTrackingViewState	Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do jeho stavu zobrazení. (Zděděno od Control)
IsViewStateEnabled	Získá hodnotu označující, zda je pro tento ovládací prvek povolen stav zobrazení. (Zděděno od Control)
LoadViewStateByID	Získá hodnotu určující, zda se ovládací prvek účastní načítání jeho stavu zobrazení namísto ID indexu. (Zděděno od Control)
NamingContainer	Získá odkaz na kontejner pojmenování ovládacího prvku serveru, který vytvoří jedinečný obor názvů pro odlišné mezi serverovými ovládacími prvky se stejnou ID hodnotou vlastnosti. (Zděděno od Control)
NodeStyle	Získá styl použitý pro zobrazovaný text pro všechny uzly v navigační cestě webu.
NodeTemplate	Získá nebo nastaví šablonu ovládacího prvku pro použití pro všechny funkční uzly cesty navigace 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 ovládacího prvku 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ů, které ovládací prvek zobrazí vzhledem k aktuálně zobrazenému uzlu.
PathDirection	Získá nebo nastaví pořadí, ve které jsou vykreslovány uzly navigační cesty.
PathSeparator	Získá nebo nastaví řetězec, který odděluje 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 navigace 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 verzi, která vykreslený KÓD 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 pro použití pro kořenový uzel cesty navigace webu.
ShowToolTips	Získá nebo nastaví hodnotu určující, zda SiteMapPath ovládací prvek zapíše další atribut hypertextového odkazu pro hypertextové navigační uzly. Pokud v závislosti na podpoře klienta najede myší na hypertextový odkaz, který má další sadu atributů, zobrazí se 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 SiteMapProvider použitého k vykreslení ovládacího prvku navigace na webu.
SkinID	Získá nebo nastaví kůži, která se použije na ovládací prvek. (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 text atributy, které budou vykresleny jako atribut stylu na vnější značce webového serveru ovládacího prvku. (Zděděno od WebControl)
SupportsDisabledAttribute	Získá hodnotu, která určuje, zda ovládací prvek má nastavit `disabled` atribut vykresleného HTML elementu na "zakázáno" při vlastnosti ovládacího prvku IsEnabled je `false`. (Zděděno od CompositeControl)
TabIndex	Získá nebo nastaví index karty ovládacího prvku webového serveru. (Zděděno od WebControl)
TagKey	Získá hodnotu, která odpovídá tomuto ovládacímu HtmlTextWriterTag 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í server řízení. (Zděděno od Control)
ToolTip	Získá nebo nastaví text zobrazený, když ukazatel myši najede myší na ovládací prvek webového serveru. (Zděděno od WebControl)
UniqueID	Získá jedinečný hierarchicky kvalifikovaný identifikátor pro ovládací prvek serveru. (Zděděno od Control)
ValidateRequestMode	Získá nebo nastaví hodnotu, která urč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í ovládacího prvku serveru napříč několika požadavky na stejnou stránku. (Zděděno od Control)
ViewStateIgnoresCase	Získá hodnotu, která určuje, zda StateBag objekt nerozlišuje malá a velká písmena. (Zděděno od Control)
ViewStateMode	Získá nebo nastaví režim zobrazení-stav tohoto ovládacího prvku. (Zděděno od Control)
Visible	Získá nebo nastaví hodnotu, která urč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

Name	Description
AddAttributesToRender(HtmlTextWriter)	Přidá atributy a styly HTML, které je třeba vykreslit do zadaného HtmlTextWriterTag. Tuto metodu používají primárně vývojáři řízení. (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í serverový ovládací prvek, že byl analyzován element XML nebo HTML a přidá prvek do objektu ControlCollection ovládacího prvku serveru. (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 vlastnosti stylu definované v šabloně stylů stránky na ovládací prvek. (Zděděno od Control)
BeginRenderTracing(TextWriter, Object)	Začíná trasování doby návrhu vykreslovacích dat. (Zděděno od Control)
BuildProfileTree(String, Boolean)	Shromažďuje informace o ovládacím prvku serveru a doručuje ho Trace vlastnosti, která se má zobrazit při povolení trasování stránky. (Zděděno od Control)
ClearCachedClientID()	Nastaví hodnotu uloženou ClientID v mezipaměti na `null`hodnotu . (Zděděno od Control)
ClearChildControlState()	Odstraní informace o stavu řízení pro podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control)
ClearChildState()	Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control)
ClearChildViewState()	Odstraní informace o stavu zobrazení pro všechny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control)
ClearEffectiveClientIDMode()	ClientIDMode Nastaví vlastnost aktuální instance 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, které nejsou zapouzdřeny objektem Style ze zadaného ovládacího prvku webového serveru do ovládacího prvku webového serveru, ze kterého je tato metoda volána. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl)
CreateChildControls()	Vymaže kolekci aktuálních podřízených ovládacích prvků a znovu ji sestaví voláním CreateControlHierarchy() metody.
CreateControlCollection()	Vytvoří nový ControlCollection objekt pro uložení podřízených ovládacích prvků (literálu i serveru) ovládacího prvku serveru. (Zděděno od Control)
CreateControlHierarchy()	Prozkoumá strukturu mapy webu poskytovanou SiteMapProvider kolekcí 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ě WebControl používán třídou k implementaci všech vlastností souvisejících se stylem. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl)
DataBind()	Vytvoří vazbu zdroje dat k ovládacímu SiteMapPath prvku a jeho podřízeným ovládacím prvkům.
DataBind(Boolean)	Vytvoří vazbu zdroje dat na vyvolaný serverový ovládací prvek 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 k podřízeným ovládacím prvkům ovládacího prvku 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í vykreslování dat v době návrhu. (Zděděno od Control)
EnsureChildControls()	Určuje, zda ovládací prvek serveru 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čuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
FindControl(String, Int32)	Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným `id` a celé číslo zadané v parametru `pathOffset` , který pomáhá při hledání. Tuto verzi FindControl metody byste neměli přepsat. (Zděděno od Control)
FindControl(String)	Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným `id` parametrem. (Zděděno od Control)
Focus()	Nastaví vstupní fokus 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í funkce hash. (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ázvu trasy. (Zděděno od Control)
GetRouteUrl(String, RouteValueDictionary)	Získá adresu URL, která odpovídá sadě parametrů trasy a názvu trasy. (Zděděno od Control)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
GetUniqueIDRelativeTo(Control)	Vrátí předponu části UniqueID vlastnosti zadaného ovládacího prvku. (Zděděno od Control)
HasControls()	Určuje, zda serverový ovládací prvek obsahuje jakékoli podřízené ovládací prvky. (Zděděno od Control)
HasEvents()	Vrátí hodnotu urč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 ovládací prvek serveru obsahuje pouze literálový obsah. (Zděděno od Control)
LoadControlState(Object)	Obnoví informace o stavu řízení z předchozího požadavku na stránku, který byla uložena 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 Object. (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í primárně vývojáři řízení. (Zděděno od WebControl)
OnBubbleEvent(Object, EventArgs)	Určuje, zda je událost pro ovládací prvek serveru předána hierarchii ovládacích prvků uživatelského rozhraní stránky. (Zděděno od Control)
OnDataBinding(EventArgs)	OnDataBinding(EventArgs) Přepíše metodu 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žité 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ího 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í v klientovi.
RenderBeginTag(HtmlTextWriter)	Vykreslí počáteční značku HTML ovládacího prvku určenému zapisovači. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl)
RenderChildren(HtmlTextWriter)	Vypíše obsah podřízených položek ovládacího prvku serveru do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit v klientovi. (Zděděno od Control)
RenderContents(HtmlTextWriter)	Vykreslí uzly v ovládacím SiteMapPath prvku.
RenderControl(HtmlTextWriter, ControlAdapter)	Výstupy obsahu ovládacího prvku serveru do poskytnutého HtmlTextWriter objektu pomocí poskytnutého ControlAdapter objektu. (Zděděno od Control)
RenderControl(HtmlTextWriter)	Výstupy obsahu ovládacího prvku serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je povoleno trasování. (Zděděno od Control)
RenderEndTag(HtmlTextWriter)	Vykreslí zavírací značku HTML ovládacího prvku do zadaného zapisovače. Tuto metodu používají primárně vývojáři řízení. (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 může prohlížeč používat. (Zděděno od Control)
ResolveUrl(String)	Převede adresu URL na adresu URL, která je použitelná u žádajícího klienta. (Zděděno od Control)
SaveControlState()	Uloží všechny změny stavu řízení serveru, ke kterým došlo od doby, kdy byla stránka odeslána zpět na server. (Zděděno od Control)
SaveViewState()	Uloží změny pro zobrazení stavu SiteMapPath ovládacího prvku.
SetDesignModeState(IDictionary)	Nastaví data návrhu pro ovládací prvek. (Zděděno od Control)
SetRenderMethodDelegate(RenderMethod)	Přiřadí delegáta obslužné rutiny události k vykreslení ovládacího prvku serveru a jeho obsahu do nadřazeného ovládacího prvku. (Zděděno od Control)
SetTraceData(Object, Object, Object)	Nastaví trasovací data pro trasování doby návrhu vykreslovacích dat pomocí trasovaného objektu, klíče dat trasování a hodnoty dat trasování. (Zděděno od Control)
SetTraceData(Object, Object)	Nastaví data trasování pro trasování vykreslování dat v době návrhu pomocí klíče dat 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

Name	Description
DataBinding	Nastane, když ovládací prvek serveru vytvoří vazbu ke zdroji dat. (Zděděno od Control)
Disposed	Nastane, když je serverový ovládací prvek uvolněn z paměti, což je poslední fáze životního cyklu řízení serveru při vyžádání ASP.NET stránky. (Zděděno od Control)
Init	Nastane při inicializaci ovládacího prvku serveru, což je první krok v jeho životním cyklu. (Zděděno od Control)
ItemCreated	Nastane, když SiteMapNodeItem je vytvořen SiteMapPath a je přidružen k jeho odpovídající SiteMapNode. Tato událost je vyvolána metodou OnItemCreated(SiteMapNodeItemEventArgs) .
ItemDataBound	Nastane po SiteMapNodeItem vázání na jeho podkladová SiteMapNode data SiteMapPath. Tato událost je vyvolána metodou OnItemDataBound(SiteMapNodeItemEventArgs) .
Load	Nastane, když je serverový ovládací prvek načten do objektu Page . (Zděděno od Control)
PreRender	Nastane po načtení objektu Control , ale před vykreslením. (Zděděno od Control)
Unload	Nastane, když je serverový ovládací prvek uvolněn z paměti. (Zděděno od Control)

Explicitní implementace rozhraní

Name	Description
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 naleznete v tématu ControlBuilder. (Zděděno od Control)
IControlDesignerAccessor.GetDesignModeState()	Popis tohoto člena naleznete v tématu GetDesignModeState(). (Zděděno od Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Popis tohoto člena naleznete v tématu SetDesignModeState(IDictionary). (Zděděno od Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Popis tohoto člena naleznete v tématu SetOwnerControl(Control). (Zděděno od Control)
IControlDesignerAccessor.UserData	Popis tohoto člena naleznete v tématu UserData. (Zděděno od Control)
IDataBindingsAccessor.DataBindings	Popis tohoto člena naleznete v tématu DataBindings. (Zděděno od Control)
IDataBindingsAccessor.HasDataBindings	Popis tohoto člena naleznete v tématu HasDataBindings. (Zděděno od Control)
IExpressionsAccessor.Expressions	Popis tohoto člena naleznete v tématu Expressions. (Zděděno od Control)
IExpressionsAccessor.HasExpressions	Popis tohoto člena naleznete v tématu HasExpressions. (Zděděno od Control)
IParserAccessor.AddParsedSubObject(Object)	Popis tohoto člena naleznete v tématu AddParsedSubObject(Object). (Zděděno od Control)

Metody rozšíření

Name	Description
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Povolí chování dynamických dat pro zadaný ovládací prvek dat.
EnableDynamicData(INamingContainer, Type, Object)	Povolí chování dynamických dat pro zadaný ovládací prvek dat.
EnableDynamicData(INamingContainer, Type)	Povolí chování dynamických dat pro zadaný ovládací prvek dat.
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 pojmenování 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, IDictionary<String,Object>)	Nastaví metadata tabulky a výchozí mapování hodnot pro zadaný ovládací prvek dat.
SetMetaTable(INamingContainer, MetaTable, Object)	Nastaví metadata tabulky a výchozí mapování hodnot pro zadaný ovládací prvek dat.
SetMetaTable(INamingContainer, MetaTable)	Nastaví metadata tabulky pro zadaný ovládací prvek dat.
TryGetMetaTable(INamingContainer, MetaTable)	Určuje, zda jsou k dispozici metadata tabulky.

Platí pro

Viz také

Váš názor

Byla tato stránka užitečná?