Share via

HierarchyInfo.Navigate Method

  • Reference

Definition

Namespace:
Microsoft.Web.Management.Client
Assembly:
Microsoft.Web.Management.dll

Navigates IIS Manager to the specified page.

Overloads

Navigate(Type)

Navigates the IIS Manager Connections pane to the specified page.
Navigate(Type, Object)

Navigates the IIS Manager Connections pane to the specified page.

Navigate(Type)

Navigates the IIS Manager Connections pane to the specified page.

protected:
 bool Navigate(Type ^ pageType);
protected bool Navigate (Type pageType);
member this.Navigate : Type -> bool
Protected Function Navigate (pageType As Type) As Boolean

Parameters

pageType
Type

The target node type.

Returns

Boolean

true if the navigation was successful; otherwise, false.

Examples

The following example navigates to the Administrators page.

bool NavB()
{

    Type pageType;
    string sFull = getStrPageType("Microsoft.Web.Management,",
                    "Microsoft.Web.Management.Features.Administrators.AdministratorsPage, ");

    if (sFull != string.Empty)
    {
        pageType = Type.GetType(sFull);
        return Navigate(pageType);
    }

    return false;
}

Remarks

Navigation will fail if the specified node type cannot be found or the user cancels the navigation. Navigation from arbitrary locations in the Connections pane to specific page types is not always successful. For example, if the Sites\Default Web Site\aspnet_client folder is selected in the Connections pane and you navigate to the Administrators page from a node under the local server, the Navigate method will not successfully change the selected node to one that supports the Administrators page.

Applies to

Navigate(Type, Object)

Navigates the IIS Manager Connections pane to the specified page.

protected:
 bool Navigate(Type ^ pageType, System::Object ^ navigationData);
protected bool Navigate (Type pageType, object navigationData);
member this.Navigate : Type * obj -> bool
Protected Function Navigate (pageType As Type, navigationData As Object) As Boolean

Parameters

pageType
Type

The target node type.

navigationData
Object

Navigation data.

Returns

Boolean

true if the navigation was successful; otherwise, false.

Examples

The following example calls the Navigate method. If the Object parameter is not null, obj is passed to Navigate.

public bool NavData(Type T, Object obj)
{

    if (obj is JournaledFile)
        return Navigate(T, obj);
    else
        return Navigate(T, null);
}

Remarks

Navigation will fail if the node type specified cannot be found or the user cancels the navigation. Navigation from arbitrary locations in the Connections pane to specific page types is not always successful. For example, if the Sites\Default Web Site\aspnet_client folder is selected in the Connections pane and you navigate to the Administrators page from a node under the local server, the Navigate method will not successfully change the selected node to one that supports the Administrators page.

Applies to