Export (0) Print
Expand All

IDTSOutputColumn100.SetDataTypeProperties Method

Sets multiple data type properties of an IDTSOutputColumn100 object simultaneously.

Namespace:  Microsoft.SqlServer.Dts.Pipeline.Wrapper
Assembly:  Microsoft.SqlServer.DTSPipelineWrap (in Microsoft.SqlServer.DTSPipelineWrap.dll)

void SetDataTypeProperties(
	DataType eDataType,
	int lLength,
	int lPrecision,
	int lScale,
	int lCodePage
)

Parameters

eDataType
Type: Microsoft.SqlServer.Dts.Runtime.Wrapper.DataType
The DataType of the column.
lLength
Type: System.Int32
The length of the column.
lPrecision
Type: System.Int32
The total number of digits of the output column.
lScale
Type: System.Int32
The number of decimal places of the output column.
lCodePage
Type: System.Int32
The character set of the output column.

The parameters of this method are individual read-only properties of the IDTSOutputColumn100 object whose values are set by using this method. The method is required because the values of these properties are dependent on each other. This method provides a mechanism for updating these properties atomically, allowing the data flow to enforce the dependencies. The eDataType parameter is used to determine the other checks to perform on the parameter values.

The following table shows the dependencies that are enforced when setting the data type properties of an output column.

DataType

Length

Scale

Precision

CodePage

DT_DECIMAL

Not enforced

Greater than or equal to 0, and less than or equal to 28.

Not enforced

Not enforced

DT_NUMERIC

Not enforced

Greater than or equal to 0, and less than or equal to 38, and less than or equal to the specified precision.

Greater than or equal to 1, and less than or equal to 38.

Not enforced

DT_BYTES

Greater than 0, and less than or equal to 8000.

Not enforced

Not enforced

Not enforced

DT_DBTIME2

DT_DBTIMESTAMP2

DT_DBTIMESTAMPOFFSET

Not enforced.

Greater than or equal to 0, and less than or equal to 7.

Not enforced.

Not enforced.

DT_STR

Greater than 0 and less than or equal to 8000.

Not enforced

Not enforced

Not 0.

DT_TEXT

Not enforced

Not enforced

Not enforced

Not 0.

DT_WSTR

Greater than 0 and less than or equal to 4000.

Not enforced

Not enforced

Not enforced

For more information about Integration Services data types and their properties, see Integration Services Data Types.

For a brief overview of the codepages supported by the SQL Server Database Engine, and a partial list of codepage values, see Code Page Architecture.

The use of the SetDataTypeProperties method is discussed or demonstrated briefly in Developing a Custom Source Component, Developing a Custom Transformation Component with Synchronous Outputs, and Developing a Custom Transformation Component with Asynchronous Outputs.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft