SiteMapPath.RootNodeTemplate プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

SiteMapPath.RootNodeTemplate プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

サイトナビゲーションパスのルートノードに使用するコントロールテンプレートを取得または設定します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

<TemplateContainerAttribute(GetType(SiteMapNodeItem))> _
Public Overridable Property
 RootNodeTemplate As ITemplate

Visual Basic (使用法)

Dim instance As SiteMapPath
Dim value As ITemplate

value = instance.RootNodeTemplate

instance.RootNodeTemplate = value

[TemplateContainerAttribute(typeof(SiteMapNodeItem))] 
public virtual ITemplate RootNodeTemplate { get;
 set; }

C++

[TemplateContainerAttribute(typeof(SiteMapNodeItem))] 
public:
virtual property ITemplate^ RootNodeTemplate {
    ITemplate^ get ();
    void set (ITemplate^ value);
}

/** @property */
public ITemplate get_RootNodeTemplate ()

/** @property */
public void set_RootNodeTemplate (ITemplate
 value)

JScript

public function get RootNodeTemplate
 () : ITemplate

public function set RootNodeTemplate
 (value : ITemplate)

プロパティ値
ナビゲーションパスのルートノードのカスタムコンテンツを表示する、InstantiateIn メソッドを実装した ITemplate オブジェクト。

解説

文字列の代わりに Image コントロールまたは Label などの他のコントロールをルートノードのユーザーインターフェイス要素として使用するには、RootNodeTemplate に ITemplate オブジェクトを設定します。

RootNodeTemplate プロパティを設定した場合、テンプレートは、表示されるルートナビゲーションノードテキストとそれに適用される RootNodeStyle の両方をオーバーライドします。また、現在表示されているページがルートノードの場合、テンプレートは CurrentNodeTemplate プロパティと CurrentNodeStyle プロパティもオーバーライドします。

RootNodeTemplate プロパティは宣言によって任意の Web サーバーコントロールに設定でき、ASP.NET インフラストラクチャが、必要な手順を実行して、Web サーバーコントロールを ITemplate としてラップします。ただし、Web サーバーコントロールは ITemplate インターフェイスを実装しません。このため、ITemplate プロパティをプログラムによって操作する場合は、テンプレートコードの ITemplate ラッパーを記述する必要があります。その後、RootNodeTemplate プロパティが ITemplate ラッパーのインスタンスに設定されます。

使用例

ITemplate インターフェイスを実装したクラスをプログラムによって定義して、Image コントロールをラップする方法を次のコード例に示します。その後、RootNodeTemplate にそのクラスのインスタンスが設定されます。

Visual Basic

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

    Private Sub Page_Load(sender As
 Object, e As EventArgs)
        ' Create the SiteMapPath control.
        Dim navpath As New
 SiteMapPath()

        ' Make the root node look unique.
        ' The Image that you can use in your Web page is an
        ' instance of the WebControls.Image class, not the
        ' Drawing.Image class.
        Dim rootNodeImage As New
 System.Web.UI.WebControls.Image()
        rootNodeImage.ImageUrl = "myimage.jpg"
        Dim rootNodeImageTemplate As New
 ImageTemplate()
        rootNodeImageTemplate.MyImage = rootNodeImage
        navpath.RootNodeTemplate = rootNodeImageTemplate

        ' Make the current node look unique.
        Dim currentNodeStyle As New
 Style()
        navpath.CurrentNodeStyle.ForeColor = System.Drawing.Color.AliceBlue
        navpath.CurrentNodeStyle.BackColor = System.Drawing.Color.Bisque

        ' Set the path separator to be something other
        ' than the default.
        navpath.PathSeparator = "::"

        PlaceHolder1.Controls.Add(navpath)
    End Sub ' Page_Load


    ' A simple Template class to wrap an image.
    Public Class ImageTemplate
      Implements ITemplate

        Private anImage As System.Web.UI.WebControls.Image
        Public Property MyImage As
 System.Web.UI.WebControls.Image
          Get
            return anImage
          End Get
          Set
            anImage = value
          End Set
        End Property ' MyImage

        Public Overridable Sub
 InstantiateIn(ByVal container As Control)
 Implements ITemplate.InstantiateIn
            container.Controls.Add(MyImage)
        End Sub ' InstantiateIn

    End Class ' ImageTemplate
</SCRIPT>

<HTML>
  <body MS_POSITIONING="GridLayout">
    <form id="Form1" method="post"
 runat="server">

      <asp:PlaceHolder id="PlaceHolder1" runat="server"></asp:PlaceHolder>

      <h1>About Our Company</h1>

      <p>Our company was founded in 1886.</p>

      <p>We use only the finest ingredients, organically grown fruits, and
      natural spices in our homemade pies. We use no artificial
 preservatives
      or coloring agents. We would not have
 it any other way!</p>

    </form>
  </body>
</HTML>

<%@ 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">
    private void Page_Load(object sender, System.EventArgs
 e)
    {
        // Create the SiteMapPath control.
        SiteMapPath navpath = new SiteMapPath();

        // Make the root node look unique.
        // The Image that you can use in your Web page is an
        // instance of the WebControls.Image class, not the
        // Drawing.Image class.
        System.Web.UI.WebControls.Image rootNodeImage =
            new System.Web.UI.WebControls.Image();
        rootNodeImage.ImageUrl = "myimage.jpg";
        ImageTemplate rootNodeImageTemplate = new ImageTemplate();
        rootNodeImageTemplate.MyImage = rootNodeImage;
        navpath.RootNodeTemplate = rootNodeImageTemplate;

        // Make the current node look unique.
        Style currentNodeStyle = new Style();
        navpath.CurrentNodeStyle.ForeColor = System.Drawing.Color.AliceBlue;
        navpath.CurrentNodeStyle.BackColor = System.Drawing.Color.Bisque;

        // Set the path separator to be something other
        // than the default.
        navpath.PathSeparator = "::";

        PlaceHolder1.Controls.Add(navpath);
    }


    // A simple Template class to wrap an image.
    public class ImageTemplate : ITemplate
    {
        private System.Web.UI.WebControls.Image myImage;
        public System.Web.UI.WebControls.Image MyImage
        {
            get
            {
                return myImage;
            }
            set
            {
                myImage = value;
            }
        }
        public void InstantiateIn(Control container)
        {
            container.Controls.Add(MyImage);
        }
    }
</SCRIPT>

<HTML>
  <body MS_POSITIONING="GridLayout">
    <form id="Form1" method="post" runat="server">

      <asp:PlaceHolder id="PlaceHolder1" runat="server"></asp:PlaceHolder>

      <h1>About Our Company</h1>

      <p>Our company was founded in 1886.</p>

      <p>We use only the finest ingredients, organically grown fruits, and
      natural spices in our homemade pies. We use no artificial
 preservatives
      or coloring agents. We would not have it any other way!</p>

    </form>
  </body>
</HTML>

<%@ Page language="VJ#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<SCRIPT runat="server">
    private void Page_Load(Object sender, System.EventArgs
 e)
    {
        // Create the SiteMapPath control.
        SiteMapPath navpath = new SiteMapPath();

        // Make the root node look unique.
        // The Image that you can use in your Web page is an
        // instance of the WebControls.Image class, not the
        // Drawing.Image class.
        System.Web.UI.WebControls.Image rootNodeImage = new System.Web.UI.WebControls.Image();

        rootNodeImage.set_ImageUrl("myimage.jpg");

        ImageTemplate rootNodeImageTemplate = new ImageTemplate();

        rootNodeImageTemplate.set_myImage(rootNodeImage);
        navpath.set_RootNodeTemplate(rootNodeImageTemplate);

        // Make the current node look unique.
        Style currentNodeStyle = new Style();

        navpath.get_CurrentNodeStyle().set_ForeColor(System.Drawing.Color.get_AliceBlue());
        navpath.get_CurrentNodeStyle().set_BackColor(System.Drawing.Color.get_Bisque());

        // Set the path separator to be something other
        // than the default.
        navpath.set_PathSeparator("---->");
        PlaceHolder1.get_Controls().Add(navpath);
    }


    // A simple Template class to wrap an image.
    public class ImageTemplate implements ITemplate
    {
        private System.Web.UI.WebControls.Image myImage;
        public System.Web.UI.WebControls.Image get_myImage()
        {
            return myImage;
        }


        public void set_myImage(System.Web.UI.WebControls.Image
 value)
        {
            myImage = value;
        }


        public void InstantiateIn(Control container)
        {
            container.get_Controls().Add(myImage);
        }
    }

</SCRIPT>

<HTML>
  <body MS_POSITIONING="GridLayout">
    <form id="Form1" method="post" runat="server">

      <asp:PlaceHolder id="PlaceHolder1" runat="server"></asp:PlaceHolder>

      <h1>About Our Company</h1>

      <p>Grandma Fanny founded our company in 1886.</p>

      <p>We use only the finest ingredients, organically grown fruits, and
      natural spices in our homemade pies. We use no artificial
 preservatives
      or coloring agents. Grandma Fanny would not have it any other way!</p>

    </form>
  </body>
</HTML>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SiteMapPath クラス
SiteMapPath メンバ
System.Web.UI.WebControls 名前空間
SiteMapPath.RootNodeStyle プロパティ
SiteMapPath.NodeTemplate プロパティ
その他の技術情報
ASP.NET サイトナビゲーション
SiteMapPath Web サーバーコントロールの概要

>> 「SiteMapPath.RootNodeTemplate プロパティ」を含む用語の索引
SiteMapPath.RootNodeTemplate プロパティのページへのリンク


	© 2024 Microsoft.All rights reserved.

SiteMapPath.RootNodeTemplate プロパティとは？ わかりやすく解説

SiteMapPath.RootNodeTemplate プロパティ

急上昇のことば

SiteMapPath.RootNodeTemplate プロパティとは？わかりやすく解説