SiteMapPath Classe

Definição

Espaço de Nomes:: System.Web.UI.WebControls

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Apresenta um conjunto de hiperligações de texto ou imagem que permitem aos utilizadores navegar mais facilmente num site, ocupando o mínimo de espaço da página.

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

Herança: Object

Control

WebControl

CompositeControl
SiteMapPath

Exemplos

O seguinte exemplo de código utiliza um SiteMapPath controlo declarativamente numa página Web Forms. Este exemplo demonstra algumas das regras de precedência que regem a ordem com que os modelos e estilos são aplicados aos SiteMapPath nós.

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

O exemplo anterior utiliza o fornecedor padrão de mapas do site e um ficheiro Web.sitemap com a seguinte estrutura.

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

O exemplo de código seguinte demonstra que estende o SiteMapPath controlo e adiciona novas funcionalidades ao sobrepor o InitializeItem método. O DropDownSiteMapPath controlo adiciona um DropDownList após o nó atual, para permitir uma navegação fácil para páginas que são nós filhos da página atual. Este exemplo demonstra como trabalhar com SiteMapNodeItem objetos, incluindo verificar e SiteMapNodeItemType chamar o OnItemCreated método após a criação dos itens.

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

Observações

Neste tópico:

Introdução
Nodes
Aparência do Nó
Events
Personalização do Controlo SiteMapPath
Acessibilidade
Sintaxe declarativa

Introduction

O SiteMapPath controlo é um controlo de navegação no local que reflete os dados fornecidos pelo SiteMap objeto. Proporciona uma forma de poupar espaço para navegar facilmente num site e serve como ponto de referência para saber onde a página atualmente apresentada dentro do site. Este tipo de controlo é comumente chamado de breadcrumb, ou sobrancelha, porque apresenta um caminho hierárquico de nomes de páginas hiperligados que proporciona uma saída para cima na hierarquia das páginas a partir da localização atual. SiteMapDataSource. É SiteMapPath útil para sites com estruturas de página muito hierárquicas, mas onde um TreeView ou Menu pode exigir demasiado espaço numa página.

O SiteMapPath controlo funciona diretamente com os dados do mapa do site do seu site. Se o usar numa página que não está representada no seu mapa do site, não será exibido. Para mais informações sobre mapas de sítios, consulte ASP.NET Site Navigation.

Nodes

O SiteMapPath é composto por nós. Cada elemento no caminho é chamado de nó e é representado por um SiteMapNodeItem objeto. O nó que ancora o caminho e representa a base da árvore hierárquica chama-se nó raiz. O nó que representa a página atualmente apresentada é o nó atual. Qualquer outro nó entre o nó atual e o nó raiz é um nó pai. A tabela seguinte descreve os três tipos diferentes de nós.

Tipo de nó	Description
raiz	Um nó que ancora um conjunto hierárquico de nós.
elemento principal	Um nó que tem um ou mais nós filhos, mas que não é o nó atual.
atual	Um nó que representa a página atualmente apresentada.

Aparência do Nó

Cada nó apresentado por um SiteMapPath é um controlo HyperLink ou Literal ao qual podes aplicar um modelo ou estilo. Os templates e estilos são aplicados aos nós de acordo com duas regras de precedência:

Se um template for definido para um nó, ele sobrepõe-se a qualquer estilo definido para esse nó.
Modelos e estilos específicos para tipos de nós sobrepõem-se aos modelos gerais e estilos definidos para todos os nós.

As NodeStyle propriedades e NodeTemplate são aplicadas a todos os nós, independentemente do seu tipo de nó. Se ambas as propriedades estiverem definidas, o NodeTemplate tem precedência.

As CurrentNodeTemplate propriedades e CurrentNodeStyle são aplicadas a nós que representam a página atualmente apresentada. Se a NodeTemplate for definido além do CurrentNodeTemplate, é ignorado. Se a NodeStyle for definido além do CurrentNodeStyle, é fundido com o CurrentNodeStyle para criar um estilo fundido. Este estilo fundido usa todos os elementos do CurrentNodeStyle, mais quaisquer elementos adicionais do NodeStyle que não entrem em conflito com o CurrentNodeStyle.

As RootNodeTemplate propriedades e RootNodeStyle são aplicadas ao nó que representa a raiz da hierarquia de navegação do local. Se a NodeTemplate for definido além do RootNodeTemplate, é ignorado. Se a NodeStyle for definido além do RootNodeStyle, é fundido com o RootNodeStyle para criar um estilo fundido. Este estilo fundido usa todos os elementos do RootNodeStyle, mais quaisquer elementos adicionais do NodeStyle que não tenham entrado em conflito com o CurrentNodeStyle. Finalmente, se a página atualmente apresentada for a página raiz do site, os RootNodeTemplate e RootNodeStyle são usados em vez dos CurrentNodeTemplate ou CurrentNodeStyle.

O SiteMapPath controlo utiliza o fornecedor de mapas do local identificado pela SiteMapProvider propriedade como fonte de dados para a informação de navegação do local. Se não for especificado nenhum fornecedor, utiliza o fornecedor padrão do site, identificado na SiteMap.Provider propriedade. Normalmente, trata-se de uma instância do fornecedor padrão de mapas de sites para ASP.NET, o XmlSiteMapProvider. Se o SiteMapPath controlo for usado dentro de um local mas nenhum fornecedor de mapas de local estiver configurado, o controlo lança uma HttpException exceção.

Events

O SiteMapPath controlo também fornece eventos contra os quais pode programar. Isto permite-lhe executar uma rotina personalizada sempre que ocorre um evento. A tabela seguinte lista os eventos suportados pelo SiteMapPath controlo.

Event	Description
ItemCreated	Ocorre quando o controlo SiteMapPath cria primeiro um SiteMapNodeItem e o associa a um SiteMapNode.
ItemDataBound	Ocorre quando a SiteMapNodeItem está ligado a dados de mapa de sítios contidos por .SiteMapNode

Personalização do Controlo SiteMapPath

As classes que derivam de SiteMapPath sobrepõem o InitializeItem método para personalizar os SiteMapNodeItem controlos contidos pelo controlo de navegação. Para controlo total sobre a forma como SiteMapNodeItem os objetos são criados e adicionados aos SiteMapPath, as classes derivadas sobrepõem-se ao CreateControlHierarchy método.

Accessibility

Para informações sobre como configurar este controlo de modo a gerar marcação que cumpra os padrões de acessibilidade, consulte Acessibilidade em Visual Studio e ASP.NET e ASP.NET Controlos e Acessibilidade.

Sintaxe declarativa

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

Construtores

Name	Description
SiteMapPath()	Inicializa uma nova instância da SiteMapPath classe.

Propriedades

Name	Description
AccessKey	Obtém ou define a chave de acesso que permite navegar rapidamente até ao controlo do servidor Web. (Herdado de WebControl)
Adapter	Recebe o adaptador específico do navegador para o controlo. (Herdado de Control)
AppRelativeTemplateSourceDirectory	Obtém ou define o diretório virtual relativo à aplicação do Page objeto ou UserControl que contém este controlo. (Herdado de Control)
Attributes	Obtém a coleção de atributos arbitrários (apenas para renderização) que não correspondem a propriedades no controlo. (Herdado de WebControl)
BackColor	Obtém ou define a cor de fundo do controlo do servidor Web. (Herdado de WebControl)
BindingContainer	Obtém o controlo que contém a ligação de dados desse controlo. (Herdado de Control)
BorderColor	Obtém ou define a cor da borda do controlo Web. (Herdado de WebControl)
BorderStyle	Obtém ou define o estilo de borda do controlo do servidor Web. (Herdado de WebControl)
BorderWidth	Obtém ou define a largura da fronteira do controlo do servidor Web. (Herdado de WebControl)
ChildControlsCreated	Recebe um valor que indica se os controlos filhos do controlo do servidor foram criados. (Herdado de Control)
ClientID	Obtém o ID de controlo para a marcação HTML gerada pelo ASP.NET. (Herdado de Control)
ClientIDMode	Obtém ou define o algoritmo que é usado para gerar o valor da ClientID propriedade. (Herdado de Control)
ClientIDSeparator	Obtém um valor de carácter que representa o carácter separador usado na ClientID propriedade. (Herdado de Control)
Context	Obtém o controlo do HttpContext objeto associado ao servidor para o pedido Web atual. (Herdado de Control)
Controls	Obtém um ControlCollection objeto que representa os controlos filhos num CompositeControl. (Herdado de CompositeControl)
ControlStyle	Recebe o estilo do controlo do servidor Web. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl)
ControlStyleCreated	Recebe um valor que indica se um Style objeto foi criado para a ControlStyle propriedade. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl)
CssClass	Obtém ou define a classe Cascading Style Sheet (CSS) renderizada pelo controlo do servidor Web no cliente. (Herdado de WebControl)
CurrentNodeStyle	Obtém o estilo usado para o texto de exibição do nó atual.
CurrentNodeTemplate	Obtém ou define um modelo de controlo para usar no nó de um caminho de navegação do site que representa a página atualmente apresentada.
DataItemContainer	Obtém uma referência ao contentor de nomes se o contentor implementar IDataItemContainer. (Herdado de Control)
DataKeysContainer	Obtém uma referência ao contentor de nomes se o contentor implementar IDataKeysControl. (Herdado de Control)
DesignMode	Obtém um valor que indica se um controlo está a ser usado numa superfície de projeto. (Herdado de Control)
Enabled	Recebe ou define um valor que indica se o controlo do servidor Web está ativado. (Herdado de WebControl)
EnableTheming	Recebe ou define um valor que indica se os temas se aplicam a este controlo. (Herdado de WebControl)
EnableViewState	Recebe ou define um valor que indica se o controlo do servidor mantém o seu estado de visualização, e o estado de vista de quaisquer controlos filhos que contém, para o cliente solicitante. (Herdado de Control)
Events	Obtém uma lista de delegados handler de eventos para o controlo. Esta propriedade é somente leitura. (Herdado de Control)
Font	Obtém as propriedades da fonte associadas ao controlo do servidor Web. (Herdado de WebControl)
ForeColor	Obtém ou define a cor do primeiro plano (tipicamente a cor do texto) do controlo do servidor Web. (Herdado de WebControl)
HasAttributes	Recebe um valor que indica se o controlo tem atributos definidos. (Herdado de WebControl)
HasChildViewState	Recebe um valor que indica se os controlos filhos do controlo atual do servidor têm alguma configuração de estado de visualização guardada. (Herdado de Control)
Height	Obtém ou define a altura do controlo do servidor Web. (Herdado de WebControl)
ID	Obtém ou define o identificador programático atribuído ao controlo do servidor. (Herdado de Control)
IdSeparator	Faz com que o carácter seja usado para separar identificadores de controlo. (Herdado de Control)
IsChildControlStateCleared	Obtém um valor que indica se os controlos contidos neste controlo têm estado de controlo. (Herdado de Control)
IsEnabled	Recebe um valor que indica se o controlo está ativado. (Herdado de WebControl)
IsTrackingViewState	Recebe um valor que indica se o controlo do servidor está a guardar alterações ao estado de visualização. (Herdado de Control)
IsViewStateEnabled	Recebe um valor que indica se o estado de visualização está ativado para este controlo. (Herdado de Control)
LoadViewStateByID	Recebe um valor que indica se o controlo participa no carregamento do seu estado de visualização em ID vez de index. (Herdado de Control)
NamingContainer	Obtém uma referência ao contentor de nomes do controlo do servidor, que cria um namespace único para diferenciar controlos de servidor com o mesmo ID valor de propriedade. (Herdado de Control)
NodeStyle	Obtém o estilo usado para o texto de exibição de todos os nós no caminho de navegação do site.
NodeTemplate	Obtém ou define um modelo de controlo para usar em todos os nós funcionais do caminho de navegação de um local.
Page	Obtém uma referência à Page instância que contém o controlo do servidor. (Herdado de Control)
Parent	Obtém uma referência ao controlo pai do controlo do servidor na hierarquia de controlo de página. (Herdado de Control)
ParentLevelsDisplayed	Obtém ou define o número de níveis de nós pais que o controlo apresenta, em relação ao nó atualmente apresentado.
PathDirection	Obtém ou define a ordem em que os nós do caminho de navegação são renderizados.
PathSeparator	Obtém ou define a cadeia que delimita SiteMapPath os nós no caminho de navegação renderizado.
PathSeparatorStyle	Obtém o estilo usado para a PathSeparator corda.
PathSeparatorTemplate	Obtém ou define um modelo de controlo para usar como delimitador de caminho de um caminho de navegação de local.
Provider	Obtém ou define um SiteMapProvider que está associado ao controlo do servidor Web.
RenderCurrentNodeAsLink	Indica se o nó de navegação do site que representa a página atualmente apresentada está renderizado como um hiperlink.
RenderingCompatibility	Recebe um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control)
RootNodeStyle	Obtém o estilo para o nó raiz do texto de exibição.
RootNodeTemplate	Obtém ou define um modelo de controlo para usar no nó raiz de um caminho de navegação de site.
ShowToolTips	Recebe ou define um valor que indica se o SiteMapPath controlo escreve um atributo adicional de hiperligação para nós de navegação hiperligados. Dependendo do suporte do cliente, quando um rato paira sobre um hiperlink que tem o conjunto adicional de atributos, é exibido um ToolTip.
Site	Obtém informação sobre o contentor que aloja o controlo atual quando renderizado numa superfície de design. (Herdado de Control)
SiteMapProvider	Obtém ou define o nome do SiteMapProvider usado para renderizar o controlo de navegação do local.
SkinID	Obtém ou fixa a pele para aplicar no controlo. (Herdado de WebControl)
SkipLinkText	Recebe ou define um valor que é usado para renderizar texto alternativo para que os leitores de ecrã saltem o conteúdo do controlo.
Style	Recebe uma coleção de atributos de texto que serão renderizados como um atributo de estilo na etiqueta externa do controlo do servidor Web. (Herdado de WebControl)
SupportsDisabledAttribute	Obtém um valor que indica se o controlo deve definir o `disabled` atributo do elemento HTML renderizado como "desabilitado" quando a propriedade do IsEnabled controlo é `false`. (Herdado de CompositeControl)
TabIndex	Obtém ou define o índice de tabulação do controlo do servidor Web. (Herdado de WebControl)
TagKey	Obtém o HtmlTextWriterTag valor correspondente a este controlo do servidor Web. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl)
TagName	Recebe o nome da etiqueta de controlo. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl)
TemplateControl	Recebe ou define uma referência ao template que contém esse controlo. (Herdado de Control)
TemplateSourceDirectory	Obtém o diretório virtual do Page ou UserControl que contém o controlo atual do servidor. (Herdado de Control)
ToolTip	Obtém ou define o texto exibido quando o ponteiro do rato paira sobre o controlo do servidor Web. (Herdado de WebControl)
UniqueID	Obtém o identificador único e hierarquicamente qualificado para o controlo do servidor. (Herdado de Control)
ValidateRequestMode	Recebe ou define um valor que indica se o controlo verifica a entrada do cliente do navegador para valores potencialmente perigosos. (Herdado de Control)
ViewState	Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um controlo de servidor através de múltiplos pedidos para a mesma página. (Herdado de Control)
ViewStateIgnoresCase	Obtém um valor que indica se o StateBag objeto é indistinto a maiúsculas e maiúsculas. (Herdado de Control)
ViewStateMode	Obtém ou define o modo view-state deste controlo. (Herdado de Control)
Visible	Recebe ou define um valor que indica se um controlo de servidor é renderizado como UI na página. (Herdado de Control)
Width	Obtém ou define a largura do controlo do servidor Web. (Herdado de WebControl)

Métodos

Name	Description
AddAttributesToRender(HtmlTextWriter)	Adiciona atributos e estilos HTML que precisam de ser renderizados para o especificado HtmlTextWriterTag. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
AddedControl(Control, Int32)	Chamado após um controlo filho ser adicionado à Controls coleção do Control objeto. (Herdado de Control)
AddParsedSubObject(Object)	Notifica o controlo do servidor que um elemento, seja XML ou HTML, foi analisado, e adiciona o elemento ao objeto do ControlCollection controlo do servidor. (Herdado de Control)
ApplyStyle(Style)	Copia quaisquer elementos não em branco do estilo especificado para o controlo Web, sobrescrevendo quaisquer elementos de estilo existentes do controlo. Este método é usado principalmente por desenvolvedores de controlo. (Herdado de WebControl)
ApplyStyleSheetSkin(Page)	Aplica as propriedades de estilo definidas na folha de estilo da página ao controlo. (Herdado de Control)
BeginRenderTracing(TextWriter, Object)	Inicia o rastreio em tempo de design dos dados de renderização. (Herdado de Control)
BuildProfileTree(String, Boolean)	Recolhe informações sobre o controlo do servidor e entrega-as à Trace propriedade para serem exibidas quando o rastreamento for ativado para a página. (Herdado de Control)
ClearCachedClientID()	Define o valor em ClientID cache para `null`. (Herdado de Control)
ClearChildControlState()	Apaga a informação de estado de controlo dos controlos filhos do controlo do servidor. (Herdado de Control)
ClearChildState()	Apaga a informação de view-state e control-state de todos os controlos filhos do servidor. (Herdado de Control)
ClearChildViewState()	Elimina a informação de estado de visualização de todos os controlos filhos do controlo do servidor. (Herdado de Control)
ClearEffectiveClientIDMode()	Define a ClientIDMode propriedade da instância de controlo atual e de qualquer controlo filho para Inherit. (Herdado de Control)
CopyBaseAttributes(WebControl)	Copia as propriedades não encapsuladas pelo Style objeto do controlo do servidor Web especificado para o controlo do servidor Web de onde este método é chamado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
CreateChildControls()	Limpa a coleção atual de controlos filhos e reconstrói-a chamando o CreateControlHierarchy() método.
CreateControlCollection()	Cria um novo ControlCollection objeto para armazenar os controlos filhos (tanto literais como de servidor) do controlo do servidor. (Herdado de Control)
CreateControlHierarchy()	Examina a estrutura do mapa do sítio fornecida pelo SiteMapProvider e constrói uma coleção de controlos filho baseada nos estilos e modelos definidos para os nós funcionais.
CreateControlStyle()	Cria o objeto de estilo que é usado internamente pela WebControl classe para implementar todas as propriedades relacionadas com o estilo. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
DataBind()	Liga uma fonte de dados ao SiteMapPath controlo e aos seus controlos filhos.
DataBind(Boolean)	Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos com uma opção para elevar o DataBinding evento. (Herdado de Control)
DataBindChildren()	Vincula uma fonte de dados aos controlos filhos do controlo do servidor. (Herdado de Control)
Dispose()	Permite que o controlo do servidor realize a limpeza final antes de ser libertado da memória. (Herdado de Control)
EndRenderTracing(TextWriter, Object)	Termina o rastreio de tempo de design dos dados de renderização. (Herdado de Control)
EnsureChildControls()	Determina se o controlo do servidor contém controlos filhos. Se não o fizer, cria controlos filhos. (Herdado de Control)
EnsureID()	Cria um identificador para controlos que não têm um identificador atribuído. (Herdado de Control)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FindControl(String, Int32)	Pesquisa no contentor de nomenclatura atual um controlo de servidor com o especificado `id` e um inteiro, especificados no `pathOffset` parâmetro, o que auxilia na pesquisa. Não deve sobrepor-se a esta versão do FindControl método. (Herdado de Control)
FindControl(String)	Procura no contentor de nomenclatura atual um controlo de servidor com o parâmetro especificado `id` . (Herdado de Control)
Focus()	Define o foco de entrada num controlo. (Herdado de Control)
GetDesignModeState()	Obtém dados de tempo de projeto para um controlo. (Herdado de Control)
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetRouteUrl(Object)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control)
GetRouteUrl(RouteValueDictionary)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control)
GetRouteUrl(String, Object)	Obtém o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)	Obtém o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetUniqueIDRelativeTo(Control)	Devolve a parte prefixada da UniqueID propriedade do controlo especificado. (Herdado de Control)
HasControls()	Determina se o controlo do servidor contém algum controlo filho. (Herdado de Control)
HasEvents()	Devolve um valor que indica se os eventos estão registados para o controlo ou para quaisquer controlos filhos. (Herdado de Control)
InitializeItem(SiteMapNodeItem)	Preenche um SiteMapNodeItem, que é um controlo de servidor Web que representa um SiteMapNode, com um conjunto de controlos filhos baseados na função do nó e nos modelos e estilos especificados para o nó.
IsLiteralContent()	Determina se o controlo do servidor contém apenas conteúdo literal. (Herdado de Control)
LoadControlState(Object)	Restaura a informação do estado de controlo a partir de um pedido de página anterior que foi guardado pelo SaveControlState() método. (Herdado de Control)
LoadViewState(Object)	Restaura a informação de estado de visualização de um pedido anterior que foi guardado com o SaveViewState() método.
MapPathSecure(String)	Recupera o caminho físico para o qual um caminho virtual, seja absoluto ou relativo, mapeia. (Herdado de Control)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
MergeStyle(Style)	Copia quaisquer elementos não em branco do estilo especificado para o controlo Web, mas não sobrescreve quaisquer elementos de estilo existentes do controlo. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
OnBubbleEvent(Object, EventArgs)	Determina se o evento para o controlo do servidor é passado para a hierarquia de controlo do servidor UI da página. (Herdado de Control)
OnDataBinding(EventArgs)	Sobrepõe-se ao OnDataBinding(EventArgs) método da CompositeControl classe e eleva o DataBinding evento.
OnInit(EventArgs)	Eleva o Init evento. (Herdado de Control)
OnItemCreated(SiteMapNodeItemEventArgs)	Aumenta o ItemCreated evento do SiteMapPath controlo.
OnItemDataBound(SiteMapNodeItemEventArgs)	Aumenta o ItemDataBound evento do SiteMapPath controlo.
OnLoad(EventArgs)	Eleva o Load evento. (Herdado de Control)
OnPreRender(EventArgs)	Eleva o PreRender evento. (Herdado de Control)
OnUnload(EventArgs)	Eleva o Unload evento. (Herdado de Control)
OpenFile(String)	Recebe um Stream usado para ler um ficheiro. (Herdado de Control)
RaiseBubbleEvent(Object, EventArgs)	Atribui quaisquer fontes do evento e da sua informação ao pai do controlo. (Herdado de Control)
RecreateChildControls()	Recria o filho controla num controlo derivado de CompositeControl. (Herdado de CompositeControl)
RemovedControl(Control)	Chamado após um controlo filho ser removido da Controls coleção do Control objeto. (Herdado de Control)
Render(HtmlTextWriter)	Escreve o CompositeControl conteúdo para o objeto especificado HtmlTextWriter , para exibição no cliente.
RenderBeginTag(HtmlTextWriter)	Renderiza a etiqueta de abertura HTML do controlo ao escritor especificado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
RenderChildren(HtmlTextWriter)	Exporta o conteúdo dos filhos de um controlo de servidor para um objeto fornecido HtmlTextWriter , que escreve o conteúdo a ser renderizado no cliente. (Herdado de Control)
RenderContents(HtmlTextWriter)	Renderiza os nós no SiteMapPath controlo.
RenderControl(HtmlTextWriter, ControlAdapter)	Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter . (Herdado de Control)
RenderControl(HtmlTextWriter)	Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter e armazena informação de rastreamento sobre o controlo se o rastreio estiver ativado. (Herdado de Control)
RenderEndTag(HtmlTextWriter)	Renderiza a etiqueta HTML de fecho do controlo no escritor especificado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
ResolveAdapter()	Faz com que o adaptador de controlo seja responsável por renderizar o controlo especificado. (Herdado de Control)
ResolveClientUrl(String)	Recebe um URL que pode ser usado pelo navegador. (Herdado de Control)
ResolveUrl(String)	Converte uma URL numa que seja utilizável no cliente solicitante. (Herdado de Control)
SaveControlState()	Guarda quaisquer alterações no estado de controlo do servidor que tenham ocorrido desde que a página foi publicada de volta no servidor. (Herdado de Control)
SaveViewState()	Guarda as alterações ao estado de visualização do SiteMapPath controlo.
SetDesignModeState(IDictionary)	Define dados em tempo de projeto para um controlo. (Herdado de Control)
SetRenderMethodDelegate(RenderMethod)	Atribui um delegado handler de eventos para renderizar o controlo do servidor e o seu conteúdo no controlo pai. (Herdado de Control)
SetTraceData(Object, Object, Object)	Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando o objeto rastreado, a chave de dados de traço e o valor dos dados de traço. (Herdado de Control)
SetTraceData(Object, Object)	Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando a chave de dados de traço e o valor dos dados de traço. (Herdado de Control)
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)
TrackViewState()	Regista alterações no SiteMapPath estado de visão do controlo.

evento

Name	Description
DataBinding	Ocorre quando o controlo do servidor se liga a uma fonte de dados. (Herdado de Control)
Disposed	Ocorre quando um controlo de servidor é libertado da memória, que é a última etapa do ciclo de vida do controlo do servidor quando uma página ASP.NET é solicitada. (Herdado de Control)
Init	Ocorre quando o controlo do servidor é inicializado, que é o primeiro passo no seu ciclo de vida. (Herdado de Control)
ItemCreated	Ocorre quando um SiteMapNodeItem é criado pelo SiteMapPath e está associado ao seu correspondente SiteMapNode. Este evento é elevado pelo OnItemCreated(SiteMapNodeItemEventArgs) método.
ItemDataBound	Ocorre depois de um SiteMapNodeItem ter sido ligado aos seus dados subjacentes SiteMapNode pelo SiteMapPath. Este evento é elevado pelo OnItemDataBound(SiteMapNodeItemEventArgs) método.
Load	Ocorre quando o controlo do servidor é carregado no Page objeto. (Herdado de Control)
PreRender	Ocorre depois do carregamento do Control objeto, mas antes da renderização. (Herdado de Control)
Unload	Ocorre quando o controlo do servidor é descarregado da memória. (Herdado de Control)

Implementações de Interface Explícita

Name	Description
IAttributeAccessor.GetAttribute(String)	Recebe um atributo do controlo Web com o nome especificado. (Herdado de WebControl)
IAttributeAccessor.SetAttribute(String, String)	Define um atributo do controlo Web ao nome e valor especificados. (Herdado de WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()	Permite ao designer recriar a coleção de controlos filhos do controlo composto no ambiente de design-time. (Herdado de CompositeControl)
IControlBuilderAccessor.ControlBuilder	Para uma descrição deste elemento, veja ControlBuilder. (Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()	Para uma descrição deste elemento, veja GetDesignModeState(). (Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para uma descrição deste elemento, veja SetDesignModeState(IDictionary). (Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Para uma descrição deste elemento, veja SetOwnerControl(Control). (Herdado de Control)
IControlDesignerAccessor.UserData	Para uma descrição deste elemento, veja UserData. (Herdado de Control)
IDataBindingsAccessor.DataBindings	Para uma descrição deste elemento, veja DataBindings. (Herdado de Control)
IDataBindingsAccessor.HasDataBindings	Para uma descrição deste elemento, veja HasDataBindings. (Herdado de Control)
IExpressionsAccessor.Expressions	Para uma descrição deste elemento, veja Expressions. (Herdado de Control)
IExpressionsAccessor.HasExpressions	Para uma descrição deste elemento, veja HasExpressions. (Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)	Para uma descrição deste elemento, veja AddParsedSubObject(Object). (Herdado de Control)

Métodos da Extensão

Name	Description
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado.
EnableDynamicData(INamingContainer, Type, Object)	Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado.
EnableDynamicData(INamingContainer, Type)	Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado.
FindDataSourceControl(Control)	Devolve a fonte de dados associada ao controlo de dados para o controlo especificado.
FindFieldTemplate(Control, String)	Devolve o modelo de campo para a coluna especificada no contentor de nomenclatura do controlo especificado.
FindMetaTable(Control)	Devolve o objeto metatable para o controlo de dados que contém.
GetDefaultValues(INamingContainer)	Obtém a recolha dos valores padrão para o controlo de dados especificado.
GetMetaTable(INamingContainer)	Obtém os metadados da tabela para o controlo de dados especificado.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Define os metadados da tabela e o mapeamento de valores padrão para o controlo de dados especificado.
SetMetaTable(INamingContainer, MetaTable, Object)	Define os metadados da tabela e o mapeamento de valores padrão para o controlo de dados especificado.
SetMetaTable(INamingContainer, MetaTable)	Define os metadados da tabela para o controlo de dados especificado.
TryGetMetaTable(INamingContainer, MetaTable)	Determina se os metadados da tabela estão disponíveis.

Aplica-se a

Ver também

Comentários

Esta página foi útil?