DataViewHierarchyAccessor.SetNodePath 方法

设置特定项ID确定节点的节点路径

命名空间： Microsoft.VisualStudio.Data
程序集： Microsoft.VisualStudio.Data（在 Microsoft.VisualStudio.Data.dll 中）

语法

声明
Public Sub SetNodePath ( _
    itemId As Integer, _
    nodePath As String _
)

public void SetNodePath(
    int itemId,
    string nodePath
)

public:
void SetNodePath(
    int itemId, 
    String^ nodePath
)

member SetNodePath : 
        itemId:int * 
        nodePath:string -> unit

public function SetNodePath(
    itemId : int, 
    nodePath : String
)

异常	条件
ArgumentNullException	nodePath 参数为 null。
ArgumentException	指定的itemID无效。

此方法非常强大因为它允许您将或重新定位在数据视图层次结构中的所有节点放在上下文中。应使用两种不同的情形。

第一种方法是创建一个新对象。数据提供程序第一次调用 CreateObjectNode 方法生成，即可在设计新对象的某contextless项ID。当此对象保存，数据提供程序需要添加此项添加到层次结构树。这可以通过调用 SetNodePath 方法并提供正确的节点路径实现对新节点的位置。

当修改对象应重新定位到该层次结构时，的不同部分第二个种情况。同样，对象时，将保存在更新属性时，数据提供程序应调用 SetNodePath 方法将节点新位置。