Share via


SiteMapPath Kelas

Definisi

Menampilkan sekumpulan hyperlink teks atau gambar yang memungkinkan pengguna menavigasi situs Web dengan lebih mudah, sambil mengambil ruang halaman dalam jumlah minimal.

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
Warisan

Contoh

Contoh kode berikut menggunakan SiteMapPath kontrol secara deklaratif di halaman Formulir Web. Contoh ini menunjukkan beberapa aturan prioritas yang mengatur urutan templat dan gaya mana yang diterapkan ke SiteMapPath simpul.

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

Contoh sebelumnya menggunakan penyedia peta situs default dan file Web.sitemap dengan struktur berikut.

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

Contoh kode berikut menunjukkan perluasan SiteMapPath kontrol dan menambahkan fungsionalitas baru ke dalamnya dengan mengambil InitializeItem alih metode . Kontrol DropDownSiteMapPath menambahkan DropDownList setelah simpul saat ini, untuk mengaktifkan navigasi mudah ke halaman yang merupakan simpul anak dari halaman saat ini. Contoh ini menunjukkan cara bekerja dengan SiteMapNodeItem objek, termasuk memeriksa dan SiteMapNodeItemType memanggil OnItemCreated metode setelah item dibuat.

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

Keterangan

Dalam topik ini:

Pengantar

Kontrol SiteMapPath adalah kontrol navigasi situs yang mencerminkan data yang disediakan oleh SiteMap objek. Ini menyediakan cara penghematan ruang untuk dengan mudah menavigasi situs dan berfungsi sebagai titik referensi di mana halaman yang saat ini ditampilkan berada dalam situs. Jenis kontrol ini biasanya disebut breadcrumb, atau alis, karena menampilkan jalur hierarkis nama halaman hyperlink yang menyediakan escape hierarki halaman dari lokasi saat ini. SiteMapDataSource. SiteMapPath berguna untuk situs yang memiliki struktur halaman hierarkis mendalam, tetapi di mana TreeView atau Menu mungkin membutuhkan terlalu banyak ruang di halaman.

Kontrol bekerja SiteMapPath langsung dengan data peta situs situs Web Anda. Jika Anda menggunakannya pada halaman yang tidak diwakili di peta situs Anda, itu tidak akan ditampilkan. Untuk informasi selengkapnya tentang peta situs, lihat ASP.NET Navigasi Situs.

Node

SiteMapPath Terdiri dari simpul. Setiap elemen dalam jalur disebut simpul dan diwakili oleh SiteMapNodeItem objek . Simpul yang menjangkar jalur dan mewakili dasar pohon hierarkis disebut simpul akar. Simpul yang mewakili halaman yang saat ini ditampilkan adalah simpul saat ini. Simpul lain antara simpul saat ini dan simpul akar adalah simpul induk. Tabel berikut ini menjelaskan tiga jenis simpul yang berbeda.

Jenis Simpul Deskripsi
akar Simpul yang menjangkar sekumpulan simpul hierarkis.
induk Simpul yang memiliki satu atau beberapa simpul anak, tetapi bukan simpul saat ini.
saat ini Simpul yang mewakili halaman yang saat ini ditampilkan.

Tampilan Simpul

Setiap simpul yang SiteMapPath ditampilkan oleh adalah HyperLink kontrol atau Literal yang dapat Anda terapkan templat atau gayanya. Templat dan gaya diterapkan ke simpul sesuai dengan dua aturan prioritas:

  • Jika templat didefinisikan untuk simpul, templat akan menggantikan gaya apa pun yang ditentukan untuk simpul.

  • Templat dan gaya yang khusus untuk jenis simpul mengambil alih templat dan gaya umum yang ditentukan untuk semua simpul.

Properti NodeStyle dan NodeTemplate diterapkan ke semua simpul, terlepas dari jenis nodenya. Jika kedua properti ini didefinisikan, yang NodeTemplate diutamakan.

Properti CurrentNodeTemplate dan CurrentNodeStyle diterapkan ke simpul yang mewakili halaman yang saat ini ditampilkan. NodeTemplate Jika didefinisikan selain CurrentNodeTemplate, itu diabaikan. NodeStyle Jika didefinisikan selain CurrentNodeStyle, itu digabungkan dengan CurrentNodeStyle untuk membuat gaya gabungan. Gaya gabungan ini menggunakan semua elemen CurrentNodeStyle, ditambah elemen tambahan yang NodeStyle tidak bertentangan CurrentNodeStyledengan .

Properti RootNodeTemplate dan RootNodeStyle diterapkan ke simpul yang mewakili akar hierarki navigasi situs. NodeTemplate Jika didefinisikan selain RootNodeTemplate, itu diabaikan. NodeStyle Jika didefinisikan selain RootNodeStyle, itu digabungkan dengan RootNodeStyle untuk membuat gaya gabungan. Gaya gabungan ini menggunakan semua elemen RootNodeStyle, ditambah elemen tambahan yang NodeStyle tidak bertentangan CurrentNodeStyledengan . Terakhir, jika halaman yang ditampilkan saat ini adalah halaman akar situs, RootNodeTemplate dan RootNodeStyle digunakan alih-alih CurrentNodeTemplate atau CurrentNodeStyle.

SiteMapPath Kontrol menggunakan penyedia peta situs yang diidentifikasi oleh SiteMapProvider properti sebagai sumber datanya untuk informasi navigasi situs. Jika tidak ada penyedia yang ditentukan, ia menggunakan penyedia default untuk situs, yang diidentifikasi dalam SiteMap.Provider properti . Biasanya, ini adalah instans penyedia peta situs default untuk ASP.NET, XmlSiteMapProvider. SiteMapPath Jika kontrol digunakan dalam situs tetapi tidak ada penyedia peta situs yang dikonfigurasi, kontrol akan memberikan HttpException pengecualian.

Acara

Kontrol ini SiteMapPath juga menyediakan peristiwa yang dapat Anda programkan. Ini memungkinkan Anda menjalankan rutinitas kustom setiap kali peristiwa terjadi. Tabel berikut mencantumkan peristiwa yang didukung oleh SiteMapPath kontrol.

Kejadian Deskripsi
ItemCreated Terjadi ketika SiteMapPath kontrol pertama kali membuat SiteMapNodeItem dan mengaitkannya dengan SiteMapNode.
ItemDataBound Terjadi ketika SiteMapNodeItem terikat ke data peta situs yang dimuat SiteMapNodeoleh .

Mengkustomisasi Kontrol SiteMapPath

Kelas yang berasal dari SiteMapPath mengambil InitializeItem alih metode untuk menyesuaikan SiteMapNodeItem kontrol yang terkandung oleh kontrol navigasi. Untuk kontrol penuh atas cara SiteMapNodeItem objek dibuat dan ditambahkan ke SiteMapPath, kelas turunan mengambil CreateControlHierarchy alih metode .

Aksesibilitas

Untuk informasi tentang cara mengonfigurasi kontrol ini sehingga menghasilkan markup yang sesuai dengan standar aksesibilitas, lihat Aksesibilitas di Visual Studio dan ASP.NET serta Kontrol dan Aksesibilitas ASP.NET.

Sintaks Deklaratif

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

Konstruktor

SiteMapPath()

Menginisialisasi instans baru kelas SiteMapPath.

Properti

AccessKey

Mendapatkan atau mengatur kunci akses yang memungkinkan Anda menavigasi dengan cepat ke kontrol server Web.

(Diperoleh dari WebControl)
Adapter

Mendapatkan adaptor khusus browser untuk kontrol.

(Diperoleh dari Control)
AppRelativeTemplateSourceDirectory

Mendapatkan atau mengatur direktori virtual relatif aplikasi dari Page objek atau UserControl yang berisi kontrol ini.

(Diperoleh dari Control)
Attributes

Mendapatkan kumpulan atribut arbitrer (hanya untuk penyajian) yang tidak sesuai dengan properti pada kontrol.

(Diperoleh dari WebControl)
BackColor

Mendapatkan atau mengatur warna latar belakang kontrol server Web.

(Diperoleh dari WebControl)
BindingContainer

Mendapatkan kontrol yang berisi pengikatan data kontrol ini.

(Diperoleh dari Control)
BorderColor

Mendapatkan atau mengatur warna batas kontrol Web.

(Diperoleh dari WebControl)
BorderStyle

Mendapatkan atau mengatur gaya batas kontrol server Web.

(Diperoleh dari WebControl)
BorderWidth

Mendapatkan atau mengatur lebar batas kontrol server Web.

(Diperoleh dari WebControl)
ChildControlsCreated

Mendapatkan nilai yang menunjukkan apakah kontrol anak kontrol server telah dibuat.

(Diperoleh dari Control)
ClientID

Mendapatkan ID kontrol untuk markup HTML yang dihasilkan oleh ASP.NET.

(Diperoleh dari Control)
ClientIDMode

Mendapatkan atau mengatur algoritma yang digunakan untuk menghasilkan nilai ClientID properti.

(Diperoleh dari Control)
ClientIDSeparator

Mendapatkan nilai karakter yang mewakili karakter pemisah yang digunakan dalam ClientID properti .

(Diperoleh dari Control)
Context

Mendapatkan objek yang HttpContext terkait dengan kontrol server untuk permintaan Web saat ini.

(Diperoleh dari Control)
Controls

ControlCollection Mendapatkan objek yang mewakili kontrol anak dalam CompositeControl.

(Diperoleh dari CompositeControl)
ControlStyle

Mendapatkan gaya kontrol server Web. Properti ini digunakan terutama oleh pengembang kontrol.

(Diperoleh dari WebControl)
ControlStyleCreated

Mendapatkan nilai yang menunjukkan apakah Style objek telah dibuat untuk ControlStyle properti . Properti ini terutama digunakan oleh pengembang kontrol.

(Diperoleh dari WebControl)
CssClass

Mendapatkan atau mengatur kelas Cascading Style Sheet (CSS) yang dirender oleh kontrol server Web pada klien.

(Diperoleh dari WebControl)
CurrentNodeStyle

Mendapatkan gaya yang digunakan untuk teks tampilan untuk simpul saat ini.

CurrentNodeTemplate

Mendapatkan atau mengatur templat kontrol yang akan digunakan untuk simpul jalur navigasi situs yang mewakili halaman yang saat ini ditampilkan.

DataItemContainer

Mendapatkan referensi ke kontainer penamaan jika kontainer penamaan mengimplementasikan IDataItemContainer.

(Diperoleh dari Control)
DataKeysContainer

Mendapatkan referensi ke kontainer penamaan jika kontainer penamaan mengimplementasikan IDataKeysControl.

(Diperoleh dari Control)
DesignMode

Mendapatkan nilai yang menunjukkan apakah kontrol sedang digunakan pada permukaan desain.

(Diperoleh dari Control)
Enabled

Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol server Web diaktifkan.

(Diperoleh dari WebControl)
EnableTheming

Mendapatkan atau menetapkan nilai yang menunjukkan apakah tema berlaku untuk kontrol ini.

(Diperoleh dari WebControl)
EnableViewState

Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol server mempertahankan status tampilannya, dan status tampilan setiap kontrol anak yang dikandungnya, ke klien yang meminta.

(Diperoleh dari Control)
Events

Mendapatkan daftar delegasi penanganan aktivitas untuk kontrol. Properti ini bersifat hanya baca.

(Diperoleh dari Control)
Font

Mendapatkan properti font yang terkait dengan kontrol server Web.

(Diperoleh dari WebControl)
ForeColor

Mendapatkan atau mengatur warna latar depan (biasanya warna teks) kontrol server Web.

(Diperoleh dari WebControl)
HasAttributes

Mendapatkan nilai yang menunjukkan apakah kontrol memiliki atribut yang ditetapkan.

(Diperoleh dari WebControl)
HasChildViewState

Mendapatkan nilai yang menunjukkan apakah kontrol anak kontrol server saat ini memiliki pengaturan status tampilan yang disimpan.

(Diperoleh dari Control)
Height

Mendapatkan atau mengatur tinggi kontrol server Web.

(Diperoleh dari WebControl)
ID

Mendapatkan atau mengatur pengidentifikasi terprogram yang ditetapkan ke kontrol server.

(Diperoleh dari Control)
IdSeparator

Mendapatkan karakter yang digunakan untuk memisahkan pengidentifikasi kontrol.

(Diperoleh dari Control)
IsChildControlStateCleared

Mendapatkan nilai yang menunjukkan apakah kontrol yang terkandung dalam kontrol ini memiliki status kontrol.

(Diperoleh dari Control)
IsEnabled

Mendapatkan nilai yang menunjukkan apakah kontrol diaktifkan.

(Diperoleh dari WebControl)
IsTrackingViewState

Mendapatkan nilai yang menunjukkan apakah kontrol server menyimpan perubahan pada status tampilannya.

(Diperoleh dari Control)
IsViewStateEnabled

Mendapatkan nilai yang menunjukkan apakah status tampilan diaktifkan untuk kontrol ini.

(Diperoleh dari Control)
LoadViewStateByID

Mendapatkan nilai yang menunjukkan apakah kontrol berpartisipasi dalam memuat status tampilannya dengan ID bukan indeks.

(Diperoleh dari Control)
NamingContainer

Mendapatkan referensi ke kontainer penamaan kontrol server, yang membuat namespace unik untuk membedakan antara kontrol server dengan nilai properti yang sama ID .

(Diperoleh dari Control)
NodeStyle

Mendapatkan gaya yang digunakan untuk teks tampilan untuk semua simpul di jalur navigasi situs.

NodeTemplate

Mendapatkan atau mengatur templat kontrol yang akan digunakan untuk semua simpul fungsional dari jalur navigasi situs.

Page

Mendapatkan referensi ke Page instans yang berisi kontrol server.

(Diperoleh dari Control)
Parent

Mendapatkan referensi ke kontrol induk kontrol server dalam hierarki kontrol halaman.

(Diperoleh dari Control)
ParentLevelsDisplayed

Mendapatkan atau mengatur jumlah tingkat simpul induk yang ditampilkan kontrol, relatif terhadap simpul yang ditampilkan saat ini.

PathDirection

Mendapatkan atau mengatur urutan simpul jalur navigasi dirender.

PathSeparator

Mendapatkan atau mengatur string yang memisahkan SiteMapPath simpul di jalur navigasi yang dirender.

PathSeparatorStyle

Mendapatkan gaya yang digunakan untuk PathSeparator string.

PathSeparatorTemplate

Mendapatkan atau mengatur templat kontrol yang akan digunakan untuk pemisah jalur jalur jalur navigasi situs.

Provider

Mendapatkan atau mengatur SiteMapProvider yang terkait dengan kontrol server Web.

RenderCurrentNodeAsLink

Menunjukkan apakah simpul navigasi situs yang mewakili halaman yang saat ini ditampilkan dirender sebagai hyperlink.

RenderingCompatibility

Mendapatkan nilai yang menentukan versi ASP.NET yang akan kompatibel dengan HTML yang dirender.

(Diperoleh dari Control)
RootNodeStyle

Mendapatkan gaya untuk teks tampilan simpul akar.

RootNodeTemplate

Mendapatkan atau mengatur templat kontrol yang akan digunakan untuk simpul akar jalur navigasi situs.

ShowToolTips

Mendapatkan atau mengatur nilai yang menunjukkan apakah SiteMapPath kontrol menulis atribut hyperlink tambahan untuk simpul navigasi hyperlink. Bergantung pada dukungan klien, saat mouse mengarahkan kursor ke hyperlink yang memiliki set atribut tambahan, TipsAlat ditampilkan.

Site

Mendapatkan informasi tentang kontainer yang menghosting kontrol saat ini saat dirender pada permukaan desain.

(Diperoleh dari Control)
SiteMapProvider

Mendapatkan atau mengatur nama yang SiteMapProvider digunakan untuk merender kontrol navigasi situs.

SkinID

Mendapatkan atau mengatur kulit untuk diterapkan ke kontrol.

(Diperoleh dari WebControl)
SkipLinkText

Mendapatkan atau mengatur nilai yang digunakan untuk merender teks alternatif bagi pembaca layar untuk melewati konten kontrol.

Style

Mendapatkan kumpulan atribut teks yang akan dirender sebagai atribut gaya pada tag luar kontrol server Web.

(Diperoleh dari WebControl)
SupportsDisabledAttribute

Mendapatkan nilai yang menunjukkan apakah kontrol harus mengatur disabled atribut elemen HTML yang dirender ke "dinonaktifkan" ketika properti kontrol IsEnabled adalah false.

(Diperoleh dari CompositeControl)
TabIndex

Mendapatkan atau mengatur indeks tab kontrol server Web.

(Diperoleh dari WebControl)
TagKey

HtmlTextWriterTag Mendapatkan nilai yang sesuai dengan kontrol server Web ini. Properti ini digunakan terutama oleh pengembang kontrol.

(Diperoleh dari WebControl)
TagName

Mendapatkan nama tag kontrol. Properti ini digunakan terutama oleh pengembang kontrol.

(Diperoleh dari WebControl)
TemplateControl

Mendapatkan atau mengatur referensi ke templat yang berisi kontrol ini.

(Diperoleh dari Control)
TemplateSourceDirectory

Mendapatkan direktori Page virtual atau UserControl yang berisi kontrol server saat ini.

(Diperoleh dari Control)
ToolTip

Mendapatkan atau mengatur teks yang ditampilkan saat penunjuk mouse mengarah ke kontrol server Web.

(Diperoleh dari WebControl)
UniqueID

Mendapatkan pengidentifikasi unik yang memenuhi syarat secara hierarkis untuk kontrol server.

(Diperoleh dari Control)
ValidateRequestMode

Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol memeriksa input klien dari browser untuk nilai yang berpotensi berbahaya.

(Diperoleh dari Control)
ViewState

Mendapatkan kamus informasi status yang memungkinkan Anda menyimpan dan memulihkan status tampilan kontrol server di beberapa permintaan untuk halaman yang sama.

(Diperoleh dari Control)
ViewStateIgnoresCase

Mendapatkan nilai yang menunjukkan apakah StateBag objek tidak peka huruf besar/kecil.

(Diperoleh dari Control)
ViewStateMode

Mendapatkan atau mengatur mode view-state kontrol ini.

(Diperoleh dari Control)
Visible

Mendapatkan atau mengatur nilai yang menunjukkan apakah kontrol server dirender sebagai UI di halaman.

(Diperoleh dari Control)
Width

Mendapatkan atau menyetel lebar kontrol server Web.

(Diperoleh dari WebControl)

Metode

AddAttributesToRender(HtmlTextWriter)

Menambahkan atribut dan gaya HTML yang perlu dirender ke yang ditentukan HtmlTextWriterTag. Metode ini digunakan terutama oleh pengembang kontrol.

(Diperoleh dari WebControl)
AddedControl(Control, Int32)

Dipanggil setelah kontrol anak ditambahkan ke Controls koleksi Control objek.

(Diperoleh dari Control)
AddParsedSubObject(Object)

Memberi tahu kontrol server bahwa elemen, baik XML atau HTML, diurai, dan menambahkan elemen ke objek kontrol ControlCollection server.

(Diperoleh dari Control)
ApplyStyle(Style)

Menyalin elemen tidak kosong dari gaya yang ditentukan ke kontrol Web, menimpa elemen gaya kontrol yang ada. Metode ini terutama digunakan oleh pengembang kontrol.

(Diperoleh dari WebControl)
ApplyStyleSheetSkin(Page)

Menerapkan properti gaya yang ditentukan dalam lembar gaya halaman ke kontrol.

(Diperoleh dari Control)
BeginRenderTracing(TextWriter, Object)

Memulai pelacakan waktu desain untuk merender data.

(Diperoleh dari Control)
BuildProfileTree(String, Boolean)

Mengumpulkan informasi tentang kontrol server dan mengirimkannya ke properti yang Trace akan ditampilkan saat pelacakan diaktifkan untuk halaman.

(Diperoleh dari Control)
ClearCachedClientID()

Mengatur nilai yang di-cache ClientID ke null.

(Diperoleh dari Control)
ClearChildControlState()

Menghapus informasi status-kontrol untuk kontrol anak kontrol server.

(Diperoleh dari Control)
ClearChildState()

Menghapus informasi status-tampilan dan status-kontrol untuk semua kontrol turunan kontrol server.

(Diperoleh dari Control)
ClearChildViewState()

Menghapus informasi status tampilan untuk semua kontrol anak kontrol server.

(Diperoleh dari Control)
ClearEffectiveClientIDMode()

Mengatur properti instans ClientIDMode kontrol saat ini dan kontrol turunan apa pun ke Inherit.

(Diperoleh dari Control)
CopyBaseAttributes(WebControl)

Menyalin properti yang tidak dienkapsulasi oleh Style objek dari kontrol server Web yang ditentukan ke kontrol server Web tempat metode ini dipanggil. Metode ini digunakan terutama oleh pengembang kontrol.

(Diperoleh dari WebControl)
CreateChildControls()

Menghapus kumpulan kontrol anak saat ini, dan membangunnya kembali dengan memanggil CreateControlHierarchy() metode .

CreateControlCollection()

Membuat objek baru ControlCollection untuk menahan kontrol anak (baik literal maupun server) dari kontrol server.

(Diperoleh dari Control)
CreateControlHierarchy()

Memeriksa struktur peta situs yang disediakan oleh SiteMapProvider dan membangun kumpulan kontrol anak berdasarkan gaya dan templat yang ditentukan untuk simpul fungsional.

CreateControlStyle()

Membuat objek gaya yang digunakan secara internal oleh WebControl kelas untuk mengimplementasikan semua properti terkait gaya. Metode ini digunakan terutama oleh pengembang kontrol.

(Diperoleh dari WebControl)
DataBind()

Mengikat sumber data ke SiteMapPath kontrol dan kontrol turunannya.

DataBind(Boolean)

Mengikat sumber data ke kontrol server yang dipanggil dan semua kontrol turunannya dengan opsi untuk menaikkan DataBinding peristiwa.

(Diperoleh dari Control)
DataBindChildren()

Mengikat sumber data ke kontrol anak kontrol server.

(Diperoleh dari Control)
Dispose()

Memungkinkan kontrol server untuk melakukan pembersihan akhir sebelum dilepaskan dari memori.

(Diperoleh dari Control)
EndRenderTracing(TextWriter, Object)

Mengakhiri pelacakan waktu desain penyajian data.

(Diperoleh dari Control)
EnsureChildControls()

Menentukan apakah kontrol server memuat kontrol turunan. Jika tidak, ia membuat kontrol anak.

(Diperoleh dari Control)
EnsureID()

Membuat pengidentifikasi untuk kontrol yang tidak memiliki pengidentifikasi yang ditetapkan.

(Diperoleh dari Control)
Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
FindControl(String)

Mencari kontainer penamaan saat ini untuk kontrol server dengan parameter yang ditentukan id .

(Diperoleh dari Control)
FindControl(String, Int32)

Mencari kontainer penamaan saat ini untuk kontrol server dengan bilangan bulat dan yang ditentukan id , yang ditentukan dalam pathOffset parameter , yang membantu dalam pencarian. Anda tidak boleh mengambil alih versi FindControl metode ini.

(Diperoleh dari Control)
Focus()

Mengatur fokus input ke kontrol.

(Diperoleh dari Control)
GetDesignModeState()

Mendapatkan data waktu desain untuk kontrol.

(Diperoleh dari Control)
GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetRouteUrl(Object)

Mendapatkan URL yang sesuai dengan sekumpulan parameter rute.

(Diperoleh dari Control)
GetRouteUrl(RouteValueDictionary)

Mendapatkan URL yang sesuai dengan sekumpulan parameter rute.

(Diperoleh dari Control)
GetRouteUrl(String, Object)

Mendapatkan URL yang sesuai dengan sekumpulan parameter rute dan nama rute.

(Diperoleh dari Control)
GetRouteUrl(String, RouteValueDictionary)

Mendapatkan URL yang sesuai dengan sekumpulan parameter rute dan nama rute.

(Diperoleh dari Control)
GetType()

Mendapatkan dari instans Type saat ini.

(Diperoleh dari Object)
GetUniqueIDRelativeTo(Control)

Mengembalikan bagian awalan dari UniqueID properti kontrol yang ditentukan.

(Diperoleh dari Control)
HasControls()

Menentukan apakah kontrol server berisi kontrol anak apa pun.

(Diperoleh dari Control)
HasEvents()

Mengembalikan nilai yang menunjukkan apakah peristiwa terdaftar untuk kontrol atau kontrol turunan apa pun.

(Diperoleh dari Control)
InitializeItem(SiteMapNodeItem)

Mengisi SiteMapNodeItem, yang merupakan kontrol server Web yang mewakili SiteMapNode, dengan sekumpulan kontrol anak berdasarkan fungsi simpul dan templat dan gaya yang ditentukan untuk simpul.

IsLiteralContent()

Menentukan apakah kontrol server hanya menyimpan konten harfiah.

(Diperoleh dari Control)
LoadControlState(Object)

Memulihkan informasi status kontrol dari permintaan halaman sebelumnya yang disimpan oleh SaveControlState() metode .

(Diperoleh dari Control)
LoadViewState(Object)

Memulihkan informasi status tampilan dari permintaan sebelumnya yang disimpan dengan SaveViewState() metode .

MapPathSecure(String)

Mengambil jalur fisik tempat jalur virtual, baik absolut atau relatif, dipetakan.

(Diperoleh dari Control)
MemberwiseClone()

Membuat salinan dangkal dari saat ini Object.

(Diperoleh dari Object)
MergeStyle(Style)

Menyalin elemen tidak kosong dari gaya yang ditentukan ke kontrol Web, tetapi tidak akan menimpa elemen gaya kontrol yang ada. Metode ini digunakan terutama oleh pengembang kontrol.

(Diperoleh dari WebControl)
OnBubbleEvent(Object, EventArgs)

Menentukan apakah peristiwa untuk kontrol server diteruskan ke hierarki kontrol server UI halaman.

(Diperoleh dari Control)
OnDataBinding(EventArgs)

Mengambil alih OnDataBinding(EventArgs) metode CompositeControl kelas dan meningkatkan DataBinding peristiwa.

OnInit(EventArgs)

Memunculkan kejadian Init.

(Diperoleh dari Control)
OnItemCreated(SiteMapNodeItemEventArgs)

Menaikkan ItemCreated peristiwa SiteMapPath kontrol.

OnItemDataBound(SiteMapNodeItemEventArgs)

Menaikkan ItemDataBound peristiwa SiteMapPath kontrol.

OnLoad(EventArgs)

Memunculkan kejadian Load.

(Diperoleh dari Control)
OnPreRender(EventArgs)

Memunculkan kejadian PreRender.

(Diperoleh dari Control)
OnUnload(EventArgs)

Memunculkan kejadian Unload.

(Diperoleh dari Control)
OpenFile(String)

Stream Terbiasa membaca file.

(Diperoleh dari Control)
RaiseBubbleEvent(Object, EventArgs)

Menetapkan sumber peristiwa apa pun dan informasinya ke induk kontrol.

(Diperoleh dari Control)
RecreateChildControls()

Membuat ulang kontrol anak dalam kontrol yang berasal dari CompositeControl.

(Diperoleh dari CompositeControl)
RemovedControl(Control)

Dipanggil setelah kontrol anak dihapus dari Controls koleksi Control objek.

(Diperoleh dari Control)
Render(HtmlTextWriter)

CompositeControl Menulis konten ke objek yang ditentukanHtmlTextWriter, untuk ditampilkan pada klien.

RenderBeginTag(HtmlTextWriter)

Merender tag pembuka HTML kontrol ke penulis yang ditentukan. Metode ini digunakan terutama oleh pengembang kontrol.

(Diperoleh dari WebControl)
RenderChildren(HtmlTextWriter)

Menghasilkan konten turunan kontrol server ke objek yang disediakan HtmlTextWriter , yang menulis konten yang akan dirender pada klien.

(Diperoleh dari Control)
RenderContents(HtmlTextWriter)

Merender simpul dalam SiteMapPath kontrol.

RenderControl(HtmlTextWriter)

Output konten kontrol server ke objek yang disediakan HtmlTextWriter dan menyimpan informasi pelacakan tentang kontrol jika pelacakan diaktifkan.

(Diperoleh dari Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Output konten kontrol server ke objek yang disediakan HtmlTextWriter menggunakan objek yang disediakan ControlAdapter .

(Diperoleh dari Control)
RenderEndTag(HtmlTextWriter)

Merender tag penutup HTML kontrol ke penulis yang ditentukan. Metode ini digunakan terutama oleh pengembang kontrol.

(Diperoleh dari WebControl)
ResolveAdapter()

Mendapatkan adaptor kontrol yang bertanggung jawab untuk merender kontrol yang ditentukan.

(Diperoleh dari Control)
ResolveClientUrl(String)

Mendapatkan URL yang dapat digunakan oleh browser.

(Diperoleh dari Control)
ResolveUrl(String)

Mengonversi URL menjadi URL yang dapat digunakan pada klien yang meminta.

(Diperoleh dari Control)
SaveControlState()

Menyimpan perubahan status kontrol server apa pun yang telah terjadi sejak halaman diposting kembali ke server.

(Diperoleh dari Control)
SaveViewState()

Menyimpan perubahan untuk melihat status kontrol SiteMapPath .

SetDesignModeState(IDictionary)

Mengatur data waktu desain untuk kontrol.

(Diperoleh dari Control)
SetRenderMethodDelegate(RenderMethod)

Menetapkan delegasi penanganan aktivitas untuk merender kontrol server dan kontennya ke dalam kontrol induknya.

(Diperoleh dari Control)
SetTraceData(Object, Object)

Mengatur data pelacakan untuk pelacakan waktu desain data penyajian, menggunakan kunci data pelacakan dan nilai data pelacakan.

(Diperoleh dari Control)
SetTraceData(Object, Object, Object)

Mengatur data pelacakan untuk pelacakan waktu desain data penyajian, menggunakan objek yang dilacak, kunci data pelacakan, dan nilai data pelacakan.

(Diperoleh dari Control)
ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)
TrackViewState()

Melacak perubahan pada SiteMapPath status tampilan kontrol.

Acara

DataBinding

Terjadi ketika kontrol server mengikat ke sumber data.

(Diperoleh dari Control)
Disposed

Terjadi ketika kontrol server dilepaskan dari memori, yang merupakan tahap terakhir dari siklus hidup kontrol server ketika halaman ASP.NET diminta.

(Diperoleh dari Control)
Init

Terjadi ketika kontrol server diinisialisasi, yang merupakan langkah pertama dalam siklus hidupnya.

(Diperoleh dari Control)
ItemCreated

Terjadi ketika SiteMapNodeItem dibuat oleh SiteMapPath dan dikaitkan dengan yang sesuai SiteMapNode. Kejadian ini diajukan oleh OnItemCreated(SiteMapNodeItemEventArgs) metode .

ItemDataBound

Terjadi setelah SiteMapNodeItem terikat ke data yang mendasar SiteMapNode oleh SiteMapPath. Kejadian ini diajukan oleh OnItemDataBound(SiteMapNodeItemEventArgs) metode .

Load

Terjadi ketika kontrol server dimuat ke Page dalam objek.

(Diperoleh dari Control)
PreRender

Terjadi setelah Control objek dimuat tetapi sebelum penyajian.

(Diperoleh dari Control)
Unload

Terjadi ketika kontrol server dibongkar dari memori.

(Diperoleh dari Control)

Implementasi Antarmuka Eksplisit

IAttributeAccessor.GetAttribute(String)

Mendapatkan atribut kontrol Web dengan nama yang ditentukan.

(Diperoleh dari WebControl)
IAttributeAccessor.SetAttribute(String, String)

Menyetel atribut kontrol Web ke nama dan nilai yang ditentukan.

(Diperoleh dari WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()

Memungkinkan perancang untuk membuat ulang kumpulan kontrol anak kontrol komposit di lingkungan waktu desain.

(Diperoleh dari CompositeControl)
IControlBuilderAccessor.ControlBuilder

Untuk deskripsi anggota ini, lihat ControlBuilder.

(Diperoleh dari Control)
IControlDesignerAccessor.GetDesignModeState()

Untuk deskripsi anggota ini, lihat GetDesignModeState().

(Diperoleh dari Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Untuk deskripsi anggota ini, lihat SetDesignModeState(IDictionary).

(Diperoleh dari Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Untuk deskripsi anggota ini, lihat SetOwnerControl(Control).

(Diperoleh dari Control)
IControlDesignerAccessor.UserData

Untuk deskripsi anggota ini, lihat UserData.

(Diperoleh dari Control)
IDataBindingsAccessor.DataBindings

Untuk deskripsi anggota ini, lihat DataBindings.

(Diperoleh dari Control)
IDataBindingsAccessor.HasDataBindings

Untuk deskripsi anggota ini, lihat HasDataBindings.

(Diperoleh dari Control)
IExpressionsAccessor.Expressions

Untuk deskripsi anggota ini, lihat Expressions.

(Diperoleh dari Control)
IExpressionsAccessor.HasExpressions

Untuk deskripsi anggota ini, lihat HasExpressions.

(Diperoleh dari Control)
IParserAccessor.AddParsedSubObject(Object)

Untuk deskripsi anggota ini, lihat AddParsedSubObject(Object).

(Diperoleh dari Control)

Metode Ekstensi

FindDataSourceControl(Control)

Mengembalikan sumber data yang terkait dengan kontrol data untuk kontrol yang ditentukan.

FindFieldTemplate(Control, String)

Mengembalikan templat bidang untuk kolom yang ditentukan dalam kontainer penamaan kontrol yang ditentukan.

FindMetaTable(Control)

Mengembalikan objek metatable untuk kontrol data yang berisi.

GetDefaultValues(INamingContainer)

Mendapatkan kumpulan nilai default untuk kontrol data yang ditentukan.

GetMetaTable(INamingContainer)

Mendapatkan metadata tabel untuk kontrol data yang ditentukan.

SetMetaTable(INamingContainer, MetaTable)

Mengatur metadata tabel untuk kontrol data yang ditentukan.

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

Mengatur metadata tabel dan pemetaan nilai default untuk kontrol data yang ditentukan.

SetMetaTable(INamingContainer, MetaTable, Object)

Mengatur metadata tabel dan pemetaan nilai default untuk kontrol data yang ditentukan.

TryGetMetaTable(INamingContainer, MetaTable)

Menentukan apakah metadata tabel tersedia.

EnableDynamicData(INamingContainer, Type)

Mengaktifkan perilaku Data Dinamis untuk kontrol data yang ditentukan.

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

Mengaktifkan perilaku Data Dinamis untuk kontrol data yang ditentukan.

EnableDynamicData(INamingContainer, Type, Object)

Mengaktifkan perilaku Data Dinamis untuk kontrol data yang ditentukan.

Berlaku untuk

Lihat juga