SiteMapPath Klass

Definition

Namnområde:: System.Web.UI.WebControls

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Visar en uppsättning text- eller bildlänkar som gör det lättare för användare att navigera på en webbplats, samtidigt som det tar minimalt med sidutrymme.

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

Arv: Object

Control

WebControl

CompositeControl
SiteMapPath

Exempel

I följande kodexempel används en SiteMapPath kontroll deklarativt på en webbformulärsida. Det här exemplet visar några av de prioritetsregler som styr den ordning med vilken mallar och formatmallar tillämpas på SiteMapPath noder.

<%@ 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>

I föregående exempel används standardprovidern för webbplatsöversikt och en web.sitemap-fil med följande struktur.

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

Följande kodexempel visar utökar SiteMapPath kontrollen och lägger till nya funktioner i den InitializeItem genom att åsidosätta metoden. Kontrollen DropDownSiteMapPath lägger till en DropDownList efter den aktuella noden för att göra det enkelt att navigera till sidor som är underordnade noder på den aktuella sidan. Det här exemplet visar hur du arbetar med SiteMapNodeItem objekt, inklusive att kontrollera deras SiteMapNodeItemType och anropa OnItemCreated metoden när objekten har skapats.

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

Kommentarer

I det här avsnittet:

Inledning
Nodes
Nodutseende
Events
Anpassa SiteMapPath-kontrollen
Tillgänglighet
Deklarativ syntax

Introduction

Kontrollen SiteMapPath är en platsnavigeringskontroll som återspeglar data som tillhandahålls av SiteMap objektet. Det ger ett utrymmesbesparande sätt att enkelt navigera på en webbplats och fungerar som referenspunkt för var den aktuella sidan finns på en webbplats. Den här typen av kontroll kallas ofta för en brödsmula, eller ögonbryn, eftersom den visar en hierarkisk sökväg med hyperlänkade sidnamn som ger en flykt uppåt i hierarkin med sidor från den aktuella platsen. SiteMapDataSource. SiteMapPath Är användbart för webbplatser som har djupa hierarkiska sidstrukturer, men där en TreeView eller Menu kan kräva för mycket utrymme på en sida.

Kontrollen SiteMapPath fungerar direkt med webbplatsens webbplatsöversiktsdata. Om du använder den på en sida som inte visas på webbplatskartan visas den inte. Mer information om webbplatskartor finns i ASP.NET Site Navigation.

Nodes

SiteMapPath består av noder. Varje element i sökvägen kallas för en nod och representeras av ett SiteMapNodeItem objekt. Noden som fäster sökvägen och representerar basen i det hierarkiska trädet kallas rotnoden. Noden som representerar den aktuella sidan är den aktuella noden. Alla andra noder mellan den aktuella noden och rotnoden är en överordnad nod. I följande tabell beskrivs de tre olika nodtyperna.

Nodtyp	Description
root	En nod som fäster en hierarkisk uppsättning noder.
parent	En nod som har en eller flera underordnade noder, men som inte är den aktuella noden.
ström	En nod som representerar den sida som visas just nu.

Nodutseende

Varje nod som visas av en SiteMapPath är en HyperLink eller Literal en kontroll som du kan använda en mall eller formatmall på. Mallarna och formatmallarna tillämpas på noder enligt två prioritetsregler:

Om en mall har definierats för en nod åsidosätter den alla formatmallar som definierats för noden.
Mallar och formatmallar som är specifika för typer av noder åsidosätter allmänna mallar och format som definierats för alla noder.

NodeStyle Egenskaperna och NodeTemplate tillämpas på alla noder, oavsett nodtyp. Om båda dessa egenskaper definieras har de NodeTemplate företräde.

Egenskaperna CurrentNodeTemplate och CurrentNodeStyle tillämpas på noder som representerar den sida som visas för närvarande. Om en NodeTemplate definieras utöver ignoreras den CurrentNodeTemplate. Om en NodeStyle definieras utöver sammanfogas den CurrentNodeStylemed CurrentNodeStyle för att skapa ett sammanfogat format. Det här sammanfogade formatet använder alla element i CurrentNodeStyle, plus eventuella ytterligare element i NodeStyle som inte är i konflikt med CurrentNodeStyle.

RootNodeTemplate Egenskaperna och RootNodeStyle tillämpas på noden som representerar roten i platsnavigeringshierarkin. Om en NodeTemplate definieras utöver ignoreras den RootNodeTemplate. Om en NodeStyle definieras utöver sammanfogas den RootNodeStylemed RootNodeStyle för att skapa ett sammanfogat format. Det här sammanfogade formatet använder alla element i RootNodeStyle, plus eventuella ytterligare element i NodeStyle som inte stod i CurrentNodeStylekonflikt med . Slutligen, om den sida som visas för närvarande är rotsidan för webbplatsen, RootNodeTemplate används och RootNodeStyle i stället för CurrentNodeTemplate eller CurrentNodeStyle.

Kontrollen SiteMapPath använder webbplatsöversiktsprovidern SiteMapProvider som identifieras av egenskapen som dess datakälla för platsnavigeringsinformation. Om ingen provider anges använder den standardprovidern för platsen som identifieras i SiteMap.Provider egenskapen. Detta är vanligtvis en instans av standardprovidern för webbplatskartor för ASP.NET, XmlSiteMapProvider. SiteMapPath Om kontrollen används på en plats men ingen platskarteprovider har konfigurerats utlöser kontrollen ett HttpException undantag.

Händelser

Kontrollen SiteMapPath innehåller även händelser som du kan programmera mot. På så sätt kan du köra en anpassad rutin när en händelse inträffar. I följande tabell visas de händelser som stöds av SiteMapPath kontrollen.

Händelse	Description
ItemCreated	Inträffar när SiteMapPath kontrollen först skapar en SiteMapNodeItem och associerar den med en SiteMapNode.
ItemDataBound	Inträffar när en SiteMapNodeItem är bunden till platsmappningsdata som finns i SiteMapNode.

Anpassa SiteMapPath-kontrollen

Klasser som härleds från SiteMapPath åsidosätter InitializeItem metoden för att anpassa de SiteMapNodeItem kontroller som ingår i navigeringskontrollen. För fullständig kontroll över hur SiteMapNodeItem objekt skapas och läggs till i SiteMapPathåsidosätter CreateControlHierarchy härledda klasser metoden.

Tillgänglighet

Information om hur du konfigurerar den här kontrollen så att den genererar markering som överensstämmer med tillgänglighetsstandarder finns i Accessibility i Visual Studio och ASP.NET och ASP.NET Controls and Accessibility.

Deklarativ syntax

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

Konstruktorer

Name	Description
SiteMapPath()	Initierar en ny instans av SiteMapPath klassen.

Egenskaper

Name	Description
AccessKey	Hämtar eller anger åtkomstnyckeln som gör att du snabbt kan navigera till webbserverkontrollen. (Ärvd från WebControl)
Adapter	Hämtar det webbläsarspecifika adaptern för kontrollen. (Ärvd från Control)
AppRelativeTemplateSourceDirectory	Hämtar eller anger den programrelativa virtuella katalogen Page UserControl för eller -objektet som innehåller den här kontrollen. (Ärvd från Control)
Attributes	Hämtar samlingen med godtyckliga attribut (endast för återgivning) som inte motsvarar egenskaperna i kontrollen. (Ärvd från WebControl)
BackColor	Hämtar eller anger bakgrundsfärgen för webbserverkontrollen. (Ärvd från WebControl)
BindingContainer	Hämtar kontrollen som innehåller den här kontrollens databindning. (Ärvd från Control)
BorderColor	Hämtar eller anger kantlinjefärgen för webbkontrollen. (Ärvd från WebControl)
BorderStyle	Hämtar eller anger kantlinjeformatet för webbserverkontrollen. (Ärvd från WebControl)
BorderWidth	Hämtar eller anger kantlinjebredden för webbserverkontrollen. (Ärvd från WebControl)
ChildControlsCreated	Hämtar ett värde som anger om serverkontrollens underordnade kontroller har skapats. (Ärvd från Control)
ClientID	Hämtar kontroll-ID:t för HTML-kod som genereras av ASP.NET. (Ärvd från Control)
ClientIDMode	Hämtar eller anger den algoritm som används för att generera värdet för ClientID egenskapen. (Ärvd från Control)
ClientIDSeparator	Hämtar ett teckenvärde som representerar det avgränsartecken som används i egenskapen ClientID . (Ärvd från Control)
Context	Hämtar objektet HttpContext som är associerat med serverkontrollen för den aktuella webbbegäran. (Ärvd från Control)
Controls	Hämtar ett ControlCollection objekt som representerar de underordnade kontrollerna i en CompositeControl. (Ärvd från CompositeControl)
ControlStyle	Hämtar formatmallen för webbserverkontrollen. Den här egenskapen används främst av kontrollutvecklare. (Ärvd från WebControl)
ControlStyleCreated	Hämtar ett värde som anger om ett Style objekt har skapats för egenskapen ControlStyle . Den här egenskapen används främst av kontrollutvecklare. (Ärvd från WebControl)
CssClass	Hämtar eller anger css-klassen (Cascading Style Sheet) som återges av webbserverkontrollen på klienten. (Ärvd från WebControl)
CurrentNodeStyle	Hämtar det format som används för visningstexten för den aktuella noden.
CurrentNodeTemplate	Hämtar eller anger en kontrollmall som ska användas för noden för en webbplatsnavigeringssökväg som representerar den sida som visas för tillfället.
DataItemContainer	Hämtar en referens till namngivningscontainern om namngivningscontainern implementerar IDataItemContainer. (Ärvd från Control)
DataKeysContainer	Hämtar en referens till namngivningscontainern om namngivningscontainern implementerar IDataKeysControl. (Ärvd från Control)
DesignMode	Hämtar ett värde som anger om en kontroll används på en designyta. (Ärvd från Control)
Enabled	Hämtar eller anger ett värde som anger om webbserverkontrollen är aktiverad. (Ärvd från WebControl)
EnableTheming	Hämtar eller anger ett värde som anger om teman ska gälla för den här kontrollen. (Ärvd från WebControl)
EnableViewState	Hämtar eller anger ett värde som anger om serverkontrollen bevarar sitt visningstillstånd och visningstillståndet för eventuella underordnade kontroller som den innehåller till den begärande klienten. (Ärvd från Control)
Events	Hämtar en lista över händelsehanterardelegater för kontrollen. Den här egenskapen är skrivskyddad. (Ärvd från Control)
Font	Hämtar teckensnittsegenskaperna som är associerade med webbserverkontrollen. (Ärvd från WebControl)
ForeColor	Hämtar eller anger förgrundsfärgen (vanligtvis textens färg) för webbserverkontrollen. (Ärvd från WebControl)
HasAttributes	Hämtar ett värde som anger om kontrollen har attribut inställda. (Ärvd från WebControl)
HasChildViewState	Hämtar ett värde som anger om den aktuella serverkontrollens underordnade kontroller har några sparade vytillståndsinställningar. (Ärvd från Control)
Height	Hämtar eller anger höjden på webbserverkontrollen. (Ärvd från WebControl)
ID	Hämtar eller anger den programmatiska identifierare som tilldelats serverkontrollen. (Ärvd från Control)
IdSeparator	Hämtar det tecken som används för att separera kontrollidentifierare. (Ärvd från Control)
IsChildControlStateCleared	Hämtar ett värde som anger om kontroller i den här kontrollen har kontrolltillstånd. (Ärvd från Control)
IsEnabled	Hämtar ett värde som anger om kontrollen är aktiverad. (Ärvd från WebControl)
IsTrackingViewState	Hämtar ett värde som anger om serverkontrollen sparar ändringar i visningstillståndet. (Ärvd från Control)
IsViewStateEnabled	Hämtar ett värde som anger om visningstillstånd är aktiverat för den här kontrollen. (Ärvd från Control)
LoadViewStateByID	Hämtar ett värde som anger om kontrollen deltar i inläsningen av dess visningstillstånd i ID stället för index. (Ärvd från Control)
NamingContainer	Hämtar en referens till serverkontrollens namngivningscontainer, vilket skapar ett unikt namnområde för differentiering mellan serverkontroller med samma ID egenskapsvärde. (Ärvd från Control)
NodeStyle	Hämtar det format som används för visningstexten för alla noder i webbplatsnavigeringssökvägen.
NodeTemplate	Hämtar eller anger en kontrollmall som ska användas för alla funktionella noder i en webbplatsnavigeringssökväg.
Page	Hämtar en referens till den Page instans som innehåller serverkontrollen. (Ärvd från Control)
Parent	Hämtar en referens till serverkontrollens överordnade kontroll i sidkontrollhierarkin. (Ärvd från Control)
ParentLevelsDisplayed	Hämtar eller anger antalet nivåer av överordnade noder som kontrollen visar i förhållande till den nod som visas för tillfället.
PathDirection	Hämtar eller anger den ordning som navigeringssökvägsnoderna återges i.
PathSeparator	Hämtar eller anger strängen som avgränsar SiteMapPath noder i den renderade navigeringssökvägen.
PathSeparatorStyle	Hämtar det format som används för strängen PathSeparator .
PathSeparatorTemplate	Hämtar eller anger en kontrollmall som ska användas för sökvägsgränsaren för en webbplatsnavigeringssökväg.
Provider	Hämtar eller anger en SiteMapProvider som är associerad med webbserverkontrollen.
RenderCurrentNodeAsLink	Anger om platsnavigeringsnoden som representerar den aktuella sidan återges som en hyperlänk.
RenderingCompatibility	Hämtar ett värde som anger den ASP.NET version som renderad HTML kommer att vara kompatibel med. (Ärvd från Control)
RootNodeStyle	Hämtar formatmallen för rotnodens visningstext.
RootNodeTemplate	Hämtar eller anger en kontrollmall som ska användas för rotnoden i en webbplatsnavigeringssökväg.
ShowToolTips	Hämtar eller anger ett värde som anger om SiteMapPath kontrollen skriver ytterligare ett hyperlänkattribut för hyperlänkade navigeringsnoder. Beroende på klientstöd visas en knappbeskrivning när en mus hovrar över en hyperlänk som har den ytterligare attributuppsättningen.
Site	Hämtar information om containern som är värd för den aktuella kontrollen när den återges på en designyta. (Ärvd från Control)
SiteMapProvider	Hämtar eller anger namnet på det SiteMapProvider som används för att återge platsnavigeringskontrollen.
SkinID	Hämtar eller ställer in huden för att applicera på kontrollen. (Ärvd från WebControl)
SkipLinkText	Hämtar eller anger ett värde som används för att återge alternativ text för skärmläsare för att hoppa över kontrollens innehåll.
Style	Hämtar en samling textattribut som återges som ett formatattribut på den yttre taggen för webbserverkontrollen. (Ärvd från WebControl)
SupportsDisabledAttribute	Hämtar ett värde som anger om kontrollen ska ange `disabled` attributet för det renderade HTML-elementet till "inaktiverat" när kontrollens IsEnabled egenskap är `false`. (Ärvd från CompositeControl)
TabIndex	Hämtar eller anger flikindexet för webbserverkontrollen. (Ärvd från WebControl)
TagKey	Hämtar värdet HtmlTextWriterTag som motsvarar den här webbserverkontrollen. Den här egenskapen används främst av kontrollutvecklare. (Ärvd från WebControl)
TagName	Hämtar namnet på kontrolltaggen. Den här egenskapen används främst av kontrollutvecklare. (Ärvd från WebControl)
TemplateControl	Hämtar eller anger en referens till mallen som innehåller den här kontrollen. (Ärvd från Control)
TemplateSourceDirectory	Hämtar den virtuella katalogen för Page eller UserControl som innehåller den aktuella serverkontrollen. (Ärvd från Control)
ToolTip	Hämtar eller anger texten som visas när muspekaren hovrar över webbserverkontrollen. (Ärvd från WebControl)
UniqueID	Hämtar den unika, hierarkiskt kvalificerade identifieraren för serverkontrollen. (Ärvd från Control)
ValidateRequestMode	Hämtar eller anger ett värde som anger om kontrollen kontrollerar klientindata från webbläsaren efter potentiellt farliga värden. (Ärvd från Control)
ViewState	Hämtar en ordlista med tillståndsinformation som gör att du kan spara och återställa visningstillståndet för en serverkontroll över flera begäranden för samma sida. (Ärvd från Control)
ViewStateIgnoresCase	Hämtar ett värde som anger om objektet StateBag är skiftlägesokänsligt. (Ärvd från Control)
ViewStateMode	Hämtar eller anger visningstillståndsläget för den här kontrollen. (Ärvd från Control)
Visible	Hämtar eller anger ett värde som anger om en serverkontroll återges som användargränssnitt på sidan. (Ärvd från Control)
Width	Hämtar eller anger bredden på webbserverkontrollen. (Ärvd från WebControl)

Metoder

Name	Description
AddAttributesToRender(HtmlTextWriter)	Lägger till HTML-attribut och formatmallar som måste återges till den angivna HtmlTextWriterTag. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
AddedControl(Control, Int32)	Anropas efter att en underordnad kontroll har lagts till i Controls Control objektets samling. (Ärvd från Control)
AddParsedSubObject(Object)	Meddelar serverkontrollen att ett element, antingen XML eller HTML, parsades och lägger till elementet i serverkontrollens ControlCollection objekt. (Ärvd från Control)
ApplyStyle(Style)	Kopierar alla icke-tomma element i det angivna formatet till webbkontrollen och skriver över alla befintliga formatelement i kontrollen. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
ApplyStyleSheetSkin(Page)	Tillämpar formategenskaperna som definierats i sidformatmallen på kontrollen. (Ärvd från Control)
BeginRenderTracing(TextWriter, Object)	Påbörjar designtidsspårning av återgivningsdata. (Ärvd från Control)
BuildProfileTree(String, Boolean)	Samlar in information om serverkontrollen och levererar den till egenskapen Trace som ska visas när spårning är aktiverat för sidan. (Ärvd från Control)
ClearCachedClientID()	Anger det cachelagrade ClientID värdet till `null`. (Ärvd från Control)
ClearChildControlState()	Tar bort kontrolltillståndsinformationen för serverkontrollens underordnade kontroller. (Ärvd från Control)
ClearChildState()	Tar bort informationen om visningstillstånd och kontrolltillstånd för alla serverkontrollens underordnade kontroller. (Ärvd från Control)
ClearChildViewState()	Tar bort visningstillståndsinformationen för alla serverkontrollens underordnade kontroller. (Ärvd från Control)
ClearEffectiveClientIDMode()	Anger egenskapen för ClientIDMode den aktuella kontrollinstansen och för eventuella underordnade kontroller till Inherit. (Ärvd från Control)
CopyBaseAttributes(WebControl)	Kopierar egenskaperna som inte kapslas in av Style objektet från den angivna webbserverkontrollen till den webbserverkontroll som den här metoden anropas från. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
CreateChildControls()	Rensar den aktuella underordnade kontrollsamlingen och återskapar den genom att anropa CreateControlHierarchy() metoden.
CreateControlCollection()	Skapar ett nytt ControlCollection objekt som innehåller de underordnade kontrollerna (både literal och server) för serverkontrollen. (Ärvd från Control)
CreateControlHierarchy()	Undersöker webbplatskartans struktur som tillhandahålls av SiteMapProvider och skapar en underordnad kontrollsamling baserat på de format och mallar som definierats för de funktionella noderna.
CreateControlStyle()	Skapar formatobjektet som används internt av WebControl klassen för att implementera alla formatrelaterade egenskaper. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
DataBind()	Binder en datakälla till SiteMapPath kontrollen och dess underordnade kontroller.
DataBind(Boolean)	Binder en datakälla till den anropade serverkontrollen och alla dess underordnade kontroller med ett alternativ för att skapa händelsen DataBinding . (Ärvd från Control)
DataBindChildren()	Binder en datakälla till serverkontrollens underordnade kontroller. (Ärvd från Control)
Dispose()	Gör att en serverkontroll kan utföra slutlig rensning innan den frigörs från minnet. (Ärvd från Control)
EndRenderTracing(TextWriter, Object)	Avslutar designtidsspårning av återgivningsdata. (Ärvd från Control)
EnsureChildControls()	Avgör om serverkontrollen innehåller underordnade kontroller. Om den inte gör det skapar den underordnade kontroller. (Ärvd från Control)
EnsureID()	Skapar en identifierare för kontroller som inte har tilldelats någon identifierare. (Ärvd från Control)
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
FindControl(String, Int32)	Söker i den aktuella namngivningscontainern efter en serverkontroll med det angivna `id` och ett heltal som anges i parametern `pathOffset` , vilket underlättar sökningen. Du bör inte åsidosätta den här versionen av FindControl metoden. (Ärvd från Control)
FindControl(String)	Söker i den aktuella namngivningscontainern efter en serverkontroll med den angivna `id` parametern. (Ärvd från Control)
Focus()	Anger indatafokus till en kontroll. (Ärvd från Control)
GetDesignModeState()	Hämtar designtidsdata för en kontroll. (Ärvd från Control)
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetRouteUrl(Object)	Hämtar url:en som motsvarar en uppsättning routningsparametrar. (Ärvd från Control)
GetRouteUrl(RouteValueDictionary)	Hämtar url:en som motsvarar en uppsättning routningsparametrar. (Ärvd från Control)
GetRouteUrl(String, Object)	Hämtar url:en som motsvarar en uppsättning vägparametrar och ett vägnamn. (Ärvd från Control)
GetRouteUrl(String, RouteValueDictionary)	Hämtar url:en som motsvarar en uppsättning vägparametrar och ett vägnamn. (Ärvd från Control)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
GetUniqueIDRelativeTo(Control)	Returnerar den prefixade delen av UniqueID egenskapen för den angivna kontrollen. (Ärvd från Control)
HasControls()	Avgör om serverkontrollen innehåller några underordnade kontroller. (Ärvd från Control)
HasEvents()	Returnerar ett värde som anger om händelser har registrerats för kontrollen eller underordnade kontroller. (Ärvd från Control)
InitializeItem(SiteMapNodeItem)	Fyller i en SiteMapNodeItem, som är en webbserverkontroll som representerar en SiteMapNode, med en uppsättning underordnade kontroller baserat på nodens funktion och angivna mallar och format för noden.
IsLiteralContent()	Avgör om serverkontrollen endast innehåller literalinnehåll. (Ärvd från Control)
LoadControlState(Object)	Återställer kontrolltillståndsinformation från en begäran från föregående sida som sparades av SaveControlState() metoden. (Ärvd från Control)
LoadViewState(Object)	Återställer visningstillståndsinformation från en tidigare begäran som sparades med SaveViewState() metoden.
MapPathSecure(String)	Hämtar den fysiska sökväg som en virtuell sökväg, antingen absolut eller relativ, mappar till. (Ärvd från Control)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
MergeStyle(Style)	Kopierar alla icke-tomma element i det angivna formatet till webbkontrollen, men skriver inte över några befintliga formatelement i kontrollen. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
OnBubbleEvent(Object, EventArgs)	Avgör om händelsen för serverkontrollen skickas upp på sidans UI-serverkontrollhierarki. (Ärvd från Control)
OnDataBinding(EventArgs)	Åsidosätter OnDataBinding(EventArgs) -metoden för CompositeControl klassen och genererar DataBinding händelsen.
OnInit(EventArgs)	Genererar händelsen Init . (Ärvd från Control)
OnItemCreated(SiteMapNodeItemEventArgs)	Genererar ItemCreated kontrollens SiteMapPath händelse.
OnItemDataBound(SiteMapNodeItemEventArgs)	Genererar ItemDataBound kontrollens SiteMapPath händelse.
OnLoad(EventArgs)	Genererar händelsen Load . (Ärvd från Control)
OnPreRender(EventArgs)	Genererar händelsen PreRender . (Ärvd från Control)
OnUnload(EventArgs)	Genererar händelsen Unload . (Ärvd från Control)
OpenFile(String)	Hämtar en Stream som används för att läsa en fil. (Ärvd från Control)
RaiseBubbleEvent(Object, EventArgs)	Tilldelar alla källor till händelsen och dess information till kontrollens överordnade. (Ärvd från Control)
RecreateChildControls()	Återskapar de underordnade kontrollerna i en kontroll som härleds från CompositeControl. (Ärvd från CompositeControl)
RemovedControl(Control)	Anropas efter att en underordnad Controls kontroll har tagits bort från objektets Control samling. (Ärvd från Control)
Render(HtmlTextWriter)	Skriver innehållet CompositeControl till det angivna HtmlTextWriter objektet för visning på klienten.
RenderBeginTag(HtmlTextWriter)	Renderar HTML-öppningstaggen för kontrollen till den angivna skrivaren. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
RenderChildren(HtmlTextWriter)	Matar ut innehållet i en serverkontrolls underordnade objekt till ett angivet HtmlTextWriter objekt som skriver innehållet som ska återges på klienten. (Ärvd från Control)
RenderContents(HtmlTextWriter)	Renderar noderna i SiteMapPath kontrollen.
RenderControl(HtmlTextWriter, ControlAdapter)	Matar ut serverkontrollinnehåll till ett angivet HtmlTextWriter objekt med hjälp av ett angivet ControlAdapter objekt. (Ärvd från Control)
RenderControl(HtmlTextWriter)	Matar ut serverkontrollinnehåll till ett angivet HtmlTextWriter objekt och lagrar spårningsinformation om kontrollen om spårning är aktiverat. (Ärvd från Control)
RenderEndTag(HtmlTextWriter)	Renderar HTML-avslutande taggen för kontrollen till den angivna skrivaren. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
ResolveAdapter()	Hämtar kontrollkortet som ansvarar för att återge den angivna kontrollen. (Ärvd från Control)
ResolveClientUrl(String)	Hämtar en URL som kan användas av webbläsaren. (Ärvd från Control)
ResolveUrl(String)	Konverterar en URL till en som kan användas på den begärande klienten. (Ärvd från Control)
SaveControlState()	Sparar alla ändringar i serverkontrolltillståndet som har inträffat sedan sidan publicerades tillbaka till servern. (Ärvd från Control)
SaveViewState()	Sparar ändringar för att visa tillståndet för SiteMapPath kontrollen.
SetDesignModeState(IDictionary)	Anger designtidsdata för en kontroll. (Ärvd från Control)
SetRenderMethodDelegate(RenderMethod)	Tilldelar ett händelsehanterardelegat för att återge serverkontrollen och dess innehåll till den överordnade kontrollen. (Ärvd från Control)
SetTraceData(Object, Object, Object)	Anger spårningsdata för designtidsspårning av återgivningsdata, med hjälp av det spårade objektet, spårningsdatanyckeln och värdet för spårningsdata. (Ärvd från Control)
SetTraceData(Object, Object)	Anger spårningsdata för designtidsspårning av återgivningsdata med hjälp av spårningsdatanyckeln och värdet för spårningsdata. (Ärvd från Control)
ToString()	Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object)
TrackViewState()	Spårar ändringar i SiteMapPath kontrollens visningstillstånd.

Händelser

Name	Description
DataBinding	Inträffar när serverkontrollen binder till en datakälla. (Ärvd från Control)
Disposed	Inträffar när en serverkontroll frigörs från minnet, vilket är den sista fasen i serverkontrolllivscykeln när en ASP.NET sida begärs. (Ärvd från Control)
Init	Inträffar när serverkontrollen initieras, vilket är det första steget i dess livscykel. (Ärvd från Control)
ItemCreated	Inträffar när en SiteMapNodeItem skapas av SiteMapPath och är associerad med motsvarande SiteMapNode. Den här händelsen genereras av OnItemCreated(SiteMapNodeItemEventArgs) metoden .
ItemDataBound	Inträffar efter att en SiteMapNodeItem har bundits till dess underliggande SiteMapNode data av SiteMapPath. Den här händelsen genereras av OnItemDataBound(SiteMapNodeItemEventArgs) metoden .
Load	Inträffar när serverkontrollen läses in i Page objektet. (Ärvd från Control)
PreRender	Inträffar efter att objektet Control har lästs in men före återgivningen. (Ärvd från Control)
Unload	Inträffar när serverkontrollen tas bort från minnet. (Ärvd från Control)

Explicita gränssnittsimplementeringar

Name	Description
IAttributeAccessor.GetAttribute(String)	Hämtar ett attribut för webbkontrollen med det angivna namnet. (Ärvd från WebControl)
IAttributeAccessor.SetAttribute(String, String)	Anger ett attribut för webbkontrollen till det angivna namnet och värdet. (Ärvd från WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()	Gör att en designer kan återskapa den sammansatta kontrollens samling underordnade kontroller i designmiljön. (Ärvd från CompositeControl)
IControlBuilderAccessor.ControlBuilder	En beskrivning av den här medlemmen finns i ControlBuilder. (Ärvd från Control)
IControlDesignerAccessor.GetDesignModeState()	En beskrivning av den här medlemmen finns i GetDesignModeState(). (Ärvd från Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	En beskrivning av den här medlemmen finns i SetDesignModeState(IDictionary). (Ärvd från Control)
IControlDesignerAccessor.SetOwnerControl(Control)	En beskrivning av den här medlemmen finns i SetOwnerControl(Control). (Ärvd från Control)
IControlDesignerAccessor.UserData	En beskrivning av den här medlemmen finns i UserData. (Ärvd från Control)
IDataBindingsAccessor.DataBindings	En beskrivning av den här medlemmen finns i DataBindings. (Ärvd från Control)
IDataBindingsAccessor.HasDataBindings	En beskrivning av den här medlemmen finns i HasDataBindings. (Ärvd från Control)
IExpressionsAccessor.Expressions	En beskrivning av den här medlemmen finns i Expressions. (Ärvd från Control)
IExpressionsAccessor.HasExpressions	En beskrivning av den här medlemmen finns i HasExpressions. (Ärvd från Control)
IParserAccessor.AddParsedSubObject(Object)	En beskrivning av den här medlemmen finns i AddParsedSubObject(Object). (Ärvd från Control)

Tilläggsmetoder

Name	Description
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Aktiverar dynamiskt databeteende för den angivna datakontrollen.
EnableDynamicData(INamingContainer, Type, Object)	Aktiverar dynamiskt databeteende för den angivna datakontrollen.
EnableDynamicData(INamingContainer, Type)	Aktiverar dynamiskt databeteende för den angivna datakontrollen.
FindDataSourceControl(Control)	Returnerar datakällan som är associerad med datakontrollen för den angivna kontrollen.
FindFieldTemplate(Control, String)	Returnerar fältmallen för den angivna kolumnen i den angivna kontrollens namngivningscontainer.
FindMetaTable(Control)	Returnerar metatabellobjektet för den innehållande datakontrollen.
GetDefaultValues(INamingContainer)	Hämtar insamlingen av standardvärdena för den angivna datakontrollen.
GetMetaTable(INamingContainer)	Hämtar tabellmetadata för den angivna datakontrollen.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Anger tabellmetadata och standardvärdemappning för den angivna datakontrollen.
SetMetaTable(INamingContainer, MetaTable, Object)	Anger tabellmetadata och standardvärdemappning för den angivna datakontrollen.
SetMetaTable(INamingContainer, MetaTable)	Anger tabellmetadata för den angivna datakontrollen.
TryGetMetaTable(INamingContainer, MetaTable)	Avgör om tabellmetadata är tillgängliga.

Gäller för

Se även

Feedback

Var den här sidan till hjälp?