DataViewHierarchyAccessor.SetNodePath - метод
Задает путь узла для узла, заданного указанным идентификатором элемента
Пространство имен: 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
)
Параметры
itemId
Тип: Int32Идентификатор элемента.
nodePath
Тип: StringНовый путь узла для узла.
Исключения
Исключение | Условие |
---|---|
ArgumentNullException | Параметр nodePath имеет значение null. |
ArgumentException | Указанный itemID недопустимо. |
Заметки
Этот метод очень средства, поскольку он позволяет записывать в контекст или переместить любой узел в иерархии представления данных. Он должен использоваться в 2 различных сценариях.
Первое, если создать новый объект. Сначала вызывает метод CreateObjectNode поставщика данных для создания contextless идентификатор элемента, который можно использовать при создании нового объекта. Когда этот объект будет сохранять поставщик данных будет потребоваться добавить этот элемент в дерево иерархии. Это достигается путем вызова метода SetNodePath и предоставление правильный путь узла местоположение нового узла.
Второй сценарий имеет место, когда изменяется объект и должен быть передислоцирован в другой части иерархии. Опять же, если объект сохранить с обновленными свойствами, поставщик данных должен вызвать метод SetNodePath для перемещения узла в новое местоположение.
Безопасность платформы .NET Framework
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Для получения дополнительной информации см. Использование библиотек из не вполне надежного кода.