特定の項目 ID で識別されるノードのノードのパスを設定します
名前空間: 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
型 : System.Int32
項目 ID。
- nodePath
型 : System.String
ノードの新しいノードのパス。
例外
| 例外 | 条件 |
|---|---|
| ArgumentNullException | nodePath パラメーターが null です。 |
| ArgumentException | 指定 itemID が無効です。 |
解説
このメソッドは、データの階層関係のノードを前後に設定または転送できるようにするため非常に強力です。これは、2 種類のシナリオで使用する必要があります。
1 番目のは、新しいオブジェクトが作成されます。データ プロバイダーの最初の呼び出しで使用できる contextless 項目 ID を生成 CreateObjectNode メソッドの新しいオブジェクトをデザインしているとき。このオブジェクトが保存されるとき、データ プロバイダーは、階層ツリーにこの項目を追加します。これは SetNodePath のメソッドを呼び出して、新しいノードの場所に適切なノード パスを指定することで実現されます。
2 番目のシナリオは、階層の別の部分にオブジェクトが変更され、移動する必要があるときに実行されます。再度オブジェクトが更新されたプロパティと保存時に、データ プロバイダーが新しい場所にノードを移動するに SetNodePath のメソッドを呼び出す必要があります。
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。