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)

Syntax

'Declaration
Sub SetDataTypeProperties ( _
    eDataType As DataType, _
    lLength As Integer, _
    lPrecision As Integer, _
    lScale As Integer, _
    lCodePage As Integer _
)
'Usage
Dim instance As IDTSOutputColumn100 
Dim eDataType As DataType 
Dim lLength As Integer 
Dim lPrecision As Integer 
Dim lScale As Integer 
Dim lCodePage As Integer

instance.SetDataTypeProperties(eDataType, _
    lLength, lPrecision, lScale, lCodePage)

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

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

abstract SetDataTypeProperties : 
        eDataType:DataType * 
        lLength:int * 
        lPrecision:int * 
        lScale:int * 
        lCodePage:int -> unit

function SetDataTypeProperties(
    eDataType : DataType, 
    lLength : int, 
    lPrecision : int, 
    lScale : int, 
    lCodePage : int
)

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.

Remarks

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 requirements 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.

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.

See Also

Reference

IDTSOutputColumn100 Interface

Microsoft.SqlServer.Dts.Pipeline.Wrapper Namespace