StaticSiteMapProvider.BuildSiteMap Method ()


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

When overridden in a derived class, loads the site map information from persistent storage and builds it in memory.

Namespace:   System.Web
Assembly:  System.Web (in System.Web.dll)

public abstract SiteMapNode BuildSiteMap()

Return Value

Type: System.Web.SiteMapNode

The root SiteMapNode of the site map navigation structure.

The BuildSiteMap method is the one abstract member of the StaticSiteMapProvider class. The BuildSiteMap method is called to load and build the site map node from persistent storage. When you implement the BuildSiteMap method, ensure that it is thread-safe, because multiple concurrent page requests can result indirectly in multiple calls to load site map information.

Notes to Inheritors:

When overriding the BuildSiteMap method in a derived class, be sure to normalize the URLs of SiteMapNode objects that you add to your site map provider, so that the FindSiteMapNode method can retrieve a site map node regardless of whether the URL for the site map node is supplied as an absolute virtual path or application relative path. Site map provider implementers using the AddNode method should normalize any URLs before storing SiteMapNode objects in the internal hash tables on behalf of the site map provider.

Security trimming behavior is included in the SiteMapProvider and StaticSiteMapProvider class implementations. However, for security trimming to function in derived classes, you must set the Roles property of any SiteMapNode objects that you create while building a site map provider when you override the BuildSiteMap method.


The BuildSiteMap method is called by the default implementation of the FindSiteMapNode, GetChildNodes, and GetParentNode methods. If you override the BuildSiteMap method in a derived class, ensure that it loads site map data only once and returns on subsequent calls.

The following code example demonstrates how to implement the BuildSiteMap method to retrieve data from a Microsoft Access database and build SiteMapNode objects that are added to the ChildNodes collection of the root site map node. Finally, the RootNode property is returned to the caller.

This code example is part of a larger example provided for the StaticSiteMapProvider class.

// Build an in-memory representation from persistent
// storage, and return the root node of the site map.
public override SiteMapNode BuildSiteMap() {

    // Since the SiteMap class is static, make sure that it is
    // not modified while the site map is built.
    lock(this) {

        // If there is no initialization, this method is being
        // called out of order.
        if (! IsInitialized) {
            throw new Exception("BuildSiteMap called incorrectly.");

        // If there is no root node, then there is no site map.
        if (null == rootNode) {
            // Start with a clean slate

            // Select the root node of the site map from Microsoft Access.
            int rootNodeId = -1;

            if (accessConnection.State == ConnectionState.Closed)
            OleDbCommand rootNodeCommand =
                new OleDbCommand("SELECT nodeid, url, name FROM SiteMap WHERE parentnodeid IS NULL",
            OleDbDataReader rootNodeReader = rootNodeCommand.ExecuteReader();

            if(rootNodeReader.HasRows) {
                rootNodeId = rootNodeReader.GetInt32(0);
                // Create a SiteMapNode that references the current StaticSiteMapProvider.
                rootNode   = new SiteMapNode(this,

            else return null;

            // Select the child nodes of the root node.
            OleDbCommand childNodesCommand =
                new OleDbCommand("SELECT nodeid, url, name FROM SiteMap WHERE parentnodeid = ?",
            OleDbParameter rootParam = new OleDbParameter("parentid", OleDbType.Integer);
            rootParam.Value = rootNodeId;

            OleDbDataReader childNodesReader = childNodesCommand.ExecuteReader();

            if (childNodesReader.HasRows) {

                SiteMapNode childNode = null;
                while(childNodesReader.Read()) {
                    childNode =  new SiteMapNode(this,

                    // Use the SiteMapNode AddNode method to add
                    // the SiteMapNode to the ChildNodes collection.
                    AddNode(childNode, rootNode);

        return rootNode;

.NET Framework
Available since 2.0
Return to top