レンダリングオブジェクトが作成されても、そのレンダリングオブジェクトに最初からデータ連結は作成されません。データ連結は、ユーザーコードで DataBinding プロパティが参照されたときに作成されます。たとえば、次のように記述します。

Visual Basic コードの書き方

Dim rt As RenderText = New RenderText
' ...
If Not (rt.DataBinding Is Nothing) Then
MessageBox.Show("Data binding defined.")
End If

C# コードの書き方

RenderText rt = new RenderText();
// ...
if (rt.DataBinding != null)
{
MessageBox.Show("Data binding defined.");
}

上のコードの条件は、常に True に評価されます。したがって、特定のレンダリングオブジェクトにデータ連結が存在するかどうかを確認するだけであれば、代わりに DataBindingDefined プロパティを使用します。

Visual Basic コードの書き方

Dim rt As RenderText = New RenderText
' ...
If rt.DataBindingDefined Then
MessageBox.Show("Data binding defined.")
End If

C# コードの書き方

RenderText rt = new RenderText();
// ...
if (rt.DataBindingDefined)
{
MessageBox.Show("Data binding defined.");
}

ドキュメント生成時に、RenderObjectsList コレクションが形成されます。その結果として、次の３つの状況が考えられます。

• Copies が null。これは、オブジェクトがデータ連結ではなく、通常どおり処理されることを意味します。オブジェクトの Fragments プロパティを使用して、生成されたページに実際にレンダリングされたオブジェクトのフラグメントにアクセスできます。
• Copies が null ではなく、Copies.Cound が０。これは、オブジェクトはデータ連結だが、データセットが空である（レコードを含まない）ことを意味します。このような場合、オブジェクトはドキュメントにまったく表示されません。つまり、オブジェクトのフラグメントは生成されません。例については、DataBinding サンプルの「空のリストへの連結」を参照してください。
• Copies が null ではなく、Copies.Cound が０より大きい。これは、オブジェクトはデータ連結で、データソースが空ではない（レコードを含む）ことを意味します。ドキュメント生成時に、レンダリングオブジェクトのいくつかのコピーが作成されて、このコレクションに配置されます。その後、これらのコピーが処理され、通常どおりコピーごとにフラグメントが生成されます。