DataViewHierarchyAccessor.SetNodePath, méthode
Définit le chemin d'accès du nœud d'un nœud identifié par un ID de point particulier
Espace de noms : Microsoft.VisualStudio.Data
Assembly : Microsoft.VisualStudio.Data (dans Microsoft.VisualStudio.Data.dll)
Syntaxe
'Déclaration
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
)
Paramètres
- itemId
Type : System.Int32
Un ID d'élément.
- nodePath
Type : System.String
Le nouveau chemin de nœud du nœud.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | Le paramètre nodePath est null. |
| ArgumentException | L'itemID spécifié n'est pas valide. |
Notes
Cette méthode est très efficace car elle vous permet de mettre dans un contexte ou déplacer tout nœud dans la hiérarchie de vue de données.Elle doit être utilisée dans deux scénarios différents.
Le premier est lorsqu'un objet est créé.D'un fournisseur de données appelle d'abord la méthode d' CreateObjectNode pour produire un ID d'élément contextless qui peut être utilisé lors de la conception le nouvel objet.Lorsque cet objet est enregistré, le fournisseur de données souhaitera ajouter cet élément à l'arborescence hiérarchique.Cela est accompli en appelant la méthode d' SetNodePath et en fournissant le chemin d'accès correct de nœud à l'emplacement du nouveau nœud.
Le deuxième scénario se produit lorsque l'objet est modifié et doit être déplacé vers une autre partie de la hiérarchie.Encore une fois, lorsque l'objet est enregistré avec les propriétés mises à jour, le fournisseur de données doit appeler la méthode d' SetNodePath pour déplacer le nœud vers le nouvel emplacement.
Sécurité .NET Framework
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.