StartSegment Method

Creates a new IDoc data segment on the current IDoc document.

Syntax

[VB.NET]
Public Sub StartSegment(ByVal SegmentName As String)

[C#]
public void StartSegment(string segmentName);

Remarks

When called, a new data record segment is created in the current IDoc document and set as the current segment. Creating a new data record segment automatically writes the previous current segment to the output stream.

The SegmentName parameter specifies the name of the current segment.

It is important to realize that segments must be created in the same order they should appear on the target IDoc document. The IDocWriter component does not automatically enforce ordering rules.

Example IDocWriter Code:

idocwriter1.StartIDoc()
idocwriter1.WriteControlRecord()
idocwriter1.StartSegment("Segment1")
idocwriter1.WriteFieldValue("Field1", "Value1")
idocwriter1.WriteFieldValue("Field2", "Value2")
...
idocwriter1.EndSegment()
idocwriter1.StartSegment("Segment2")
idocwriter1.WriteFieldValue("Field1", "Value1")
...
idocwriter1.EndSegment()
...
idocwriter1.EndIDoc()