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 無效。

這個方法非常強大因為它可讓您將或重新配置在資料檢視階層架構中的所有節點放在內容中。應使用兩個不同的案例。

第一個是建立新的物件。資料提供者會先呼叫產生可以，當設計新物件時的 contextless 項目 ID 的 CreateObjectNode 方法。當這個物件會保留，資料提供者會將此項目加入至階層架構樹狀目錄。這是透過呼叫 SetNodePath 方法並提供正確的路徑達到指定新節點的位置。

當修改物件，而且應該重新配置給這個層級時，的不同部分第二種情況發生。同樣地，當物件儲存，以更新屬性時，資料提供者應該呼叫方法 SetNodePath 移動到新的位置。