Partilhar via


Método DataViewHierarchyAccessor.SetNodePath

Defina o caminho do nó para um nó identificado por um ID de item específico

Namespace:  Microsoft.VisualStudio.Data
Assembly:  Microsoft.VisualStudio.Data (em Microsoft.VisualStudio.Data.dll)

Sintaxe

'Declaração
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
)

Parâmetros

Exceções

Exceção Condição
ArgumentNullException

O parâmetro de nodePath é zero.

ArgumentException

O itemID especificado não é válido.

Comentários

Este método é muito eficiente que permite que você contextualize ou realoque qualquer nó na hierarquia do modo de exibição de dados.Deve ser usado em dois cenários diferentes.

o primeiro é quando um novo objeto é criado.Chamadas de um provedor de dados primeiro o método de CreateObjectNode para gerar um ID de item contextless que pode ser usado para criar o novo objeto.Quando esse objeto é salvo, o provedor de dados desejará adicionar o item à árvore hierárquica.Isso é conseguido chamando o método de SetNodePath e fornecendo o caminho correto do nó para o local do novo nó.

O segundo situação ocorre quando o objeto está sendo alterado e deve ser realocou a um conjunto diferente da hierarquia.Além de isso, quando o objeto é com propriedades atualizados, o provedor de dados deve chamar o método de SetNodePath para mover o nó para o novo local.

Segurança do .NET Framework

Consulte também

Referência

DataViewHierarchyAccessor Classe

Namespace Microsoft.VisualStudio.Data