DataKey プロパティ

データセット キーまたはその他の情報を格納するために使用される値を取得または設定します。

シンタックス

Visual Basic

'宣言
 
Public Property DataKey As Object

C#

public object DataKey {get; set;}

解説

DataKey は基本的に関連データのキー情報を格納するために使用できるノードの追加の Tag プロパティです。ノードの Override.ShowExpansionIndicator プロパティが CheckOnDisplay に設定されている時に使用することを意図しています。

使用例

Visual Basic

Imports Infragistics.Win.UltraWinTree

Private Sub ultraTree1_BeforeExpand(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinTree.CancelableNodeEventArgs) Handles ultraTree1.BeforeExpand

    ' 注: ノード コレクションをオンデマンドに読み込むために、
    ' 適切な Override オブジェクトの ShowExpansionIndicator  
    ' プロパティを CheckOnExpand に設定しますこのイベントでは、展開されているノードに 
    ' 子ノードを追加するロジックを追加します 
    ' (e.TreeNode.Node の Add または AddRange メソッドなど)
    '
    ' Tag プロパティのほかに、ノードが (ノードに隠される) 
    ' DataKey プロパティも公開します
    ' CheckOnDemand を使用すると、データセットの対応行の
    ' 識別子またはキーを関連することは便利です
    '
    ' CheckOnExpand が有効された場合、このイベントが呼び出して 
    ' 子ノードが追加されなかった場合、展開インジケーターを非表示にして
    ' このイベントは再発生しません 
    '
    ' ただし、UltraTree の ResetExpansionIndicator メソッドを 
    ' 呼び出すと、展開インジケーターを表示し、
    ' ユーザーがノードを展開するときに、このイベントを
    ' 再発生されます
    '
    ' 「UltraTree ロードオンデマンド VB」サンプルを参照してください

    Dim sb As New System.Text.StringBuilder()

    sb.Append("Node: ")
    sb.Append(e.TreeNode.Key)
    sb.Append(" is about to be expanded.")

    Debug.WriteLine(sb.ToString())

    ' 注: この操作が以下のコード行によってキャンセルできます
    'e.Cancel = True

End Sub

C#

using System.Diagnostics;
using Infragistics.Win.UltraWinTree;

private void ultraTree1_BeforeExpand(object sender, Infragistics.Win.UltraWinTree.CancelableNodeEventArgs e)
{

	// 注: ノード コレクションをオンデマンドに読み込むために、
	// 適切な Override オブジェクトの ShowExpansionIndicator 
	// プロパティを CheckOnExpand に設定しますこのイベントでは、展開されているノードに 
	// 子ノードを追加するロジックを追加します 
	// (e.TreeNode.Node の Add または AddRange メソッドなど)
	//
	// Tag プロパティのほかに、ノードが (ノードに隠される)
	// DataKey プロパティも公開します
	// CheckOnDemand を使用すると、データセットの対応行の
	// 識別子またはキーを関連することは便利です
	//
	// CheckOnExpand が有効された場合、このイベントが呼び出して 
	// 子ノードが追加されなかった場合、展開インジケーターを非表示して
	// このイベントは再発生しません 
	//
	// ただし、UltraTree の ResetExpansionIndicator メソッドを 
	// 呼び出すと、展開インジケーターを表示し、
	// ユーザーがノードを展開するときに、このイベントを
	// 再発生します
	//
	// 「UltraTree ロードオンデマンド CS」サンプルを参照してください
	
	System.Text.StringBuilder sb = new System.Text.StringBuilder();

	sb.Append("Node: ");
	sb.Append(e.TreeNode.Key);
	sb.Append(" is about to be expanded.");

	Debug.WriteLine( sb.ToString() );

	// 注: この操作は以下のコードによってキャンセルできます
	//e.Cancel = true;
		
}