DataViewHierarchyAccessor.SetNodePath (Método)
Establece la ruta del nodo para un nodo identificado por un identificador de elemento determinada
Espacio de nombres: Microsoft.VisualStudio.Data
Ensamblado: Microsoft.VisualStudio.Data (en Microsoft.VisualStudio.Data.dll)
Sintaxis
'Declaración
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
itemId
Tipo: Int32Un Id. de elemento.
nodePath
Tipo: StringLa nueva ruta de nodo para el nodo.
Excepciones
| Excepción | Condición |
|---|---|
| ArgumentNullException | El parámetro nodePath es null. |
| ArgumentException | El itemID especificado no es válido. |
Comentarios
Este método es muy eficaz en que permite contextualize o que cambie cualquier nodo de la jerarquía de la vista de datos. Se utiliza en dos escenarios diferentes.
El primero es cuando se crea un nuevo objeto. Llamadas de un proveedor de datos primero al método de CreateObjectNode para generar un Id. de elemento contextless que puede utilizar cuando diseña el nuevo objeto. Cuando se guarda este objeto, el proveedor de datos que desee agregar este elemento al árbol de jerarquía. Esto se logra llamando al método de SetNodePath y proporcionando la ruta de acceso correcta del nodo a la ubicación del nuevo nodo.
El segundo escenario aparece cuando el objeto se modifica y se debe reubicar una parte diferente de la jerarquía. Una vez más cuando el objeto se guarda con propiedades actualizadas, el proveedor de datos debe llamar al método de SetNodePath para mover el nodo a la nueva ubicación.
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.