PipelineComponent.PrimeOutput Method

Article
12/03/2008

Called at run time for source components and transformation components with asynchronous outputs to let these components add rows to the output buffers.

Namespace: Microsoft.SqlServer.Dts.Pipeline
Assembly: Microsoft.SqlServer.PipelineHost (in microsoft.sqlserver.pipelinehost.dll)

Syntax

'Declaration
Public Overridable Sub PrimeOutput ( _
    outputs As Integer, _
    outputIDs As Integer(), _
    buffers As PipelineBuffer() _
)

public virtual void PrimeOutput (
    int outputs,
    int[] outputIDs,
    PipelineBuffer[] buffers
)

public:
virtual void PrimeOutput (
    int outputs, 
    array<int>^ outputIDs, 
    array<PipelineBuffer^>^ buffers
)

public void PrimeOutput (
    int outputs, 
    int[] outputIDs, 
    PipelineBuffer[] buffers
)

public function PrimeOutput (
    outputs : int, 
    outputIDs : int[], 
    buffers : PipelineBuffer[]
)

Parameters

outputs
The number of elements in the outputIDs and buffers arrays.

outputIDs
An array of IDTSOutput90 ID's.

buffers
An array of PipelineBuffer objects.

Remarks

The number of elements in the outputIDs and buffers array is determined by the number of IDTSOutput90 objects in the IDTSOutputCollection90 collection of the component connected to an IDTSPath90 object.

Each element in the outputIDs array has a PipelineBuffer at the same index in the buffers array.

Rows are added to the PipelineBuffer by calling the AddRow method, and when finished, the SetEndOfRowset method is called to notify the data flow task that the component is finished adding rows.

PrimeOutput is called for components whose SynchronousInputID property is set to zero.

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms