Metodo DataViewHierarchyAccessor.SetNodePath
Imposta il percorso del nodo per un nodo identificato da un ID elemento specifico
Spazio dei nomi: Microsoft.VisualStudio.Data
Assembly: Microsoft.VisualStudio.Data (in Microsoft.VisualStudio.Data.dll)
Sintassi
'Dichiarazione
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
)
Parametri
itemId
Tipo: Int32Un ID elemento.
nodePath
Tipo: StringIl nuovo percorso del nodo del nodo.
Eccezioni
| Eccezione | Condizione |
|---|---|
| ArgumentNullException | Il parametro nodePath è null. |
| ArgumentException | Il ID voce specificato non è valido. |
Note
Questo metodo è molto utile in quanto consente di contextualize o riassegniate un nodo della gerarchia di visualizzazione dati. Deve essere utilizzato in due scenari diversi.
Il primo è quando viene creato un nuovo oggetto. Chiama dapprima di un provider di dati il metodo CreateObjectNode per produrre un ID elemento contextless utilizzabile quando si progetta un nuovo oggetto. Quando l'oggetto viene salvato, il provider di dati desidererà per aggiungere l'elemento alla struttura ad albero della gerarchia. Questo risultato si ottiene chiamando il metodo SetNodePath e fornendo il percorso corretto del nodo nella posizione del nuovo nodo.
Il secondo scenario si verifica quando l'oggetto viene modificato e deve essere riassegnato a una parte diversa della gerarchia. Nuovamente, quando l'oggetto viene salvato con le proprietà aggiornate, il provider di dati deve chiamare il metodo SetNodePath per spostare il nodo nella nuova posizione.
Sicurezza di .NET Framework
- Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.