IDTSOutputColumn90.SetDataTypeProperties Method

Sets multiple data type properties of an IDTSOutputColumn90 object simultaneously.

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

Syntax

'Declaration
<DispIdAttribute(114)> _
Sub SetDataTypeProperties ( _
    <InAttribute> eDataType As DataType, _
    <InAttribute> lLength As Integer, _
    <InAttribute> lPrecision As Integer, _
    <InAttribute> lScale As Integer, _
    <InAttribute> lCodePage As Integer _
)
[DispIdAttribute(114)] 
void SetDataTypeProperties (
    [InAttribute] DataType eDataType,
    [InAttribute] int lLength,
    [InAttribute] int lPrecision,
    [InAttribute] int lScale,
    [InAttribute] int lCodePage
)
[DispIdAttribute(114)] 
void SetDataTypeProperties (
    [InAttribute] DataType eDataType, 
    [InAttribute] int lLength, 
    [InAttribute] int lPrecision, 
    [InAttribute] int lScale, 
    [InAttribute] int lCodePage
)
/** @attribute DispIdAttribute(114) */ 
void SetDataTypeProperties (
    /** @attribute InAttribute() */ DataType eDataType, 
    /** @attribute InAttribute() */ int lLength, 
    /** @attribute InAttribute() */ int lPrecision, 
    /** @attribute InAttribute() */ int lScale, 
    /** @attribute InAttribute() */ int lCodePage
)
DispIdAttribute(114) 
function SetDataTypeProperties (
    eDataType : DataType, 
    lLength : int, 
    lPrecision : int, 
    lScale : int, 
    lCodePage : int
)

Parameters

  • lLength
    The length of the column.
  • lPrecision
    The total number of digits of the output column.
  • lScale
    The number of decimal places of the output column.
  • lCodePage
    The character set of the output column.

Remarks

Updated sample code:17 July 2006

The parameters of this method are individual read-only properties of the IDTSOutputColumn90 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

0

Greater than 0 and less than or equal to 28.

0

0

DT_CY

0

0

0

0

DT_NUMERIC

0

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

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

0

DT_BYTES

Greater than 0.

0

0

0

DT_STR

Greater than 0 and less than 8000.

0

0

Not 0, and a valid code page.

DT_WSTR

Greater than 0 and less than 4000.

0

0

0

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 2005 Database Engine, and a partial list of codepage values, see Collation and 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.

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

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

See Also

Reference

IDTSOutputColumn90 Interface
IDTSOutputColumn90 Members
Microsoft.SqlServer.Dts.Pipeline.Wrapper Namespace

Change History

Release

History

17 July 2006

Changed content:
  • Updated description and added links to sample code.