SqlParameter.cs source code in C# .NET

Source code for the .NET framework in C#

                        

Code:

/ Net / Net / 3.5.50727.3053 / DEVDIV / depot / DevDiv / releases / whidbey / netfxsp / ndp / fx / src / Data / System / Data / SqlClient / SqlParameter.cs / 6 / SqlParameter.cs

                            //------------------------------------------------------------------------------ 
// 
//     Copyright (c) Microsoft Corporation.  All rights reserved.
// 
// [....] 
// [....]
//----------------------------------------------------------------------------- 
 
namespace System.Data.SqlClient {
 
    using System;
    using System.ComponentModel;
    using System.Collections.Generic;
    using System.Data; 
    using System.Data.Common;
    using System.Data.ProviderBase; 
    using System.Data.Sql; 
    using System.Data.SqlTypes;
    using System.Diagnostics; 
    using System.IO;
    using System.Globalization;
    using System.Reflection;
    using System.Text; 
    using System.Xml;
    using MSS=Microsoft.SqlServer.Server; 
 
    using Microsoft.SqlServer.Server;
 

    [
    System.ComponentModel.TypeConverterAttribute(typeof(System.Data.SqlClient.SqlParameter.SqlParameterConverter))
    ] 
#if WINFSInternalOnly
    internal 
#else 
    public
#endif 
    sealed partial class SqlParameter : DbParameter, IDbDataParameter, ICloneable {
        private MetaType              _metaType;

        private SqlCollation          _collation; 
        private string                _xmlSchemaCollectionDatabase;
        private string                _xmlSchemaCollectionOwningSchema; 
        private string                _xmlSchemaCollectionName; 

        private string                _udtTypeName; 
        private string                _typeName;
        private Type                  _udtType;
        private Exception             _udtLoadError;
 
        private string                _parameterName;
        private byte                  _precision; 
        private byte                  _scale; 
        private bool                  _hasScale; // V1.0 compat, ignore _hasScale
 
        private MetaType              _internalMetaType;
        private SqlBuffer             _sqlBufferReturnValue;
        private bool                  _isSqlParameterSqlType;
 
        public SqlParameter() : base() {
        } 
 
        [ EditorBrowsableAttribute(EditorBrowsableState.Advanced) ] // MDAC 69508
        public SqlParameter(string parameterName, 
                            SqlDbType dbType, int size,
                            ParameterDirection direction, bool isNullable,
                            byte precision, byte scale,
                            string sourceColumn, DataRowVersion sourceVersion, 
                            object value) : this() { // V1.0 everything
            this.ParameterName = parameterName; 
            this.SqlDbType = dbType; 
            this.Size = size;
            this.Direction = direction; 
            this.IsNullable = isNullable;
            PrecisionInternal = precision;
            ScaleInternal = scale;
            this.SourceColumn = sourceColumn; 
            this.SourceVersion = sourceVersion;
            this.Value = value; 
        } 
        public SqlParameter(string parameterName,
                               SqlDbType dbType, int size, 
                               ParameterDirection direction,
                               byte precision, byte scale,
                               string sourceColumn, DataRowVersion sourceVersion, bool sourceColumnNullMapping,
                               object value, 
                               string xmlSchemaCollectionDatabase, string xmlSchemaCollectionOwningSchema,
                               string xmlSchemaCollectionName 
                               ) { // V2.0 everything - round trip all browsable properties + precision/scale 
            this.ParameterName = parameterName;
            this.SqlDbType = dbType; 
            this.Size = size;
            this.Direction = direction;
            this.PrecisionInternal = precision;
            this.ScaleInternal = scale; 
            this.SourceColumn = sourceColumn;
            this.SourceVersion = sourceVersion; 
            this.SourceColumnNullMapping = sourceColumnNullMapping; 
            this.Value = value;
            this._xmlSchemaCollectionDatabase = xmlSchemaCollectionDatabase; 
            this._xmlSchemaCollectionOwningSchema = xmlSchemaCollectionOwningSchema;
            this._xmlSchemaCollectionName = xmlSchemaCollectionName;
        }
        public SqlParameter(string parameterName, SqlDbType dbType) : this() { 
            this.ParameterName = parameterName;
            this.SqlDbType = dbType; 
        } 

        public SqlParameter(string parameterName, object value) : this() { 
            Debug.Assert(!(value is SqlDbType), "use SqlParameter(string, SqlDbType)");

            this.ParameterName = parameterName;
            this.Value = value; 
        }
 
        public SqlParameter(string parameterName, SqlDbType dbType, int size) : this() { 
            this.ParameterName = parameterName;
            this.SqlDbType = dbType; 
            this.Size = size;
        }

        public SqlParameter(string parameterName, SqlDbType dbType, int size, string sourceColumn) : this() { 
            this.ParameterName = parameterName;
            this.SqlDbType = dbType; 
            this.Size = size; 
            this.SourceColumn = sourceColumn;
        } 

        //
        // currently the user can't set this value.  it gets set by the returnvalue from tds
        // 
        internal SqlCollation Collation {
            get { 
                return _collation; 
            }
            set { 
                _collation = value;
            }
        }
 
        [
        Browsable(false), 
        ] 
        public SqlCompareOptions CompareInfo {
            // Bits 21 through 25 represent the CompareInfo 
            get {
                SqlCollation collation = _collation;
                if (null != collation) {
                    return collation.SqlCompareOptions; 
                }
                return SqlCompareOptions.None; 
            } 
            set {
                SqlCollation collation = _collation; 
                if (null == collation) {
                    _collation = collation = new SqlCollation();
                }
                if ((value & SqlString.x_iValidSqlCompareOptionMask) != value) { 
                    throw ADP.ArgumentOutOfRange("CompareInfo");
                } 
                collation.SqlCompareOptions = value; 
            }
        } 

        [
        ResCategoryAttribute(Res.DataCategory_Xml),
        ResDescriptionAttribute(Res.SqlParameter_XmlSchemaCollectionDatabase), 
        ]
        public string  XmlSchemaCollectionDatabase { 
            get { 
                string xmlSchemaCollectionDatabase = _xmlSchemaCollectionDatabase;
                return ((xmlSchemaCollectionDatabase != null) ? xmlSchemaCollectionDatabase : ADP.StrEmpty); 
            }
            set {
                _xmlSchemaCollectionDatabase = value;
            } 
        }
 
        [ 
        ResCategoryAttribute(Res.DataCategory_Xml),
        ResDescriptionAttribute(Res.SqlParameter_XmlSchemaCollectionOwningSchema), 
        ]
        public string XmlSchemaCollectionOwningSchema {
            get {
                string xmlSchemaCollectionOwningSchema = _xmlSchemaCollectionOwningSchema; 
                return ((xmlSchemaCollectionOwningSchema != null) ? xmlSchemaCollectionOwningSchema : ADP.StrEmpty);
            } 
            set { 
                _xmlSchemaCollectionOwningSchema = value;
            } 
        }

        [
        ResCategoryAttribute(Res.DataCategory_Xml), 
        ResDescriptionAttribute(Res.SqlParameter_XmlSchemaCollectionName),
        ] 
        public string XmlSchemaCollectionName { 
            get {
                string xmlSchemaCollectionName = _xmlSchemaCollectionName; 
                return ((xmlSchemaCollectionName != null) ? xmlSchemaCollectionName : ADP.StrEmpty);
            }
            set {
                _xmlSchemaCollectionName = value; 
            }
        } 
 
        override public DbType DbType {
            get { 
                return GetMetaTypeOnly().DbType;
            }
            set {
                MetaType metatype = _metaType; 
                if ((null == metatype) || (metatype.DbType != value) ||
                        // SQLBU 504029: Two special datetime cases for backward compat 
                        //  DbType.Date and DbType.Time should always be treated as setting DbType.DateTime instead 
                        value == DbType.Date ||
                        value == DbType.Time) { 
                    PropertyTypeChanging();
                    _metaType = MetaType.GetMetaTypeFromDbType(value);
                }
            } 
        }
 
        public override void ResetDbType() { 
            ResetSqlDbType();
        } 

        internal MetaType InternalMetaType {
            get {
                Debug.Assert(null != _internalMetaType, "null InternalMetaType"); 
                return _internalMetaType;
            } 
            set { _internalMetaType = value; } 
        }
 
        [
        Browsable(false),
        ]
        public int LocaleId { 
            // Lowest 20 bits represent LocaleId
            get { 
                SqlCollation collation = _collation; 
                if (null != collation) {
                    return collation.LCID; 
                }
                return 0;
            }
            set { 
                SqlCollation collation = _collation;
                if (null == collation) { 
                    _collation = collation = new SqlCollation(); 
                }
                if (value != (SqlCollation.MaskLcid & value)) { 
                    throw ADP.ArgumentOutOfRange("LocaleId");
                }
                collation.LCID = value;
            } 
        }
 
        private SqlMetaData MetaData { 
            get {
                MetaType mt = GetMetaTypeOnly(); 
 			    long maxlen;

				if (mt.IsFixed) {
					maxlen = (long)mt.FixedLength; 
				}
                else if (Size > 0 || Size < 0) { 
                   	maxlen = Size;   // Bug Fix: 302768, 302695, 302694, 302693 
                }
 				else { 
					maxlen = MSS.SmiMetaData.GetDefaultForType( mt.SqlDbType ).MaxLength;
 				}
                return new SqlMetaData(this.ParameterName, mt.SqlDbType, maxlen, GetActualPrecision(), GetActualScale(), LocaleId, CompareInfo,
                                       XmlSchemaCollectionDatabase, XmlSchemaCollectionOwningSchema, XmlSchemaCollectionName, mt.IsPlp, _udtType); 
            }
        } 
 
        internal bool SizeInferred {
            get { 
                return 0 == _size;
            }
        }
 
        internal MSS.SmiParameterMetaData MetaDataForSmi(out ParameterPeekAheadValue peekAhead) {
            peekAhead = null; 
#if WINFSFunctionality 
            MetaType mt = ValidateTypeLengths( true /* Yukon or newer */, false ); // SMI does not yet support LazyMat.
            long actualLen = GetActualSize( false );  // no lazy mat, yet 
#else
            MetaType mt = ValidateTypeLengths( true /* Yukon or newer */ );
            long actualLen = GetActualSize( );
#endif 
            long maxLen = this.Size;
 
            // GetActualSize returns bytes length, but smi expects char length for 
            //  character types, so adjust
            if ( !mt.IsLong ) { 
                if ( SqlDbType.NChar == mt.SqlDbType || SqlDbType.NVarChar == mt.SqlDbType ) {
                    actualLen = actualLen / sizeof( char );
                }
 
                if ( actualLen > maxLen ) {
                    maxLen = actualLen; 
                } 
            }
 
            // Determine maxLength for types that ValidateTypeLengths won't figure out
            if ( 0 == maxLen  ) {
                if ( SqlDbType.Binary == mt.SqlDbType || SqlDbType.VarBinary == mt.SqlDbType ) {
                    maxLen = MSS.SmiMetaData.MaxBinaryLength; 
                }
                else if ( SqlDbType.Char == mt.SqlDbType || SqlDbType.VarChar == mt.SqlDbType ) { 
                    maxLen = MSS.SmiMetaData.MaxANSICharacters; 
                }
                else if ( SqlDbType.NChar == mt.SqlDbType || SqlDbType.NVarChar == mt.SqlDbType ) { 
                    maxLen = MSS.SmiMetaData.MaxUnicodeCharacters;
                }
            }
            else if (( maxLen > MSS.SmiMetaData.MaxBinaryLength     && ( SqlDbType.Binary == mt.SqlDbType || SqlDbType.VarBinary == mt.SqlDbType )) 
                  || ( maxLen > MSS.SmiMetaData.MaxANSICharacters   && ( SqlDbType.Char   == mt.SqlDbType || SqlDbType.VarChar   == mt.SqlDbType ))
                  || ( maxLen > MSS.SmiMetaData.MaxUnicodeCharacters&& ( SqlDbType.NChar  == mt.SqlDbType || SqlDbType.NVarChar  == mt.SqlDbType )) ) { 
                maxLen = -1; 
            }
 

            int localeId = LocaleId;
            if ( 0 == localeId && mt.IsCharType ) {
#if WINFSFunctionality 
                object value = GetCoercedValue(false); // SMI does not yet support LazyMat.
#else 
                object value = GetCoercedValue(); 
#endif
                if ( value is SqlString && !( (SqlString)value ).IsNull ) { 
                    localeId = ( (SqlString)value ).LCID;
                }
                else {
                    localeId = System.Globalization.CultureInfo.CurrentCulture.LCID; 
                }
            } 
 
            SqlCompareOptions compareOpts = CompareInfo;
            if ( 0 == compareOpts && mt.IsCharType ) { 
#if WINFSFunctionality
                object value = GetCoercedValue(false); // SMI does not yet support LazyMat.
#else
                object value = GetCoercedValue(); 
#endif
                if ( value is SqlString && !( (SqlString)value ).IsNull ) { 
                    compareOpts = ( (SqlString)value ).SqlCompareOptions; 
                }
                else { 
                    compareOpts = MSS.SmiMetaData.GetDefaultForType( mt.SqlDbType ).CompareOptions;
                }
            }
 
            string typeSpecificNamePart1 = null;
            string typeSpecificNamePart2 = null; 
            string typeSpecificNamePart3 = null; 

            if (SqlDbType.Xml == mt.SqlDbType) { 
                typeSpecificNamePart1 = this.XmlSchemaCollectionDatabase;
                typeSpecificNamePart2 = this.XmlSchemaCollectionOwningSchema;
                typeSpecificNamePart3 = this.XmlSchemaCollectionName;
            } 
            else if (SqlDbType.Udt == mt.SqlDbType || (SqlDbType.Structured == mt.SqlDbType && !ADP.IsEmpty(this.TypeName))) {
                // Split the input name. The type name is specified as single 3 part name. 
                // NOTE: ParseTypeName throws if format is incorrect 
                String[] names;
                if (SqlDbType.Udt == mt.SqlDbType) { 
                    names = ParseTypeName(this.UdtTypeName, true /* is UdtTypeName */);
                }
                else {
                    names = ParseTypeName(this.TypeName, false /* not UdtTypeName */); 
                }
 
                if (1 == names.Length) { 
                    typeSpecificNamePart3 = names[0];
                } 
                else if (2 == names.Length) {
                    typeSpecificNamePart2 = names[0];
                    typeSpecificNamePart3 = names[1];
                } 
                else if (3 == names.Length) {
                    typeSpecificNamePart1 = names[0]; 
                    typeSpecificNamePart2 = names[1]; 
                    typeSpecificNamePart3 = names[2];
                } 
                else {
                    throw ADP.ArgumentOutOfRange("names");
                }
 
                if ((!ADP.IsEmpty(typeSpecificNamePart1) && TdsEnums.MAX_SERVERNAME < typeSpecificNamePart1.Length)
                    || (!ADP.IsEmpty(typeSpecificNamePart2) && TdsEnums.MAX_SERVERNAME < typeSpecificNamePart2.Length) 
                    || (!ADP.IsEmpty(typeSpecificNamePart3) && TdsEnums.MAX_SERVERNAME < typeSpecificNamePart3.Length)) { 
                    throw ADP.ArgumentOutOfRange("names");
                } 
            }

            byte precision = GetActualPrecision();
            byte scale = GetActualScale(); 

            // precision for decimal types may still need adjustment. 
            if ( SqlDbType.Decimal == mt.SqlDbType ) { 
                if ( 0 == precision ) {
                    precision = TdsEnums.DEFAULT_NUMERIC_PRECISION; 
                }
            }

            // Sub-field determination 
            List fields = null;
            MSS.SmiMetaDataPropertyCollection extendedProperties = null; 
            if (SqlDbType.Structured == mt.SqlDbType) { 
                GetActualFieldsAndProperties(out fields, out extendedProperties, out peekAhead);
            } 

            return new MSS.SmiParameterMetaData( mt.SqlDbType,
                                            maxLen,
                                            precision, 
                                            scale,
                                            localeId, 
                                            compareOpts, 
                                            null,           // Udt type not used for parameters
                                            SqlDbType.Structured == mt.SqlDbType, 
                                            fields,
                                            extendedProperties,
                                            this.ParameterNameFixed,
                                            typeSpecificNamePart1, 
                                            typeSpecificNamePart2,
                                            typeSpecificNamePart3, 
                                            this.Direction); 
        }
 
        internal bool ParamaterIsSqlType {
            get {
                return _isSqlParameterSqlType;
                } 
            set {
                    _isSqlParameterSqlType = value; 
                } 
        }
 
        [
        ResCategoryAttribute(Res.DataCategory_Data),
        ResDescriptionAttribute(Res.SqlParameter_ParameterName),
        ] 
        override public string ParameterName {
            get { 
                string parameterName = _parameterName; 
                return ((null != parameterName) ? parameterName : ADP.StrEmpty);
            } 
            set {
                if (ADP.IsEmpty(value) || (value.Length < TdsEnums.MAX_PARAMETER_NAME_LENGTH)
                    || (('@' == value[0]) && (value.Length <= TdsEnums.MAX_PARAMETER_NAME_LENGTH))) {
                    if (_parameterName != value) { 
                        PropertyChanging();
                        _parameterName = value; 
                    } 
                }
                else { 
                    throw SQL.InvalidParameterNameLength(value);
                }
            }
        } 

        internal string ParameterNameFixed { 
            get { 
                string parameterName = ParameterName;
                if ((0 < parameterName.Length) && ('@' != parameterName[0])) { 
                    parameterName = "@" + parameterName;
                }
                Debug.Assert(parameterName.Length <= TdsEnums.MAX_PARAMETER_NAME_LENGTH, "parameter name too long");
                return parameterName; 
            }
        } 
 
        [DefaultValue((Byte)0)] // MDAC 65862
        [ResCategoryAttribute(Res.DataCategory_Data)] 
        [ResDescriptionAttribute(Res.DbDataParameter_Precision)]
        public Byte Precision {
            get {
                return PrecisionInternal; 
            }
            set { 
                PrecisionInternal = value; 
            }
        } 

        internal byte PrecisionInternal {
            get {
                byte precision = _precision; 
                SqlDbType dbtype = GetMetaSqlDbTypeOnly();
                if ((0 == precision) && (SqlDbType.Decimal == dbtype)) { 
                    precision = ValuePrecision(SqlValue); 
                }
                return precision; 
            }
            set {
                SqlDbType sqlDbType = SqlDbType;
                if (SqlDbType.Float == sqlDbType) { 
                 if (value > TdsEnums.MAX_FLOAT_PRECISION)
                    throw SQL.PrecisionValueOutOfRange(value); 
               } 
               else
               if (SqlDbType.Real == sqlDbType) { 
                 if (value > TdsEnums.MAX_REAL_PRECISION)
                    throw SQL.PrecisionValueOutOfRange(value);
               }
               else 
                if (value > TdsEnums.MAX_NUMERIC_PRECISION) {
                    throw SQL.PrecisionValueOutOfRange(value); 
                } 
                if (_precision != value) {
                    PropertyChanging(); 
                    _precision = value;
                }
            }
        } 

        private bool ShouldSerializePrecision() { 
            return (0 != _precision); 
        }
 
        [DefaultValue((Byte)0)] // MDAC 65862
        [ResCategoryAttribute(Res.DataCategory_Data)]
        [ResDescriptionAttribute(Res.DbDataParameter_Scale)]
        public Byte Scale { 
            get {
                return ScaleInternal; 
            } 
            set {
                ScaleInternal = value; 
            }
        }
        internal byte ScaleInternal {
            get { 
                byte scale = _scale;
                SqlDbType dbtype = GetMetaSqlDbTypeOnly(); 
                if ((0 == scale) && (SqlDbType.Decimal == dbtype)) { 
                    scale = ValueScale(SqlValue);
                } 
                return scale;
            }
            set {
                if (_scale != value || !_hasScale) { 
                    PropertyChanging();
                    _scale = value; 
                    _hasScale = true; 
                }
            } 
        }

        private bool ShouldSerializeScale() {
            return (0 != _scale); // V1.0 compat, ignore _hasScale 
        }
 
        [ 
        RefreshProperties(RefreshProperties.All),
        ResCategoryAttribute(Res.DataCategory_Data), 
        ResDescriptionAttribute(Res.SqlParameter_SqlDbType),
        System.Data.Common.DbProviderSpecificTypePropertyAttribute(true),
        ]
        public SqlDbType SqlDbType { 
            get {
                return GetMetaTypeOnly().SqlDbType; 
            } 
            set {
                MetaType metatype = _metaType; 
                // HACK!!!
                // We didn't want to expose SmallVarBinary on SqlDbType so we
                // stuck it at the end of SqlDbType in v1.0, except that now
                // we have new data types after that and it's smack dab in the 
                // middle of the valid range.  To prevent folks from setting
                // this invalid value we have to have this code here until we 
                // can take the time to fix it later. 
                if ((SqlDbType)TdsEnums.SmallVarBinary == value) {
                    throw SQL.InvalidSqlDbType(value); 
                }
                if ((null == metatype) || (metatype.SqlDbType != value)) {
                    PropertyTypeChanging();
                    _metaType = MetaType.GetMetaTypeFromSqlDbType(value, value == SqlDbType.Structured); 
                }
            } 
        } 

        private bool ShouldSerializeSqlDbType() { 
            return (null != _metaType);
        }

        public void ResetSqlDbType() { 
            if (null != _metaType) {
                PropertyTypeChanging(); 
                _metaType = null; 
            }
        } 

        [
        Browsable(false),
        DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden), 
        ]
        public object SqlValue { 
            get { 
                if (_udtLoadError != null) { // SQL BU DT 329981
                    throw _udtLoadError; 
                }

                if (_value != null) {
                    if (_value == DBNull.Value) { 
                        return MetaType.GetNullSqlValue(GetMetaTypeOnly().SqlType);
                    } 
                    if (_value is INullable) { 
                          return _value;
                    } 

                    // SQLBU 503165: for Date and DateTime2, return the CLR object directly without converting it to a SqlValue
                    // SQLBU 527900: GetMetaTypeOnly() will convert _value to a string in the case of char or char[], so only check
                    //               the SqlDbType for DateTime. This is the only case when we might return the CLR value directly. 
                    if (_value is DateTime) {
                        SqlDbType sqlDbType = GetMetaTypeOnly().SqlDbType; 
                        if (sqlDbType == SqlDbType.Date || sqlDbType == SqlDbType.DateTime2) { 
                            return _value;
                        } 
                    }

                    return (MetaType.GetSqlValueFromComVariant(_value));
                } 
                else if (_sqlBufferReturnValue != null) {
                    return _sqlBufferReturnValue.SqlValue; 
                } 
                return null;
            } 
            set {
                Value = value;
            }
        } 

        [ 
        Browsable(false), 
        EditorBrowsableAttribute(EditorBrowsableState.Advanced)
        ] 
        public String UdtTypeName {
            get {
                string typeName = _udtTypeName;
                return ((null != typeName) ? typeName : ADP.StrEmpty); 
            }
            set { 
                _udtTypeName = value; 
            }
        } 

        [
        Browsable(false),
        EditorBrowsableAttribute(EditorBrowsableState.Advanced) 
        ]
        public String TypeName { 
            get { 
                string typeName = _typeName;
                return ((null != typeName) ? typeName : ADP.StrEmpty); 
            }
            set {
                _typeName = value;
            } 
        }
 
        [ 
        RefreshProperties(RefreshProperties.All),
        ResCategoryAttribute(Res.DataCategory_Data), 
        ResDescriptionAttribute(Res.DbParameter_Value),
        TypeConverterAttribute(typeof(StringConverter)),
        ]
        override public object Value { // V1.2.3300, XXXParameter V1.0.3300 
            get {
                if (_udtLoadError != null) { // SQL BU DT 329981 
                    throw _udtLoadError; 
                }
 
                if (_value != null) {
                    return _value;
                }
                else if (_sqlBufferReturnValue != null) { 
                    if (ParamaterIsSqlType) {
                        return _sqlBufferReturnValue.SqlValue; 
                    } 
                    return _sqlBufferReturnValue.Value;
                } 
                return null;
            }
            set {
                _value = value; 
                _sqlBufferReturnValue = null;
                _coercedValue = null; 
                _isSqlParameterSqlType = _value is INullable; 
                _udtLoadError = null;
            } 
        }

        //
        // always returns data in bytes - except for non-unicode chars, which will be in number of chars 
        //
#if WINFSFunctionality 
        internal int GetActualSize(bool isWinFS) { 
#else
        internal int GetActualSize() { 
#endif
            int size = 0;
            MetaType mt = InternalMetaType;
            SqlDbType actualType = mt.SqlDbType; 
#if WINFSFunctionality
            object val = GetCoercedValue(isWinFS); 
#else 
            object val = GetCoercedValue();
#endif 
            bool isSqlVariant = false;

            //
            if (ADP.IsNull(val) && !mt.IsVarTime) { 
                return 0;
            } 
 
            // if this is a backend SQLVariant type, then infer the TDS type from the SQLVariant type
            if (actualType == SqlDbType.Variant) { 
                mt = MetaType.GetMetaTypeFromValue(val);
                actualType = MetaType.GetSqlDataType(mt.TDSType, 0 /*no user type*/, 0 /*non-nullable type*/).SqlDbType;
                isSqlVariant = true;
            } 

            if (mt.IsFixed) 
                return mt.FixedLength; 

            // @hack: until we have ForceOffset behavior we have the following semantics: 
            // @hack: if the user supplies a Size through the Size propeprty or constructor,
            // @hack: we only send a MAX of Size bytes over.  If the actualSize is < Size, then
            // @hack: we send over actualSize
            int actualSize = 0; 

            // get the actual length of the data, in bytes 
            switch (actualType) { 
            case SqlDbType.NChar:
            case SqlDbType.NVarChar: 
            case SqlDbType.NText:
            case SqlDbType.Xml:
#if WINFSFunctionality
                if (isWinFS && IsNonFilledLazyMatInstance()) { // HACK for LazyMat 
                    size = ((byte[]) val).Length;
                } 
                else 
#endif
                { 
                    actualSize = ValueSize(val);
                    size = (ShouldSerializeSize() ? Size : 0);
                    size = ((ShouldSerializeSize() && (size <= actualSize)) ? size : actualSize);
                    if (size == -1) 
                        size = actualSize;
                    size <<= 1; 
                } 
                break;
            case SqlDbType.Char: 
            case SqlDbType.VarChar:
            case SqlDbType.Text:
#if WINFSFunctionality
                if (isWinFS && IsNonFilledLazyMatInstance()) { // HACK for LazyMat 
                    size = ((byte[]) val).Length;
                } 
                else 
#endif
                { 
                    // for these types, ActualSize is the num of chars, not actual bytes - since non-unicode chars are not always uniform size
                    actualSize = ValueSize(val);
                    size = (ShouldSerializeSize() ? Size : 0);
                    size = ((ShouldSerializeSize() && (size <= actualSize)) ? size : actualSize); 
                    if (size == -1)
                        size = actualSize; 
                } 
                break;
            case SqlDbType.Binary: 
            case SqlDbType.VarBinary:
            case SqlDbType.Image:
            case SqlDbType.Timestamp:
                actualSize = ValueSize(val); 
                size = (ShouldSerializeSize() ? Size : 0);
                size = ((ShouldSerializeSize() && (size <= actualSize)) ? size : actualSize); 
                if (size == -1) 
                    size = actualSize;
                break; 
             case SqlDbType.Udt:
                //we assume that the object is UDT
                if (false == ADP.IsNull (val)) {
                    //call the static function 
#if WINFSFunctionality
                    actualSize = AssemblyCache.GetLength(val, isWinFS); 
#else 
                    actualSize = AssemblyCache.GetLength(val);
#endif 
                }
                break;
            case SqlDbType.Structured:
                actualSize = -1; 
                break;
            case SqlDbType.Time: 
                size = (isSqlVariant ? 5 : MetaType.GetTimeSizeFromScale(GetActualScale())); 
                break;
            case SqlDbType.DateTime2: 
                // Date in number of days (3 bytes) + time
                size = 3 + (isSqlVariant ? 5 : MetaType.GetTimeSizeFromScale(GetActualScale()));
                break;
            case SqlDbType.DateTimeOffset: 
                // Date in days (3 bytes) + offset in minutes (2 bytes) + time
                size = 5 + (isSqlVariant ? 5 : MetaType.GetTimeSizeFromScale(GetActualScale())); 
                break; 
            default:
                Debug.Assert(false, "Unknown variable length type!"); 
                break;
            } // switch

            // don't even send big values over to the variant 
            if (isSqlVariant && (actualSize > TdsEnums.TYPE_SIZE_LIMIT))
                throw SQL.ParameterInvalidVariant(this.ParameterName); 
 
            return size;
        } 

        object ICloneable.Clone() {
            return new SqlParameter(this);
        } 

#if WINFSFunctionality 
        private static object CoerceValue(object value, MetaType destinationType, bool isWinFS) { 
#else
        // Coerced Value is also used in SqlBulkCopy.ConvertValue(object value, _SqlMetaData metadata) 
        internal static object CoerceValue(object value, MetaType destinationType) {
#endif

            Debug.Assert(null != destinationType, "null destinationType"); 

            // Avoid coercion if null or DBNull 
            if ((null != value) && (DBNull.Value != value)) { 
                Type currentType = value.GetType();
                bool coerceValue = true; // default to true 

                // Perform INullable checks - non-trivial due to LazyMat
                if (value is INullable) {
#if WINFSFunctionality 
                    if (isWinFS &&
                         ( (typeof(SqlChars) == currentType && !((SqlChars)value).IsFilled) || 
                           (typeof(SqlBytes) == currentType && !((SqlBytes)value).IsFilled) ) ) { 
                        // If WinFS and non-filled, enter without checking other values -
                        // otherwise we will generate exception by calling those methods on non-filled instance 
                        coerceValue = true;
                    }
                    else
#endif 
                         if (((INullable)value).IsNull) {
                        coerceValue = false; 
                    } 
                }
 
                if ( coerceValue &&
                     (typeof(object) != destinationType.ClassType) &&
                     (((currentType != destinationType.ClassType) && (currentType != destinationType.SqlType) )  ||
                     (SqlDbType.Xml == destinationType.SqlDbType))) { 
                    try {
                        if ((typeof(string) == destinationType.ClassType)) { 
                            // For Xml data, destination Type is always string 
                            if (typeof(SqlXml) == currentType) {
                                value = MetaType.GetStringFromXml((XmlReader)(((SqlXml)value).CreateReader())); 
                            }
                            else if (typeof(SqlString)  == currentType) {
                                ;   // Do nothing
                            } 
                            else if (typeof(XmlReader).IsAssignableFrom(currentType)) {
                                value = MetaType.GetStringFromXml((XmlReader)value); 
                            } 
                            else if (typeof(char[]) == currentType) {
                                value = new string((char[])value); 
                            }
                            else if (typeof(SqlChars) == currentType) {
                                SqlChars chars = (SqlChars) value;
 
#if WINFSFunctionality
                                if (!chars.IsFilled) { // LazyMat - value is cookie 
                                    value = chars.Cookie; // must use internal property 
                                }
                                else 
#endif
                                {
                                    value = new string((char[])chars.Value);
                                } 
                            }
                            else { 
                                value = Convert.ChangeType(value, destinationType.ClassType, (IFormatProvider)null); 
                            }
                        } 
                        else if ((DbType.Currency == destinationType.DbType) && (typeof(string) == currentType)) {
                            value = Decimal.Parse((string)value, NumberStyles.Currency, (IFormatProvider)null); // WebData 99376
                        }
                        else if ((typeof(SqlBytes) == currentType) && (typeof(byte[]) == destinationType.ClassType)) { 
                            SqlBytes bytes = (SqlBytes) value;
 
#if WINFSFunctionality 
                            if (!bytes.IsFilled) { // LazyMat - value is cookie
                                value = bytes.Cookie; // must use internal property 
                            }
                            // no conversion, byte[] normally matches to SqlBinary
#endif
                        } 
                        else if ((typeof(string) == currentType) && (SqlDbType.Time == destinationType.SqlDbType)) {
                            value = TimeSpan.Parse((string)value); 
                        } 
                        else if ((typeof(string) == currentType) && (SqlDbType.DateTimeOffset == destinationType.SqlDbType)) {
                            value = DateTimeOffset.Parse((string)value, (IFormatProvider)null); 
                        }
                        else if ((typeof(DateTime) == currentType) && (SqlDbType.DateTimeOffset == destinationType.SqlDbType)) {
                            value = new DateTimeOffset((DateTime)value);
                        } 
                        else if (TdsEnums.SQLTABLE == destinationType.TDSType &&
                                   (value is DataTable || 
                                    value is DbDataReader || 
                                    value is System.Collections.Generic.IEnumerable)) {
                            // no conversion for TVPs. 
                        }
                        else {
                            value = Convert.ChangeType(value, destinationType.ClassType, (IFormatProvider)null);
                        } 
                    }
                    catch(Exception e) { 
                        // 
                        if (!ADP.IsCatchableExceptionType(e)) {
                            throw; 
                        }

                        throw ADP.ParameterConversionFailed(value, destinationType.ClassType, e); // WebData 75433
                    } 
                }
            } 
            return value; 
        }
 

        private void CloneHelper(SqlParameter destination) {
            CloneHelperCore(destination);
            destination._metaType     = _metaType; 
            destination._collation    = _collation;
            destination._xmlSchemaCollectionDatabase = _xmlSchemaCollectionDatabase; 
            destination._xmlSchemaCollectionOwningSchema = _xmlSchemaCollectionOwningSchema; 
            destination._xmlSchemaCollectionName = _xmlSchemaCollectionName;
            destination._udtTypeName  = _udtTypeName; 
            destination._typeName  = _typeName;
            destination._udtLoadError = _udtLoadError;

            destination._parameterName = _parameterName; 
            destination._precision = _precision;
            destination._scale = _scale; 
            destination._sqlBufferReturnValue = _sqlBufferReturnValue; 
            destination._isSqlParameterSqlType = _isSqlParameterSqlType;
            destination._internalMetaType = _internalMetaType; 
            destination.CoercedValue     = CoercedValue; // copy cached value reference because of XmlReader problem
        }

        internal byte GetActualPrecision() { 
            return ShouldSerializePrecision() ? PrecisionInternal: ValuePrecision(CoercedValue);
        } 
 
        internal byte GetActualScale() {
            if (ShouldSerializeScale()) { 
                return ScaleInternal;
            }

            // issue: how could a user specify 0 as the actual scale? 
            if (GetMetaTypeOnly().IsVarTime) {
                return TdsEnums.DEFAULT_VARTIME_SCALE; 
            } 
            return ValueScale(CoercedValue);
        } 

        internal int GetParameterSize() {
            return ShouldSerializeSize() ? Size : ValueSize(CoercedValue);
        } 

        private void GetActualFieldsAndProperties(out List fields, out SmiMetaDataPropertyCollection props, out ParameterPeekAheadValue peekAhead) { 
            fields = null; 
            props = null;
            peekAhead = null; 

            object value = GetCoercedValue();
            if (value is DataTable) {
                DataTable dt = value as DataTable; 
                if (dt.Columns.Count <= 0) {
                    throw SQL.NotEnoughColumnsInStructuredType(); 
                } 
                fields = new List(dt.Columns.Count);
                bool[] keyCols = new bool[dt.Columns.Count]; 
                bool hasKey = false;

                // set up primary key as unique key list
                //  do this prior to general metadata loop to favor the primary key 
                if (null != dt.PrimaryKey && 0 < dt.PrimaryKey.Length) {
                    foreach(DataColumn col in dt.PrimaryKey) { 
                        keyCols[col.Ordinal] = true; 
                        hasKey = true;
                    } 
                }

                for(int i=0; i(keyCols));
                } 
            }
            else if (value is SqlDataReader) {
                fields = new List(((SqlDataReader)value).GetInternalSmiMetaData());
                if (fields.Count <= 0) { 
                    throw SQL.NotEnoughColumnsInStructuredType();
                } 
 
                bool[] keyCols = new bool[fields.Count];
                bool hasKey = false; 
                for(int i=0; i(keyCols));
                } 
            }
            else if (value is IEnumerable) { 
                // must grab the first record of the enumerator to get the metadata 
                IEnumerator enumerator = ((IEnumerable) value).GetEnumerator();
                MSS.SqlDataRecord firstRecord = null; 
                try {
                    // no need for fields if there's no rows or no columns -- we'll be sending a null instance anyway.
                    if (enumerator.MoveNext()) {
                        firstRecord = enumerator.Current; 
                        int fieldCount = firstRecord.FieldCount;
                        if (0 < fieldCount) { 
                            // It's valid!  Grab those fields. 
                            bool[] keyCols = new bool[fieldCount];
                            bool[] defaultFields = new bool[fieldCount]; 
                            bool[] sortOrdinalSpecified = new bool[fieldCount];
                            int maxSortOrdinal = -1;  // largest sort ordinal seen, used to optimize locating holes in the list
                            bool hasKey = false;
                            bool hasDefault = false; 
                            int sortCount = 0;
                            SmiOrderProperty.SmiColumnOrder[] sort = new SmiOrderProperty.SmiColumnOrder[fieldCount]; 
                            fields = new List(fieldCount); 
                            for (int i = 0; i < fieldCount; i++) {
                                SqlMetaData colMeta = firstRecord.GetSqlMetaData(i); 
                                fields.Add(MSS.MetaDataUtilsSmi.SqlMetaDataToSmiExtendedMetaData(colMeta));
                                if (colMeta.IsUniqueKey) {
                                    keyCols[i] = true;
                                    hasKey = true; 
                                }
 
                                if (colMeta.UseServerDefault) { 
                                    defaultFields[i] = true;
                                    hasDefault = true; 
                                }

                                sort[i].Order = colMeta.SortOrder;
                                if (SortOrder.Unspecified != colMeta.SortOrder) { 
                                    // SqlMetaData takes care of checking for negative sort ordinals with specified sort order
 
                                    // bail early if there's no way sort order could be monotonically increasing 
                                    if (fieldCount <= colMeta.SortOrdinal) {
                                        throw SQL.SortOrdinalGreaterThanFieldCount(i, colMeta.SortOrdinal); 
                                    }

                                    // Check to make sure we haven't seen this ordinal before
                                    if (sortOrdinalSpecified[colMeta.SortOrdinal]) { 
                                        throw SQL.DuplicateSortOrdinal(colMeta.SortOrdinal);
                                    } 
 
                                    sort[i].SortOrdinal = colMeta.SortOrdinal;
                                    sortOrdinalSpecified[colMeta.SortOrdinal] = true; 
                                    if (colMeta.SortOrdinal > maxSortOrdinal) {
                                        maxSortOrdinal = colMeta.SortOrdinal;
                                    }
                                    sortCount++; 
                                }
                            } 
 
                            if (hasKey) {
                                props = new SmiMetaDataPropertyCollection(); 
                                props[MSS.SmiPropertySelector.UniqueKey] = new MSS.SmiUniqueKeyProperty(new List(keyCols));
                            }

                            if (hasDefault) { 
                                // May have already created props list in unique key handling
                                if (null == props) { 
                                    props = new SmiMetaDataPropertyCollection(); 
                                }
 
                                props[MSS.SmiPropertySelector.DefaultFields] = new MSS.SmiDefaultFieldsProperty(new List(defaultFields));
                            }

                            if (0 < sortCount) { 
                                // validate monotonically increasing sort order.
                                //  Since we already checked for duplicates, we just need 
                                //  to watch for values outside of the sortCount range. 
                                if (maxSortOrdinal >= sortCount) {
                                    // there is at least one hole, find the first one 
                                    int i;
                                    for (i = 0; i < sortCount; i++) {
                                        if (!sortOrdinalSpecified[i]) {
                                            break; 
                                        }
                                    } 
                                    Debug.Assert(i < sortCount, "SqlParameter.GetActualFieldsAndProperties: SortOrdinal hole-finding algorithm failed!"); 
                                    throw SQL.MissingSortOrdinal(i);
                                } 

                                // May have already created props list
                                if (null == props) {
                                    props = new SmiMetaDataPropertyCollection(); 
                                }
 
                                props[MSS.SmiPropertySelector.SortOrder] = new MSS.SmiOrderProperty( 
                                        new List(sort));
                            } 

                            // pack it up so we don't have to rewind to send the first value
                            peekAhead = new ParameterPeekAheadValue();
                            peekAhead.Enumerator = enumerator; 
                            peekAhead.FirstRecord = firstRecord;
 
                            // now that it's all packaged, make sure we don't dispose it. 
                            enumerator = null;
                        } 
                        else {
                            throw SQL.NotEnoughColumnsInStructuredType();
                        }
                    } 
                    else {
                        throw SQL.IEnumerableOfSqlDataRecordHasNoRows(); 
                    } 
                }
                finally { 
                    if (enumerator != null) {
                        enumerator.Dispose();
                    }
                } 
            }
            else if (value is DbDataReader) { 
                DataTable schema = ((DbDataReader)value).GetSchemaTable(); 
                if (schema.Rows.Count <= 0) {
                    throw SQL.NotEnoughColumnsInStructuredType(); 
                }

                int fieldCount = schema.Rows.Count;
                fields = new List(fieldCount); 
                bool[] keyCols = new bool[fieldCount];
                bool hasKey = false; 
                int ordinalForIsKey = schema.Columns[SchemaTableColumn.IsKey].Ordinal; 
                int ordinalForColumnOrdinal = schema.Columns[SchemaTableColumn.ColumnOrdinal].Ordinal;
                // Extract column metadata 
                for(int rowOrdinal=0; rowOrdinal= fieldCount || columnOrdinal < 0) { 
                        throw SQL.InvalidSchemaTableOrdinals();
                    } 

                    // extend empty space if out-of-order ordinal
                    while (columnOrdinal > fields.Count) {
                        fields.Add(null); 
                    }
 
                    // Now add the candidate to the list 
                    if (fields.Count == columnOrdinal) {
                        fields.Add(candidateMd); 
                    }
                    else {
                        // Disallow two columns using the same ordinal (even if due to mixing null and non-null columnOrdinals)
                        if (fields[columnOrdinal] != null) { 
                            throw SQL.InvalidSchemaTableOrdinals();
                        } 
 
                        // Don't use insert, since it shifts all later columns down a notch
                        fields[columnOrdinal] = candidateMd; 
                    }

                    // Propogate key information
                    if (!row.IsNull(ordinalForIsKey) && (bool)row[ordinalForIsKey]) { 
                        keyCols[columnOrdinal] = true;
                        hasKey = true; 
                    } 
                }
 
#if DEBUG
                // Check for holes
                //  Above loop logic prevents holes since:
                //      1) loop processes fieldcount # of columns 
                //      2) no ordinals outside continuous range from 0 to fieldcount - 1 are allowed
                //      3) no duplicate ordinals are allowed 
                // But assert no holes to be sure. 
                foreach (SmiExtendedMetaData md in fields) {
                    Debug.Assert(null != md, "Shouldn't be able to have holes, since original loop algorithm prevents such."); 
                }
#endif

                // Add unique key property, if any defined. 
                if (hasKey) {
                    props = new SmiMetaDataPropertyCollection(); 
                    props[MSS.SmiPropertySelector.UniqueKey] = new MSS.SmiUniqueKeyProperty(new List(keyCols)); 
                }
            } 
        }

#if WINFSFunctionality
        internal object GetCoercedValue(bool isWinFS) { 
#else
        internal object GetCoercedValue() { 
#endif 
            object value = CoercedValue; // will also be set during parameter Validation
            if (null == value) { 
#if WINFSFunctionality
                value = CoerceValue(Value, _internalMetaType, isWinFS);
#else
                value = CoerceValue(Value, _internalMetaType); 
#endif
                CoercedValue = value; 
            } 
            return value;
        } 

        private SqlDbType GetMetaSqlDbTypeOnly() {
            MetaType metaType = _metaType;
            if (null == metaType) { // infer the type from the value 
                metaType = MetaType.GetDefaultMetaType();
            } 
            return metaType.SqlDbType; 
        }
 
        // This may not be a good thing to do in case someone overloads the parameter type but I
        // don't want to go from SqlDbType -> metaType -> TDSType
        private MetaType GetMetaTypeOnly() {
            if (null != _metaType) { 
                return _metaType;
            } 
            if (null != _value && DBNull.Value != _value) { 
                  // We have a value set by the user then just use that value
                  // char and char[] are not directly supported so we convert those values to string 
                  Type valueType = _value.GetType ();
                  if (typeof(char) == valueType) {
                      _value = _value.ToString();
                      valueType = typeof (string); 
                  }
                  else if (typeof(char[]) == valueType) { 
                     _value = new string((char[])_value); 
                     valueType = typeof (string);
                  } 
                  return MetaType.GetMetaTypeFromType(valueType);
            }
            else if (null != _sqlBufferReturnValue) {  // value came back from the server
                 Type valueType = _sqlBufferReturnValue.GetTypeFromStorageType (_isSqlParameterSqlType); 
                 if (null != valueType) {
                     return MetaType.GetMetaTypeFromType(valueType); 
                 } 
            }
            return MetaType.GetDefaultMetaType(); 
        }

#if WINFSFunctionality
        internal bool IsNonFilledLazyMatInstance() { 
            //
            bool   result = false; 
            object value  = this.SqlValue; 

            if ((null != value) && (DBNull.Value != value)) { 
                Type valueType = value.GetType();

                if (valueType == typeof(SqlChars)) {
                    SqlChars sqlValue = (SqlChars) value; 
                    if (!sqlValue.IsFilled) {
                        result = true; 
                    } 
                }
 
                if (valueType == typeof(SqlBytes)) {
                    SqlBytes sqlValue = (SqlBytes) value;
                    if (!sqlValue.IsFilled) {
                        result = true; 
                    }
                } 
            } 

            return result; 
        }
#endif

        internal void Prepare(SqlCommand cmd) { // MDAC 67063 
            if (null == _metaType) {
                throw ADP.PrepareParameterType(cmd); 
            } 
            else if (!ShouldSerializeSize() && !_metaType.IsFixed) {
                throw ADP.PrepareParameterSize(cmd); 
            }
            else if ( (!ShouldSerializePrecision() && !ShouldSerializeScale()) &&  (_metaType.SqlDbType == SqlDbType.Decimal) ) {
                throw ADP.PrepareParameterScale(cmd, SqlDbType.ToString());
            } 
        }
 
        private void PropertyChanging () { 
            _internalMetaType = null;
        } 

        private void PropertyTypeChanging () {
            PropertyChanging();
            CoercedValue = null; 
        }
 
        internal void SetSqlBuffer (SqlBuffer buff){ 
            _sqlBufferReturnValue = buff;
            _value = null; 
            _coercedValue = null;
            _udtLoadError = null;
        }
 
        internal void SetUdtLoadError(Exception e) { // SQL BU DT 329981
            _udtLoadError = e; 
        } 

#if WINFSFunctionality 
        internal void Validate(int index, bool isWinFS) {
#else
        internal void Validate(int index, bool isCommandProc) {
#endif 
            MetaType metaType = GetMetaTypeOnly();
            _internalMetaType = metaType; 
 
            if (ADP.IsDirection(this, ParameterDirection.Output) &&
                !ADP.IsDirection(this, ParameterDirection.ReturnValue) && // SQL BU DT 372370 
                (!metaType.IsFixed) &&
                !ShouldSerializeSize() &&
                ((null == _value) || Convert.IsDBNull(_value)) &&
                (SqlDbType != SqlDbType.Timestamp) && 
                (SqlDbType != SqlDbType.Udt) &&
                !metaType.IsVarTime) { 
 
                throw ADP.UninitializedParameterSize(index, metaType.ClassType);
            } 

            if (metaType.SqlDbType != SqlDbType.Udt && Direction != ParameterDirection.Output) {
#if WINFSFunctionality
                GetCoercedValue(isWinFS); 
#else
                GetCoercedValue(); 
#endif 
            }
 
            //check if the UdtTypeName is specified for Udt params
            if (metaType.SqlDbType == SqlDbType.Udt) {
                if (ADP.IsEmpty (UdtTypeName))
                    throw SQL.MustSetUdtTypeNameForUdtParams (); 
            }
            else if (!ADP.IsEmpty (UdtTypeName)) { 
                throw SQL.UnexpectedUdtTypeNameForNonUdtParams(); 
            }
 
            // Validate structured-type-specific details.
            if (metaType.SqlDbType == SqlDbType.Structured) {
                if (!isCommandProc && ADP.IsEmpty (TypeName))
                    throw SQL.MustSetTypeNameForParam(metaType.TypeName, this.ParameterName); 

                if (ParameterDirection.Input != this.Direction) { 
                    throw SQL.UnsupportedTVPOutputParameter(this.Direction, this.ParameterName); 
                }
 
                if (DBNull.Value == GetCoercedValue()) {
                    throw SQL.DBNullNotSupportedForTVPValues(this.ParameterName);
                }
            } 
            else if (!ADP.IsEmpty (TypeName)) {
                throw SQL.UnexpectedTypeNameForNonStructParams(this.ParameterName); 
            } 
        }
 
        // func will change type to that with a 4 byte length if the type has a two
        // byte length and a parameter length > than that expressable in 2 bytes
#if WINFSFunctionality
        internal MetaType ValidateTypeLengths(bool yukonOrNewer, bool isWinFS) { 
#else
        internal MetaType ValidateTypeLengths(bool yukonOrNewer) { 
#endif 
            MetaType mt = InternalMetaType;
            // MDAC bug #50839 + #52829 : Since the server will automatically reject any 
            // char, varchar, binary, varbinary, nchar, or nvarchar parameter that has a
            // byte size > 8000 bytes, we promote the parameter to image, text, or ntext.  This
            // allows the user to specify a parameter type using a COM+ datatype and be able to
            // use that parameter against a BLOB column. 
            if ((SqlDbType.Udt != mt.SqlDbType) && (false == mt.IsFixed) && (false == mt.IsLong)) { // if type has 2 byte length
#if WINFSFunctionality 
                int actualSize = this.GetActualSize(isWinFS); 
#else
                int actualSize = this.GetActualSize(); 
#endif
                int size = this.Size;

                int maxSize = (size > actualSize) ? size : actualSize; 
                if ((maxSize > TdsEnums.TYPE_SIZE_LIMIT) || (size == -1) || (actualSize == -1)) { // is size > size able to be described by 2 bytes
                    if (yukonOrNewer) { 
                        // Convert the parameter to its max type 
                        mt = MetaType.GetMaxMetaTypeFromMetaType(mt);
                        _metaType = mt; 
                        InternalMetaType = mt;
                        if (!mt.IsPlp) {
                            if (mt.SqlDbType == SqlDbType.Xml) {
                                throw ADP.InvalidMetaDataValue();     //Xml should always have IsPartialLength = true 
                            }
                            if (mt.SqlDbType == SqlDbType.NVarChar 
                             || mt.SqlDbType == SqlDbType.VarChar 
                             || mt.SqlDbType == SqlDbType.VarBinary) {
                                Size = (int)(SmiMetaData.UnlimitedMaxLengthIndicator); 
                            }
                        }
                    }
                    else { 
                        switch (mt.SqlDbType) { // widening the SqlDbType is automatic
                        case SqlDbType.Binary: 
                        case SqlDbType.VarBinary: 
                            mt = MetaType.GetMetaTypeFromSqlDbType (SqlDbType.Image, false);
                            _metaType = mt; // do not use SqlDbType property which calls PropertyTypeChanging resetting coerced value 
                            InternalMetaType = mt;
                            break;
                        case SqlDbType.Char:
                        case SqlDbType.VarChar: 
                            mt = MetaType.GetMetaTypeFromSqlDbType (SqlDbType.Text, false);
                            _metaType = mt; 
                            InternalMetaType = mt; 
                            break;
                        case SqlDbType.NChar: 
                        case SqlDbType.NVarChar:
                            mt = MetaType.GetMetaTypeFromSqlDbType (SqlDbType.NText, false);
                            _metaType = mt;
                            InternalMetaType = mt; 
                            break;
                        default: 
                            Debug.Assert(false, "Missed metatype in SqlCommand.BuildParamList()"); 
                            break;
                        } 
                    }
                }
            }
            return mt; 
        }
 
        private byte ValuePrecision(object value) { 
            if (value is SqlDecimal) {
                if (((SqlDecimal) value).IsNull) // MDAC #79648 
                    return 0;

                return ((SqlDecimal)value).Precision;
            } 
            return ValuePrecisionCore(value);
        } 
 
        private byte ValueScale(object value) {
            if (value is SqlDecimal) { 
                if (((SqlDecimal) value).IsNull) // MDAC #79648
                    return 0;

                return ((SqlDecimal) value).Scale; 
            }
            return ValueScaleCore(value); 
        } 

        private int ValueSize(object value) { 
            if (value is SqlString) {
                if (((SqlString) value).IsNull) // MDAC #79648
                    return 0;
 
                return ((SqlString) value).Value.Length;
            } 
            if (value is SqlChars) { 
                if (((SqlChars) value).IsNull)
                    return 0; 

                return ((SqlChars) value).Value.Length;
            }
 
            if (value is SqlBinary) {
                if (((SqlBinary) value).IsNull) // MDAC #79648 
                    return 0; 

                return ((SqlBinary) value).Length; 
            }
            if (value is SqlBytes) {
                if (((SqlBytes) value).IsNull)
                    return 0; 

                return (int)(((SqlBytes) value).Length); 
            } 
            return ValueSizeCore(value);
        } 

        //

        // parse an string of the form db.schema.name where any of the three components 
        // might have "[" "]" and dots within it.
        // returns: 
        //   [0] dbname (or null) 
        //   [1] schema (or null)
        //   [2] name 
        // NOTE: if perf/space implications of Regex is not a problem, we can get rid
        // of this and use a simple regex to do the parsing
        internal static string[] ParseTypeName(string typeName, bool isUdtTypeName) {
            Debug.Assert(null != typeName, "null typename passed to ParseTypeName"); 

            try { 
                string errorMsg; 
                if (isUdtTypeName) {
                    errorMsg = Res.SQL_UDTTypeName; 
                }
                else {
                    errorMsg = Res.SQL_TypeName;
                } 
                return MultipartIdentifier.ParseMultipartIdentifier(typeName, "[\"", "]\"", '.', 3, true, errorMsg, true);
            } 
            catch (ArgumentException) { 
                if (isUdtTypeName) {
                    throw SQL.InvalidUdt3PartNameFormat(); 
                }
                else {
                    throw SQL.InvalidParameterTypeNameFormat();
                } 
            }
        } 
 
        sealed internal class SqlParameterConverter : ExpandableObjectConverter {
 
            // converter classes should have public ctor
            public SqlParameterConverter() {
            }
 
            override public bool CanConvertTo(ITypeDescriptorContext context, Type destinationType) {
                if (typeof(System.ComponentModel.Design.Serialization.InstanceDescriptor) == destinationType) { 
                    return true; 
                }
                return base.CanConvertTo(context, destinationType); 
            }

            override public object ConvertTo(ITypeDescriptorContext context, CultureInfo culture, object value, Type destinationType) {
                if (destinationType == null) { 
                    throw ADP.ArgumentNull("destinationType");
                } 
                if ((typeof(System.ComponentModel.Design.Serialization.InstanceDescriptor) == destinationType) && (value is SqlParameter)) { 
                    return ConvertToInstanceDescriptor(value as SqlParameter);
                } 
                return base.ConvertTo(context, culture, value, destinationType);
            }

            private System.ComponentModel.Design.Serialization.InstanceDescriptor ConvertToInstanceDescriptor(SqlParameter p) { 
                // MDAC 67321 - reducing parameter generated code
                int flags = 0; // if part of the collection - the parametername can't be empty 
 
                if (p.ShouldSerializeSqlDbType()) {
                    flags |= 1; 
                }
                if (p.ShouldSerializeSize()) {
                    flags |= 2;
                } 
                if (!ADP.IsEmpty(p.SourceColumn)) {
                    flags |= 4; 
                } 
                if (null != p.Value) {
                    flags |= 8; 
                }
                if ((ParameterDirection.Input != p.Direction) || p.IsNullable
                    || p.ShouldSerializePrecision() || p.ShouldSerializeScale()
                    || (DataRowVersion.Current != p.SourceVersion) 
                    ) {
                     flags |= 16; // v1.0 everything 
                } 

                if (p.SourceColumnNullMapping || !ADP.IsEmpty(p.XmlSchemaCollectionDatabase) || 
                    !ADP.IsEmpty(p.XmlSchemaCollectionOwningSchema) || !ADP.IsEmpty(p.XmlSchemaCollectionName)) {
                    flags |= 32; // v2.0 everything
                }
 
                Type[] ctorParams;
                object[] ctorValues; 
                switch(flags) { 
                case  0: // ParameterName
                case  1: // SqlDbType 
                    ctorParams = new Type[] { typeof(string), typeof(SqlDbType) };
                    ctorValues = new object[] { p.ParameterName, p.SqlDbType };
                    break;
                case  2: // Size 
                case  3: // Size, SqlDbType
                    ctorParams = new Type[] { typeof(string), typeof(SqlDbType), typeof(int) }; 
                    ctorValues = new object[] { p.ParameterName, p.SqlDbType, p.Size }; 
                    break;
                case  4: // SourceColumn 
                case  5: // SourceColumn, SqlDbType
                case  6: // SourceColumn, Size
                case  7: // SourceColumn, Size, SqlDbType
                    ctorParams = new Type[] { typeof(string), typeof(SqlDbType), typeof(int), typeof(string) }; 
                    ctorValues = new object[] { p.ParameterName, p.SqlDbType, p.Size, p.SourceColumn };
                    break; 
                case  8: // Value 
                    ctorParams = new Type[] { typeof(string), typeof(object) };
                    ctorValues = new object[] { p.ParameterName, p.Value }; 
                    break;
                default:
                    if (0 == (32 & flags)) { // v1.0 everything
                        ctorParams = new Type[] { 
                                                    typeof(string), typeof(SqlDbType), typeof(int), typeof(ParameterDirection),
                                                    typeof(bool), typeof(byte), typeof(byte), 
                                                    typeof(string), typeof(DataRowVersion), 
                                                    typeof(object) };
                        ctorValues = new object[] { 
                                                      p.ParameterName, p.SqlDbType,  p.Size, p.Direction,
                                                      p.IsNullable, p.PrecisionInternal, p.ScaleInternal,
                                                      p.SourceColumn, p.SourceVersion,
                                                      p.Value }; 
                    }
                    else { // v2.0 everything - round trip all browsable properties + precision/scale 
                        ctorParams = new Type[] { 
                                                    typeof(string), typeof(SqlDbType), typeof(int), typeof(ParameterDirection),
                                                    typeof(byte), typeof(byte), 
                                                    typeof(string), typeof(DataRowVersion), typeof(bool),
                                                    typeof(object),
                                                    typeof(string), typeof(string),
                                                    typeof(string) }; 
                        ctorValues = new object[] {
                                                      p.ParameterName, p.SqlDbType,  p.Size, p.Direction, 
                                                      p.PrecisionInternal, p.ScaleInternal, 
                                                      p.SourceColumn, p.SourceVersion, p.SourceColumnNullMapping,
                                                      p.Value, 
                                                      p.XmlSchemaCollectionDatabase, p.XmlSchemaCollectionOwningSchema,
                                                      p.XmlSchemaCollectionName};
                    }
                    break; 
                }
                System.Reflection.ConstructorInfo ctor = typeof(SqlParameter).GetConstructor(ctorParams); 
                return new System.ComponentModel.Design.Serialization.InstanceDescriptor(ctor, ctorValues); 
            }
        } 

    }
}

// File provided for Reference Use Only by Microsoft Corporation (c) 2007.
//------------------------------------------------------------------------------ 
// 
//     Copyright (c) Microsoft Corporation.  All rights reserved.
// 
// [....] 
// [....]
//----------------------------------------------------------------------------- 
 
namespace System.Data.SqlClient {
 
    using System;
    using System.ComponentModel;
    using System.Collections.Generic;
    using System.Data; 
    using System.Data.Common;
    using System.Data.ProviderBase; 
    using System.Data.Sql; 
    using System.Data.SqlTypes;
    using System.Diagnostics; 
    using System.IO;
    using System.Globalization;
    using System.Reflection;
    using System.Text; 
    using System.Xml;
    using MSS=Microsoft.SqlServer.Server; 
 
    using Microsoft.SqlServer.Server;
 

    [
    System.ComponentModel.TypeConverterAttribute(typeof(System.Data.SqlClient.SqlParameter.SqlParameterConverter))
    ] 
#if WINFSInternalOnly
    internal 
#else 
    public
#endif 
    sealed partial class SqlParameter : DbParameter, IDbDataParameter, ICloneable {
        private MetaType              _metaType;

        private SqlCollation          _collation; 
        private string                _xmlSchemaCollectionDatabase;
        private string                _xmlSchemaCollectionOwningSchema; 
        private string                _xmlSchemaCollectionName; 

        private string                _udtTypeName; 
        private string                _typeName;
        private Type                  _udtType;
        private Exception             _udtLoadError;
 
        private string                _parameterName;
        private byte                  _precision; 
        private byte                  _scale; 
        private bool                  _hasScale; // V1.0 compat, ignore _hasScale
 
        private MetaType              _internalMetaType;
        private SqlBuffer             _sqlBufferReturnValue;
        private bool                  _isSqlParameterSqlType;
 
        public SqlParameter() : base() {
        } 
 
        [ EditorBrowsableAttribute(EditorBrowsableState.Advanced) ] // MDAC 69508
        public SqlParameter(string parameterName, 
                            SqlDbType dbType, int size,
                            ParameterDirection direction, bool isNullable,
                            byte precision, byte scale,
                            string sourceColumn, DataRowVersion sourceVersion, 
                            object value) : this() { // V1.0 everything
            this.ParameterName = parameterName; 
            this.SqlDbType = dbType; 
            this.Size = size;
            this.Direction = direction; 
            this.IsNullable = isNullable;
            PrecisionInternal = precision;
            ScaleInternal = scale;
            this.SourceColumn = sourceColumn; 
            this.SourceVersion = sourceVersion;
            this.Value = value; 
        } 
        public SqlParameter(string parameterName,
                               SqlDbType dbType, int size, 
                               ParameterDirection direction,
                               byte precision, byte scale,
                               string sourceColumn, DataRowVersion sourceVersion, bool sourceColumnNullMapping,
                               object value, 
                               string xmlSchemaCollectionDatabase, string xmlSchemaCollectionOwningSchema,
                               string xmlSchemaCollectionName 
                               ) { // V2.0 everything - round trip all browsable properties + precision/scale 
            this.ParameterName = parameterName;
            this.SqlDbType = dbType; 
            this.Size = size;
            this.Direction = direction;
            this.PrecisionInternal = precision;
            this.ScaleInternal = scale; 
            this.SourceColumn = sourceColumn;
            this.SourceVersion = sourceVersion; 
            this.SourceColumnNullMapping = sourceColumnNullMapping; 
            this.Value = value;
            this._xmlSchemaCollectionDatabase = xmlSchemaCollectionDatabase; 
            this._xmlSchemaCollectionOwningSchema = xmlSchemaCollectionOwningSchema;
            this._xmlSchemaCollectionName = xmlSchemaCollectionName;
        }
        public SqlParameter(string parameterName, SqlDbType dbType) : this() { 
            this.ParameterName = parameterName;
            this.SqlDbType = dbType; 
        } 

        public SqlParameter(string parameterName, object value) : this() { 
            Debug.Assert(!(value is SqlDbType), "use SqlParameter(string, SqlDbType)");

            this.ParameterName = parameterName;
            this.Value = value; 
        }
 
        public SqlParameter(string parameterName, SqlDbType dbType, int size) : this() { 
            this.ParameterName = parameterName;
            this.SqlDbType = dbType; 
            this.Size = size;
        }

        public SqlParameter(string parameterName, SqlDbType dbType, int size, string sourceColumn) : this() { 
            this.ParameterName = parameterName;
            this.SqlDbType = dbType; 
            this.Size = size; 
            this.SourceColumn = sourceColumn;
        } 

        //
        // currently the user can't set this value.  it gets set by the returnvalue from tds
        // 
        internal SqlCollation Collation {
            get { 
                return _collation; 
            }
            set { 
                _collation = value;
            }
        }
 
        [
        Browsable(false), 
        ] 
        public SqlCompareOptions CompareInfo {
            // Bits 21 through 25 represent the CompareInfo 
            get {
                SqlCollation collation = _collation;
                if (null != collation) {
                    return collation.SqlCompareOptions; 
                }
                return SqlCompareOptions.None; 
            } 
            set {
                SqlCollation collation = _collation; 
                if (null == collation) {
                    _collation = collation = new SqlCollation();
                }
                if ((value & SqlString.x_iValidSqlCompareOptionMask) != value) { 
                    throw ADP.ArgumentOutOfRange("CompareInfo");
                } 
                collation.SqlCompareOptions = value; 
            }
        } 

        [
        ResCategoryAttribute(Res.DataCategory_Xml),
        ResDescriptionAttribute(Res.SqlParameter_XmlSchemaCollectionDatabase), 
        ]
        public string  XmlSchemaCollectionDatabase { 
            get { 
                string xmlSchemaCollectionDatabase = _xmlSchemaCollectionDatabase;
                return ((xmlSchemaCollectionDatabase != null) ? xmlSchemaCollectionDatabase : ADP.StrEmpty); 
            }
            set {
                _xmlSchemaCollectionDatabase = value;
            } 
        }
 
        [ 
        ResCategoryAttribute(Res.DataCategory_Xml),
        ResDescriptionAttribute(Res.SqlParameter_XmlSchemaCollectionOwningSchema), 
        ]
        public string XmlSchemaCollectionOwningSchema {
            get {
                string xmlSchemaCollectionOwningSchema = _xmlSchemaCollectionOwningSchema; 
                return ((xmlSchemaCollectionOwningSchema != null) ? xmlSchemaCollectionOwningSchema : ADP.StrEmpty);
            } 
            set { 
                _xmlSchemaCollectionOwningSchema = value;
            } 
        }

        [
        ResCategoryAttribute(Res.DataCategory_Xml), 
        ResDescriptionAttribute(Res.SqlParameter_XmlSchemaCollectionName),
        ] 
        public string XmlSchemaCollectionName { 
            get {
                string xmlSchemaCollectionName = _xmlSchemaCollectionName; 
                return ((xmlSchemaCollectionName != null) ? xmlSchemaCollectionName : ADP.StrEmpty);
            }
            set {
                _xmlSchemaCollectionName = value; 
            }
        } 
 
        override public DbType DbType {
            get { 
                return GetMetaTypeOnly().DbType;
            }
            set {
                MetaType metatype = _metaType; 
                if ((null == metatype) || (metatype.DbType != value) ||
                        // SQLBU 504029: Two special datetime cases for backward compat 
                        //  DbType.Date and DbType.Time should always be treated as setting DbType.DateTime instead 
                        value == DbType.Date ||
                        value == DbType.Time) { 
                    PropertyTypeChanging();
                    _metaType = MetaType.GetMetaTypeFromDbType(value);
                }
            } 
        }
 
        public override void ResetDbType() { 
            ResetSqlDbType();
        } 

        internal MetaType InternalMetaType {
            get {
                Debug.Assert(null != _internalMetaType, "null InternalMetaType"); 
                return _internalMetaType;
            } 
            set { _internalMetaType = value; } 
        }
 
        [
        Browsable(false),
        ]
        public int LocaleId { 
            // Lowest 20 bits represent LocaleId
            get { 
                SqlCollation collation = _collation; 
                if (null != collation) {
                    return collation.LCID; 
                }
                return 0;
            }
            set { 
                SqlCollation collation = _collation;
                if (null == collation) { 
                    _collation = collation = new SqlCollation(); 
                }
                if (value != (SqlCollation.MaskLcid & value)) { 
                    throw ADP.ArgumentOutOfRange("LocaleId");
                }
                collation.LCID = value;
            } 
        }
 
        private SqlMetaData MetaData { 
            get {
                MetaType mt = GetMetaTypeOnly(); 
 			    long maxlen;

				if (mt.IsFixed) {
					maxlen = (long)mt.FixedLength; 
				}
                else if (Size > 0 || Size < 0) { 
                   	maxlen = Size;   // Bug Fix: 302768, 302695, 302694, 302693 
                }
 				else { 
					maxlen = MSS.SmiMetaData.GetDefaultForType( mt.SqlDbType ).MaxLength;
 				}
                return new SqlMetaData(this.ParameterName, mt.SqlDbType, maxlen, GetActualPrecision(), GetActualScale(), LocaleId, CompareInfo,
                                       XmlSchemaCollectionDatabase, XmlSchemaCollectionOwningSchema, XmlSchemaCollectionName, mt.IsPlp, _udtType); 
            }
        } 
 
        internal bool SizeInferred {
            get { 
                return 0 == _size;
            }
        }
 
        internal MSS.SmiParameterMetaData MetaDataForSmi(out ParameterPeekAheadValue peekAhead) {
            peekAhead = null; 
#if WINFSFunctionality 
            MetaType mt = ValidateTypeLengths( true /* Yukon or newer */, false ); // SMI does not yet support LazyMat.
            long actualLen = GetActualSize( false );  // no lazy mat, yet 
#else
            MetaType mt = ValidateTypeLengths( true /* Yukon or newer */ );
            long actualLen = GetActualSize( );
#endif 
            long maxLen = this.Size;
 
            // GetActualSize returns bytes length, but smi expects char length for 
            //  character types, so adjust
            if ( !mt.IsLong ) { 
                if ( SqlDbType.NChar == mt.SqlDbType || SqlDbType.NVarChar == mt.SqlDbType ) {
                    actualLen = actualLen / sizeof( char );
                }
 
                if ( actualLen > maxLen ) {
                    maxLen = actualLen; 
                } 
            }
 
            // Determine maxLength for types that ValidateTypeLengths won't figure out
            if ( 0 == maxLen  ) {
                if ( SqlDbType.Binary == mt.SqlDbType || SqlDbType.VarBinary == mt.SqlDbType ) {
                    maxLen = MSS.SmiMetaData.MaxBinaryLength; 
                }
                else if ( SqlDbType.Char == mt.SqlDbType || SqlDbType.VarChar == mt.SqlDbType ) { 
                    maxLen = MSS.SmiMetaData.MaxANSICharacters; 
                }
                else if ( SqlDbType.NChar == mt.SqlDbType || SqlDbType.NVarChar == mt.SqlDbType ) { 
                    maxLen = MSS.SmiMetaData.MaxUnicodeCharacters;
                }
            }
            else if (( maxLen > MSS.SmiMetaData.MaxBinaryLength     && ( SqlDbType.Binary == mt.SqlDbType || SqlDbType.VarBinary == mt.SqlDbType )) 
                  || ( maxLen > MSS.SmiMetaData.MaxANSICharacters   && ( SqlDbType.Char   == mt.SqlDbType || SqlDbType.VarChar   == mt.SqlDbType ))
                  || ( maxLen > MSS.SmiMetaData.MaxUnicodeCharacters&& ( SqlDbType.NChar  == mt.SqlDbType || SqlDbType.NVarChar  == mt.SqlDbType )) ) { 
                maxLen = -1; 
            }
 

            int localeId = LocaleId;
            if ( 0 == localeId && mt.IsCharType ) {
#if WINFSFunctionality 
                object value = GetCoercedValue(false); // SMI does not yet support LazyMat.
#else 
                object value = GetCoercedValue(); 
#endif
                if ( value is SqlString && !( (SqlString)value ).IsNull ) { 
                    localeId = ( (SqlString)value ).LCID;
                }
                else {
                    localeId = System.Globalization.CultureInfo.CurrentCulture.LCID; 
                }
            } 
 
            SqlCompareOptions compareOpts = CompareInfo;
            if ( 0 == compareOpts && mt.IsCharType ) { 
#if WINFSFunctionality
                object value = GetCoercedValue(false); // SMI does not yet support LazyMat.
#else
                object value = GetCoercedValue(); 
#endif
                if ( value is SqlString && !( (SqlString)value ).IsNull ) { 
                    compareOpts = ( (SqlString)value ).SqlCompareOptions; 
                }
                else { 
                    compareOpts = MSS.SmiMetaData.GetDefaultForType( mt.SqlDbType ).CompareOptions;
                }
            }
 
            string typeSpecificNamePart1 = null;
            string typeSpecificNamePart2 = null; 
            string typeSpecificNamePart3 = null; 

            if (SqlDbType.Xml == mt.SqlDbType) { 
                typeSpecificNamePart1 = this.XmlSchemaCollectionDatabase;
                typeSpecificNamePart2 = this.XmlSchemaCollectionOwningSchema;
                typeSpecificNamePart3 = this.XmlSchemaCollectionName;
            } 
            else if (SqlDbType.Udt == mt.SqlDbType || (SqlDbType.Structured == mt.SqlDbType && !ADP.IsEmpty(this.TypeName))) {
                // Split the input name. The type name is specified as single 3 part name. 
                // NOTE: ParseTypeName throws if format is incorrect 
                String[] names;
                if (SqlDbType.Udt == mt.SqlDbType) { 
                    names = ParseTypeName(this.UdtTypeName, true /* is UdtTypeName */);
                }
                else {
                    names = ParseTypeName(this.TypeName, false /* not UdtTypeName */); 
                }
 
                if (1 == names.Length) { 
                    typeSpecificNamePart3 = names[0];
                } 
                else if (2 == names.Length) {
                    typeSpecificNamePart2 = names[0];
                    typeSpecificNamePart3 = names[1];
                } 
                else if (3 == names.Length) {
                    typeSpecificNamePart1 = names[0]; 
                    typeSpecificNamePart2 = names[1]; 
                    typeSpecificNamePart3 = names[2];
                } 
                else {
                    throw ADP.ArgumentOutOfRange("names");
                }
 
                if ((!ADP.IsEmpty(typeSpecificNamePart1) && TdsEnums.MAX_SERVERNAME < typeSpecificNamePart1.Length)
                    || (!ADP.IsEmpty(typeSpecificNamePart2) && TdsEnums.MAX_SERVERNAME < typeSpecificNamePart2.Length) 
                    || (!ADP.IsEmpty(typeSpecificNamePart3) && TdsEnums.MAX_SERVERNAME < typeSpecificNamePart3.Length)) { 
                    throw ADP.ArgumentOutOfRange("names");
                } 
            }

            byte precision = GetActualPrecision();
            byte scale = GetActualScale(); 

            // precision for decimal types may still need adjustment. 
            if ( SqlDbType.Decimal == mt.SqlDbType ) { 
                if ( 0 == precision ) {
                    precision = TdsEnums.DEFAULT_NUMERIC_PRECISION; 
                }
            }

            // Sub-field determination 
            List fields = null;
            MSS.SmiMetaDataPropertyCollection extendedProperties = null; 
            if (SqlDbType.Structured == mt.SqlDbType) { 
                GetActualFieldsAndProperties(out fields, out extendedProperties, out peekAhead);
            } 

            return new MSS.SmiParameterMetaData( mt.SqlDbType,
                                            maxLen,
                                            precision, 
                                            scale,
                                            localeId, 
                                            compareOpts, 
                                            null,           // Udt type not used for parameters
                                            SqlDbType.Structured == mt.SqlDbType, 
                                            fields,
                                            extendedProperties,
                                            this.ParameterNameFixed,
                                            typeSpecificNamePart1, 
                                            typeSpecificNamePart2,
                                            typeSpecificNamePart3, 
                                            this.Direction); 
        }
 
        internal bool ParamaterIsSqlType {
            get {
                return _isSqlParameterSqlType;
                } 
            set {
                    _isSqlParameterSqlType = value; 
                } 
        }
 
        [
        ResCategoryAttribute(Res.DataCategory_Data),
        ResDescriptionAttribute(Res.SqlParameter_ParameterName),
        ] 
        override public string ParameterName {
            get { 
                string parameterName = _parameterName; 
                return ((null != parameterName) ? parameterName : ADP.StrEmpty);
            } 
            set {
                if (ADP.IsEmpty(value) || (value.Length < TdsEnums.MAX_PARAMETER_NAME_LENGTH)
                    || (('@' == value[0]) && (value.Length <= TdsEnums.MAX_PARAMETER_NAME_LENGTH))) {
                    if (_parameterName != value) { 
                        PropertyChanging();
                        _parameterName = value; 
                    } 
                }
                else { 
                    throw SQL.InvalidParameterNameLength(value);
                }
            }
        } 

        internal string ParameterNameFixed { 
            get { 
                string parameterName = ParameterName;
                if ((0 < parameterName.Length) && ('@' != parameterName[0])) { 
                    parameterName = "@" + parameterName;
                }
                Debug.Assert(parameterName.Length <= TdsEnums.MAX_PARAMETER_NAME_LENGTH, "parameter name too long");
                return parameterName; 
            }
        } 
 
        [DefaultValue((Byte)0)] // MDAC 65862
        [ResCategoryAttribute(Res.DataCategory_Data)] 
        [ResDescriptionAttribute(Res.DbDataParameter_Precision)]
        public Byte Precision {
            get {
                return PrecisionInternal; 
            }
            set { 
                PrecisionInternal = value; 
            }
        } 

        internal byte PrecisionInternal {
            get {
                byte precision = _precision; 
                SqlDbType dbtype = GetMetaSqlDbTypeOnly();
                if ((0 == precision) && (SqlDbType.Decimal == dbtype)) { 
                    precision = ValuePrecision(SqlValue); 
                }
                return precision; 
            }
            set {
                SqlDbType sqlDbType = SqlDbType;
                if (SqlDbType.Float == sqlDbType) { 
                 if (value > TdsEnums.MAX_FLOAT_PRECISION)
                    throw SQL.PrecisionValueOutOfRange(value); 
               } 
               else
               if (SqlDbType.Real == sqlDbType) { 
                 if (value > TdsEnums.MAX_REAL_PRECISION)
                    throw SQL.PrecisionValueOutOfRange(value);
               }
               else 
                if (value > TdsEnums.MAX_NUMERIC_PRECISION) {
                    throw SQL.PrecisionValueOutOfRange(value); 
                } 
                if (_precision != value) {
                    PropertyChanging(); 
                    _precision = value;
                }
            }
        } 

        private bool ShouldSerializePrecision() { 
            return (0 != _precision); 
        }
 
        [DefaultValue((Byte)0)] // MDAC 65862
        [ResCategoryAttribute(Res.DataCategory_Data)]
        [ResDescriptionAttribute(Res.DbDataParameter_Scale)]
        public Byte Scale { 
            get {
                return ScaleInternal; 
            } 
            set {
                ScaleInternal = value; 
            }
        }
        internal byte ScaleInternal {
            get { 
                byte scale = _scale;
                SqlDbType dbtype = GetMetaSqlDbTypeOnly(); 
                if ((0 == scale) && (SqlDbType.Decimal == dbtype)) { 
                    scale = ValueScale(SqlValue);
                } 
                return scale;
            }
            set {
                if (_scale != value || !_hasScale) { 
                    PropertyChanging();
                    _scale = value; 
                    _hasScale = true; 
                }
            } 
        }

        private bool ShouldSerializeScale() {
            return (0 != _scale); // V1.0 compat, ignore _hasScale 
        }
 
        [ 
        RefreshProperties(RefreshProperties.All),
        ResCategoryAttribute(Res.DataCategory_Data), 
        ResDescriptionAttribute(Res.SqlParameter_SqlDbType),
        System.Data.Common.DbProviderSpecificTypePropertyAttribute(true),
        ]
        public SqlDbType SqlDbType { 
            get {
                return GetMetaTypeOnly().SqlDbType; 
            } 
            set {
                MetaType metatype = _metaType; 
                // HACK!!!
                // We didn't want to expose SmallVarBinary on SqlDbType so we
                // stuck it at the end of SqlDbType in v1.0, except that now
                // we have new data types after that and it's smack dab in the 
                // middle of the valid range.  To prevent folks from setting
                // this invalid value we have to have this code here until we 
                // can take the time to fix it later. 
                if ((SqlDbType)TdsEnums.SmallVarBinary == value) {
                    throw SQL.InvalidSqlDbType(value); 
                }
                if ((null == metatype) || (metatype.SqlDbType != value)) {
                    PropertyTypeChanging();
                    _metaType = MetaType.GetMetaTypeFromSqlDbType(value, value == SqlDbType.Structured); 
                }
            } 
        } 

        private bool ShouldSerializeSqlDbType() { 
            return (null != _metaType);
        }

        public void ResetSqlDbType() { 
            if (null != _metaType) {
                PropertyTypeChanging(); 
                _metaType = null; 
            }
        } 

        [
        Browsable(false),
        DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden), 
        ]
        public object SqlValue { 
            get { 
                if (_udtLoadError != null) { // SQL BU DT 329981
                    throw _udtLoadError; 
                }

                if (_value != null) {
                    if (_value == DBNull.Value) { 
                        return MetaType.GetNullSqlValue(GetMetaTypeOnly().SqlType);
                    } 
                    if (_value is INullable) { 
                          return _value;
                    } 

                    // SQLBU 503165: for Date and DateTime2, return the CLR object directly without converting it to a SqlValue
                    // SQLBU 527900: GetMetaTypeOnly() will convert _value to a string in the case of char or char[], so only check
                    //               the SqlDbType for DateTime. This is the only case when we might return the CLR value directly. 
                    if (_value is DateTime) {
                        SqlDbType sqlDbType = GetMetaTypeOnly().SqlDbType; 
                        if (sqlDbType == SqlDbType.Date || sqlDbType == SqlDbType.DateTime2) { 
                            return _value;
                        } 
                    }

                    return (MetaType.GetSqlValueFromComVariant(_value));
                } 
                else if (_sqlBufferReturnValue != null) {
                    return _sqlBufferReturnValue.SqlValue; 
                } 
                return null;
            } 
            set {
                Value = value;
            }
        } 

        [ 
        Browsable(false), 
        EditorBrowsableAttribute(EditorBrowsableState.Advanced)
        ] 
        public String UdtTypeName {
            get {
                string typeName = _udtTypeName;
                return ((null != typeName) ? typeName : ADP.StrEmpty); 
            }
            set { 
                _udtTypeName = value; 
            }
        } 

        [
        Browsable(false),
        EditorBrowsableAttribute(EditorBrowsableState.Advanced) 
        ]
        public String TypeName { 
            get { 
                string typeName = _typeName;
                return ((null != typeName) ? typeName : ADP.StrEmpty); 
            }
            set {
                _typeName = value;
            } 
        }
 
        [ 
        RefreshProperties(RefreshProperties.All),
        ResCategoryAttribute(Res.DataCategory_Data), 
        ResDescriptionAttribute(Res.DbParameter_Value),
        TypeConverterAttribute(typeof(StringConverter)),
        ]
        override public object Value { // V1.2.3300, XXXParameter V1.0.3300 
            get {
                if (_udtLoadError != null) { // SQL BU DT 329981 
                    throw _udtLoadError; 
                }
 
                if (_value != null) {
                    return _value;
                }
                else if (_sqlBufferReturnValue != null) { 
                    if (ParamaterIsSqlType) {
                        return _sqlBufferReturnValue.SqlValue; 
                    } 
                    return _sqlBufferReturnValue.Value;
                } 
                return null;
            }
            set {
                _value = value; 
                _sqlBufferReturnValue = null;
                _coercedValue = null; 
                _isSqlParameterSqlType = _value is INullable; 
                _udtLoadError = null;
            } 
        }

        //
        // always returns data in bytes - except for non-unicode chars, which will be in number of chars 
        //
#if WINFSFunctionality 
        internal int GetActualSize(bool isWinFS) { 
#else
        internal int GetActualSize() { 
#endif
            int size = 0;
            MetaType mt = InternalMetaType;
            SqlDbType actualType = mt.SqlDbType; 
#if WINFSFunctionality
            object val = GetCoercedValue(isWinFS); 
#else 
            object val = GetCoercedValue();
#endif 
            bool isSqlVariant = false;

            //
            if (ADP.IsNull(val) && !mt.IsVarTime) { 
                return 0;
            } 
 
            // if this is a backend SQLVariant type, then infer the TDS type from the SQLVariant type
            if (actualType == SqlDbType.Variant) { 
                mt = MetaType.GetMetaTypeFromValue(val);
                actualType = MetaType.GetSqlDataType(mt.TDSType, 0 /*no user type*/, 0 /*non-nullable type*/).SqlDbType;
                isSqlVariant = true;
            } 

            if (mt.IsFixed) 
                return mt.FixedLength; 

            // @hack: until we have ForceOffset behavior we have the following semantics: 
            // @hack: if the user supplies a Size through the Size propeprty or constructor,
            // @hack: we only send a MAX of Size bytes over.  If the actualSize is < Size, then
            // @hack: we send over actualSize
            int actualSize = 0; 

            // get the actual length of the data, in bytes 
            switch (actualType) { 
            case SqlDbType.NChar:
            case SqlDbType.NVarChar: 
            case SqlDbType.NText:
            case SqlDbType.Xml:
#if WINFSFunctionality
                if (isWinFS && IsNonFilledLazyMatInstance()) { // HACK for LazyMat 
                    size = ((byte[]) val).Length;
                } 
                else 
#endif
                { 
                    actualSize = ValueSize(val);
                    size = (ShouldSerializeSize() ? Size : 0);
                    size = ((ShouldSerializeSize() && (size <= actualSize)) ? size : actualSize);
                    if (size == -1) 
                        size = actualSize;
                    size <<= 1; 
                } 
                break;
            case SqlDbType.Char: 
            case SqlDbType.VarChar:
            case SqlDbType.Text:
#if WINFSFunctionality
                if (isWinFS && IsNonFilledLazyMatInstance()) { // HACK for LazyMat 
                    size = ((byte[]) val).Length;
                } 
                else 
#endif
                { 
                    // for these types, ActualSize is the num of chars, not actual bytes - since non-unicode chars are not always uniform size
                    actualSize = ValueSize(val);
                    size = (ShouldSerializeSize() ? Size : 0);
                    size = ((ShouldSerializeSize() && (size <= actualSize)) ? size : actualSize); 
                    if (size == -1)
                        size = actualSize; 
                } 
                break;
            case SqlDbType.Binary: 
            case SqlDbType.VarBinary:
            case SqlDbType.Image:
            case SqlDbType.Timestamp:
                actualSize = ValueSize(val); 
                size = (ShouldSerializeSize() ? Size : 0);
                size = ((ShouldSerializeSize() && (size <= actualSize)) ? size : actualSize); 
                if (size == -1) 
                    size = actualSize;
                break; 
             case SqlDbType.Udt:
                //we assume that the object is UDT
                if (false == ADP.IsNull (val)) {
                    //call the static function 
#if WINFSFunctionality
                    actualSize = AssemblyCache.GetLength(val, isWinFS); 
#else 
                    actualSize = AssemblyCache.GetLength(val);
#endif 
                }
                break;
            case SqlDbType.Structured:
                actualSize = -1; 
                break;
            case SqlDbType.Time: 
                size = (isSqlVariant ? 5 : MetaType.GetTimeSizeFromScale(GetActualScale())); 
                break;
            case SqlDbType.DateTime2: 
                // Date in number of days (3 bytes) + time
                size = 3 + (isSqlVariant ? 5 : MetaType.GetTimeSizeFromScale(GetActualScale()));
                break;
            case SqlDbType.DateTimeOffset: 
                // Date in days (3 bytes) + offset in minutes (2 bytes) + time
                size = 5 + (isSqlVariant ? 5 : MetaType.GetTimeSizeFromScale(GetActualScale())); 
                break; 
            default:
                Debug.Assert(false, "Unknown variable length type!"); 
                break;
            } // switch

            // don't even send big values over to the variant 
            if (isSqlVariant && (actualSize > TdsEnums.TYPE_SIZE_LIMIT))
                throw SQL.ParameterInvalidVariant(this.ParameterName); 
 
            return size;
        } 

        object ICloneable.Clone() {
            return new SqlParameter(this);
        } 

#if WINFSFunctionality 
        private static object CoerceValue(object value, MetaType destinationType, bool isWinFS) { 
#else
        // Coerced Value is also used in SqlBulkCopy.ConvertValue(object value, _SqlMetaData metadata) 
        internal static object CoerceValue(object value, MetaType destinationType) {
#endif

            Debug.Assert(null != destinationType, "null destinationType"); 

            // Avoid coercion if null or DBNull 
            if ((null != value) && (DBNull.Value != value)) { 
                Type currentType = value.GetType();
                bool coerceValue = true; // default to true 

                // Perform INullable checks - non-trivial due to LazyMat
                if (value is INullable) {
#if WINFSFunctionality 
                    if (isWinFS &&
                         ( (typeof(SqlChars) == currentType && !((SqlChars)value).IsFilled) || 
                           (typeof(SqlBytes) == currentType && !((SqlBytes)value).IsFilled) ) ) { 
                        // If WinFS and non-filled, enter without checking other values -
                        // otherwise we will generate exception by calling those methods on non-filled instance 
                        coerceValue = true;
                    }
                    else
#endif 
                         if (((INullable)value).IsNull) {
                        coerceValue = false; 
                    } 
                }
 
                if ( coerceValue &&
                     (typeof(object) != destinationType.ClassType) &&
                     (((currentType != destinationType.ClassType) && (currentType != destinationType.SqlType) )  ||
                     (SqlDbType.Xml == destinationType.SqlDbType))) { 
                    try {
                        if ((typeof(string) == destinationType.ClassType)) { 
                            // For Xml data, destination Type is always string 
                            if (typeof(SqlXml) == currentType) {
                                value = MetaType.GetStringFromXml((XmlReader)(((SqlXml)value).CreateReader())); 
                            }
                            else if (typeof(SqlString)  == currentType) {
                                ;   // Do nothing
                            } 
                            else if (typeof(XmlReader).IsAssignableFrom(currentType)) {
                                value = MetaType.GetStringFromXml((XmlReader)value); 
                            } 
                            else if (typeof(char[]) == currentType) {
                                value = new string((char[])value); 
                            }
                            else if (typeof(SqlChars) == currentType) {
                                SqlChars chars = (SqlChars) value;
 
#if WINFSFunctionality
                                if (!chars.IsFilled) { // LazyMat - value is cookie 
                                    value = chars.Cookie; // must use internal property 
                                }
                                else 
#endif
                                {
                                    value = new string((char[])chars.Value);
                                } 
                            }
                            else { 
                                value = Convert.ChangeType(value, destinationType.ClassType, (IFormatProvider)null); 
                            }
                        } 
                        else if ((DbType.Currency == destinationType.DbType) && (typeof(string) == currentType)) {
                            value = Decimal.Parse((string)value, NumberStyles.Currency, (IFormatProvider)null); // WebData 99376
                        }
                        else if ((typeof(SqlBytes) == currentType) && (typeof(byte[]) == destinationType.ClassType)) { 
                            SqlBytes bytes = (SqlBytes) value;
 
#if WINFSFunctionality 
                            if (!bytes.IsFilled) { // LazyMat - value is cookie
                                value = bytes.Cookie; // must use internal property 
                            }
                            // no conversion, byte[] normally matches to SqlBinary
#endif
                        } 
                        else if ((typeof(string) == currentType) && (SqlDbType.Time == destinationType.SqlDbType)) {
                            value = TimeSpan.Parse((string)value); 
                        } 
                        else if ((typeof(string) == currentType) && (SqlDbType.DateTimeOffset == destinationType.SqlDbType)) {
                            value = DateTimeOffset.Parse((string)value, (IFormatProvider)null); 
                        }
                        else if ((typeof(DateTime) == currentType) && (SqlDbType.DateTimeOffset == destinationType.SqlDbType)) {
                            value = new DateTimeOffset((DateTime)value);
                        } 
                        else if (TdsEnums.SQLTABLE == destinationType.TDSType &&
                                   (value is DataTable || 
                                    value is DbDataReader || 
                                    value is System.Collections.Generic.IEnumerable)) {
                            // no conversion for TVPs. 
                        }
                        else {
                            value = Convert.ChangeType(value, destinationType.ClassType, (IFormatProvider)null);
                        } 
                    }
                    catch(Exception e) { 
                        // 
                        if (!ADP.IsCatchableExceptionType(e)) {
                            throw; 
                        }

                        throw ADP.ParameterConversionFailed(value, destinationType.ClassType, e); // WebData 75433
                    } 
                }
            } 
            return value; 
        }
 

        private void CloneHelper(SqlParameter destination) {
            CloneHelperCore(destination);
            destination._metaType     = _metaType; 
            destination._collation    = _collation;
            destination._xmlSchemaCollectionDatabase = _xmlSchemaCollectionDatabase; 
            destination._xmlSchemaCollectionOwningSchema = _xmlSchemaCollectionOwningSchema; 
            destination._xmlSchemaCollectionName = _xmlSchemaCollectionName;
            destination._udtTypeName  = _udtTypeName; 
            destination._typeName  = _typeName;
            destination._udtLoadError = _udtLoadError;

            destination._parameterName = _parameterName; 
            destination._precision = _precision;
            destination._scale = _scale; 
            destination._sqlBufferReturnValue = _sqlBufferReturnValue; 
            destination._isSqlParameterSqlType = _isSqlParameterSqlType;
            destination._internalMetaType = _internalMetaType; 
            destination.CoercedValue     = CoercedValue; // copy cached value reference because of XmlReader problem
        }

        internal byte GetActualPrecision() { 
            return ShouldSerializePrecision() ? PrecisionInternal: ValuePrecision(CoercedValue);
        } 
 
        internal byte GetActualScale() {
            if (ShouldSerializeScale()) { 
                return ScaleInternal;
            }

            // issue: how could a user specify 0 as the actual scale? 
            if (GetMetaTypeOnly().IsVarTime) {
                return TdsEnums.DEFAULT_VARTIME_SCALE; 
            } 
            return ValueScale(CoercedValue);
        } 

        internal int GetParameterSize() {
            return ShouldSerializeSize() ? Size : ValueSize(CoercedValue);
        } 

        private void GetActualFieldsAndProperties(out List fields, out SmiMetaDataPropertyCollection props, out ParameterPeekAheadValue peekAhead) { 
            fields = null; 
            props = null;
            peekAhead = null; 

            object value = GetCoercedValue();
            if (value is DataTable) {
                DataTable dt = value as DataTable; 
                if (dt.Columns.Count <= 0) {
                    throw SQL.NotEnoughColumnsInStructuredType(); 
                } 
                fields = new List(dt.Columns.Count);
                bool[] keyCols = new bool[dt.Columns.Count]; 
                bool hasKey = false;

                // set up primary key as unique key list
                //  do this prior to general metadata loop to favor the primary key 
                if (null != dt.PrimaryKey && 0 < dt.PrimaryKey.Length) {
                    foreach(DataColumn col in dt.PrimaryKey) { 
                        keyCols[col.Ordinal] = true; 
                        hasKey = true;
                    } 
                }

                for(int i=0; i(keyCols));
                } 
            }
            else if (value is SqlDataReader) {
                fields = new List(((SqlDataReader)value).GetInternalSmiMetaData());
                if (fields.Count <= 0) { 
                    throw SQL.NotEnoughColumnsInStructuredType();
                } 
 
                bool[] keyCols = new bool[fields.Count];
                bool hasKey = false; 
                for(int i=0; i(keyCols));
                } 
            }
            else if (value is IEnumerable) { 
                // must grab the first record of the enumerator to get the metadata 
                IEnumerator enumerator = ((IEnumerable) value).GetEnumerator();
                MSS.SqlDataRecord firstRecord = null; 
                try {
                    // no need for fields if there's no rows or no columns -- we'll be sending a null instance anyway.
                    if (enumerator.MoveNext()) {
                        firstRecord = enumerator.Current; 
                        int fieldCount = firstRecord.FieldCount;
                        if (0 < fieldCount) { 
                            // It's valid!  Grab those fields. 
                            bool[] keyCols = new bool[fieldCount];
                            bool[] defaultFields = new bool[fieldCount]; 
                            bool[] sortOrdinalSpecified = new bool[fieldCount];
                            int maxSortOrdinal = -1;  // largest sort ordinal seen, used to optimize locating holes in the list
                            bool hasKey = false;
                            bool hasDefault = false; 
                            int sortCount = 0;
                            SmiOrderProperty.SmiColumnOrder[] sort = new SmiOrderProperty.SmiColumnOrder[fieldCount]; 
                            fields = new List(fieldCount); 
                            for (int i = 0; i < fieldCount; i++) {
                                SqlMetaData colMeta = firstRecord.GetSqlMetaData(i); 
                                fields.Add(MSS.MetaDataUtilsSmi.SqlMetaDataToSmiExtendedMetaData(colMeta));
                                if (colMeta.IsUniqueKey) {
                                    keyCols[i] = true;
                                    hasKey = true; 
                                }
 
                                if (colMeta.UseServerDefault) { 
                                    defaultFields[i] = true;
                                    hasDefault = true; 
                                }

                                sort[i].Order = colMeta.SortOrder;
                                if (SortOrder.Unspecified != colMeta.SortOrder) { 
                                    // SqlMetaData takes care of checking for negative sort ordinals with specified sort order
 
                                    // bail early if there's no way sort order could be monotonically increasing 
                                    if (fieldCount <= colMeta.SortOrdinal) {
                                        throw SQL.SortOrdinalGreaterThanFieldCount(i, colMeta.SortOrdinal); 
                                    }

                                    // Check to make sure we haven't seen this ordinal before
                                    if (sortOrdinalSpecified[colMeta.SortOrdinal]) { 
                                        throw SQL.DuplicateSortOrdinal(colMeta.SortOrdinal);
                                    } 
 
                                    sort[i].SortOrdinal = colMeta.SortOrdinal;
                                    sortOrdinalSpecified[colMeta.SortOrdinal] = true; 
                                    if (colMeta.SortOrdinal > maxSortOrdinal) {
                                        maxSortOrdinal = colMeta.SortOrdinal;
                                    }
                                    sortCount++; 
                                }
                            } 
 
                            if (hasKey) {
                                props = new SmiMetaDataPropertyCollection(); 
                                props[MSS.SmiPropertySelector.UniqueKey] = new MSS.SmiUniqueKeyProperty(new List(keyCols));
                            }

                            if (hasDefault) { 
                                // May have already created props list in unique key handling
                                if (null == props) { 
                                    props = new SmiMetaDataPropertyCollection(); 
                                }
 
                                props[MSS.SmiPropertySelector.DefaultFields] = new MSS.SmiDefaultFieldsProperty(new List(defaultFields));
                            }

                            if (0 < sortCount) { 
                                // validate monotonically increasing sort order.
                                //  Since we already checked for duplicates, we just need 
                                //  to watch for values outside of the sortCount range. 
                                if (maxSortOrdinal >= sortCount) {
                                    // there is at least one hole, find the first one 
                                    int i;
                                    for (i = 0; i < sortCount; i++) {
                                        if (!sortOrdinalSpecified[i]) {
                                            break; 
                                        }
                                    } 
                                    Debug.Assert(i < sortCount, "SqlParameter.GetActualFieldsAndProperties: SortOrdinal hole-finding algorithm failed!"); 
                                    throw SQL.MissingSortOrdinal(i);
                                } 

                                // May have already created props list
                                if (null == props) {
                                    props = new SmiMetaDataPropertyCollection(); 
                                }
 
                                props[MSS.SmiPropertySelector.SortOrder] = new MSS.SmiOrderProperty( 
                                        new List(sort));
                            } 

                            // pack it up so we don't have to rewind to send the first value
                            peekAhead = new ParameterPeekAheadValue();
                            peekAhead.Enumerator = enumerator; 
                            peekAhead.FirstRecord = firstRecord;
 
                            // now that it's all packaged, make sure we don't dispose it. 
                            enumerator = null;
                        } 
                        else {
                            throw SQL.NotEnoughColumnsInStructuredType();
                        }
                    } 
                    else {
                        throw SQL.IEnumerableOfSqlDataRecordHasNoRows(); 
                    } 
                }
                finally { 
                    if (enumerator != null) {
                        enumerator.Dispose();
                    }
                } 
            }
            else if (value is DbDataReader) { 
                DataTable schema = ((DbDataReader)value).GetSchemaTable(); 
                if (schema.Rows.Count <= 0) {
                    throw SQL.NotEnoughColumnsInStructuredType(); 
                }

                int fieldCount = schema.Rows.Count;
                fields = new List(fieldCount); 
                bool[] keyCols = new bool[fieldCount];
                bool hasKey = false; 
                int ordinalForIsKey = schema.Columns[SchemaTableColumn.IsKey].Ordinal; 
                int ordinalForColumnOrdinal = schema.Columns[SchemaTableColumn.ColumnOrdinal].Ordinal;
                // Extract column metadata 
                for(int rowOrdinal=0; rowOrdinal= fieldCount || columnOrdinal < 0) { 
                        throw SQL.InvalidSchemaTableOrdinals();
                    } 

                    // extend empty space if out-of-order ordinal
                    while (columnOrdinal > fields.Count) {
                        fields.Add(null); 
                    }
 
                    // Now add the candidate to the list 
                    if (fields.Count == columnOrdinal) {
                        fields.Add(candidateMd); 
                    }
                    else {
                        // Disallow two columns using the same ordinal (even if due to mixing null and non-null columnOrdinals)
                        if (fields[columnOrdinal] != null) { 
                            throw SQL.InvalidSchemaTableOrdinals();
                        } 
 
                        // Don't use insert, since it shifts all later columns down a notch
                        fields[columnOrdinal] = candidateMd; 
                    }

                    // Propogate key information
                    if (!row.IsNull(ordinalForIsKey) && (bool)row[ordinalForIsKey]) { 
                        keyCols[columnOrdinal] = true;
                        hasKey = true; 
                    } 
                }
 
#if DEBUG
                // Check for holes
                //  Above loop logic prevents holes since:
                //      1) loop processes fieldcount # of columns 
                //      2) no ordinals outside continuous range from 0 to fieldcount - 1 are allowed
                //      3) no duplicate ordinals are allowed 
                // But assert no holes to be sure. 
                foreach (SmiExtendedMetaData md in fields) {
                    Debug.Assert(null != md, "Shouldn't be able to have holes, since original loop algorithm prevents such."); 
                }
#endif

                // Add unique key property, if any defined. 
                if (hasKey) {
                    props = new SmiMetaDataPropertyCollection(); 
                    props[MSS.SmiPropertySelector.UniqueKey] = new MSS.SmiUniqueKeyProperty(new List(keyCols)); 
                }
            } 
        }

#if WINFSFunctionality
        internal object GetCoercedValue(bool isWinFS) { 
#else
        internal object GetCoercedValue() { 
#endif 
            object value = CoercedValue; // will also be set during parameter Validation
            if (null == value) { 
#if WINFSFunctionality
                value = CoerceValue(Value, _internalMetaType, isWinFS);
#else
                value = CoerceValue(Value, _internalMetaType); 
#endif
                CoercedValue = value; 
            } 
            return value;
        } 

        private SqlDbType GetMetaSqlDbTypeOnly() {
            MetaType metaType = _metaType;
            if (null == metaType) { // infer the type from the value 
                metaType = MetaType.GetDefaultMetaType();
            } 
            return metaType.SqlDbType; 
        }
 
        // This may not be a good thing to do in case someone overloads the parameter type but I
        // don't want to go from SqlDbType -> metaType -> TDSType
        private MetaType GetMetaTypeOnly() {
            if (null != _metaType) { 
                return _metaType;
            } 
            if (null != _value && DBNull.Value != _value) { 
                  // We have a value set by the user then just use that value
                  // char and char[] are not directly supported so we convert those values to string 
                  Type valueType = _value.GetType ();
                  if (typeof(char) == valueType) {
                      _value = _value.ToString();
                      valueType = typeof (string); 
                  }
                  else if (typeof(char[]) == valueType) { 
                     _value = new string((char[])_value); 
                     valueType = typeof (string);
                  } 
                  return MetaType.GetMetaTypeFromType(valueType);
            }
            else if (null != _sqlBufferReturnValue) {  // value came back from the server
                 Type valueType = _sqlBufferReturnValue.GetTypeFromStorageType (_isSqlParameterSqlType); 
                 if (null != valueType) {
                     return MetaType.GetMetaTypeFromType(valueType); 
                 } 
            }
            return MetaType.GetDefaultMetaType(); 
        }

#if WINFSFunctionality
        internal bool IsNonFilledLazyMatInstance() { 
            //
            bool   result = false; 
            object value  = this.SqlValue; 

            if ((null != value) && (DBNull.Value != value)) { 
                Type valueType = value.GetType();

                if (valueType == typeof(SqlChars)) {
                    SqlChars sqlValue = (SqlChars) value; 
                    if (!sqlValue.IsFilled) {
                        result = true; 
                    } 
                }
 
                if (valueType == typeof(SqlBytes)) {
                    SqlBytes sqlValue = (SqlBytes) value;
                    if (!sqlValue.IsFilled) {
                        result = true; 
                    }
                } 
            } 

            return result; 
        }
#endif

        internal void Prepare(SqlCommand cmd) { // MDAC 67063 
            if (null == _metaType) {
                throw ADP.PrepareParameterType(cmd); 
            } 
            else if (!ShouldSerializeSize() && !_metaType.IsFixed) {
                throw ADP.PrepareParameterSize(cmd); 
            }
            else if ( (!ShouldSerializePrecision() && !ShouldSerializeScale()) &&  (_metaType.SqlDbType == SqlDbType.Decimal) ) {
                throw ADP.PrepareParameterScale(cmd, SqlDbType.ToString());
            } 
        }
 
        private void PropertyChanging () { 
            _internalMetaType = null;
        } 

        private void PropertyTypeChanging () {
            PropertyChanging();
            CoercedValue = null; 
        }
 
        internal void SetSqlBuffer (SqlBuffer buff){ 
            _sqlBufferReturnValue = buff;
            _value = null; 
            _coercedValue = null;
            _udtLoadError = null;
        }
 
        internal void SetUdtLoadError(Exception e) { // SQL BU DT 329981
            _udtLoadError = e; 
        } 

#if WINFSFunctionality 
        internal void Validate(int index, bool isWinFS) {
#else
        internal void Validate(int index, bool isCommandProc) {
#endif 
            MetaType metaType = GetMetaTypeOnly();
            _internalMetaType = metaType; 
 
            if (ADP.IsDirection(this, ParameterDirection.Output) &&
                !ADP.IsDirection(this, ParameterDirection.ReturnValue) && // SQL BU DT 372370 
                (!metaType.IsFixed) &&
                !ShouldSerializeSize() &&
                ((null == _value) || Convert.IsDBNull(_value)) &&
                (SqlDbType != SqlDbType.Timestamp) && 
                (SqlDbType != SqlDbType.Udt) &&
                !metaType.IsVarTime) { 
 
                throw ADP.UninitializedParameterSize(index, metaType.ClassType);
            } 

            if (metaType.SqlDbType != SqlDbType.Udt && Direction != ParameterDirection.Output) {
#if WINFSFunctionality
                GetCoercedValue(isWinFS); 
#else
                GetCoercedValue(); 
#endif 
            }
 
            //check if the UdtTypeName is specified for Udt params
            if (metaType.SqlDbType == SqlDbType.Udt) {
                if (ADP.IsEmpty (UdtTypeName))
                    throw SQL.MustSetUdtTypeNameForUdtParams (); 
            }
            else if (!ADP.IsEmpty (UdtTypeName)) { 
                throw SQL.UnexpectedUdtTypeNameForNonUdtParams(); 
            }
 
            // Validate structured-type-specific details.
            if (metaType.SqlDbType == SqlDbType.Structured) {
                if (!isCommandProc && ADP.IsEmpty (TypeName))
                    throw SQL.MustSetTypeNameForParam(metaType.TypeName, this.ParameterName); 

                if (ParameterDirection.Input != this.Direction) { 
                    throw SQL.UnsupportedTVPOutputParameter(this.Direction, this.ParameterName); 
                }
 
                if (DBNull.Value == GetCoercedValue()) {
                    throw SQL.DBNullNotSupportedForTVPValues(this.ParameterName);
                }
            } 
            else if (!ADP.IsEmpty (TypeName)) {
                throw SQL.UnexpectedTypeNameForNonStructParams(this.ParameterName); 
            } 
        }
 
        // func will change type to that with a 4 byte length if the type has a two
        // byte length and a parameter length > than that expressable in 2 bytes
#if WINFSFunctionality
        internal MetaType ValidateTypeLengths(bool yukonOrNewer, bool isWinFS) { 
#else
        internal MetaType ValidateTypeLengths(bool yukonOrNewer) { 
#endif 
            MetaType mt = InternalMetaType;
            // MDAC bug #50839 + #52829 : Since the server will automatically reject any 
            // char, varchar, binary, varbinary, nchar, or nvarchar parameter that has a
            // byte size > 8000 bytes, we promote the parameter to image, text, or ntext.  This
            // allows the user to specify a parameter type using a COM+ datatype and be able to
            // use that parameter against a BLOB column. 
            if ((SqlDbType.Udt != mt.SqlDbType) && (false == mt.IsFixed) && (false == mt.IsLong)) { // if type has 2 byte length
#if WINFSFunctionality 
                int actualSize = this.GetActualSize(isWinFS); 
#else
                int actualSize = this.GetActualSize(); 
#endif
                int size = this.Size;

                int maxSize = (size > actualSize) ? size : actualSize; 
                if ((maxSize > TdsEnums.TYPE_SIZE_LIMIT) || (size == -1) || (actualSize == -1)) { // is size > size able to be described by 2 bytes
                    if (yukonOrNewer) { 
                        // Convert the parameter to its max type 
                        mt = MetaType.GetMaxMetaTypeFromMetaType(mt);
                        _metaType = mt; 
                        InternalMetaType = mt;
                        if (!mt.IsPlp) {
                            if (mt.SqlDbType == SqlDbType.Xml) {
                                throw ADP.InvalidMetaDataValue();     //Xml should always have IsPartialLength = true 
                            }
                            if (mt.SqlDbType == SqlDbType.NVarChar 
                             || mt.SqlDbType == SqlDbType.VarChar 
                             || mt.SqlDbType == SqlDbType.VarBinary) {
                                Size = (int)(SmiMetaData.UnlimitedMaxLengthIndicator); 
                            }
                        }
                    }
                    else { 
                        switch (mt.SqlDbType) { // widening the SqlDbType is automatic
                        case SqlDbType.Binary: 
                        case SqlDbType.VarBinary: 
                            mt = MetaType.GetMetaTypeFromSqlDbType (SqlDbType.Image, false);
                            _metaType = mt; // do not use SqlDbType property which calls PropertyTypeChanging resetting coerced value 
                            InternalMetaType = mt;
                            break;
                        case SqlDbType.Char:
                        case SqlDbType.VarChar: 
                            mt = MetaType.GetMetaTypeFromSqlDbType (SqlDbType.Text, false);
                            _metaType = mt; 
                            InternalMetaType = mt; 
                            break;
                        case SqlDbType.NChar: 
                        case SqlDbType.NVarChar:
                            mt = MetaType.GetMetaTypeFromSqlDbType (SqlDbType.NText, false);
                            _metaType = mt;
                            InternalMetaType = mt; 
                            break;
                        default: 
                            Debug.Assert(false, "Missed metatype in SqlCommand.BuildParamList()"); 
                            break;
                        } 
                    }
                }
            }
            return mt; 
        }
 
        private byte ValuePrecision(object value) { 
            if (value is SqlDecimal) {
                if (((SqlDecimal) value).IsNull) // MDAC #79648 
                    return 0;

                return ((SqlDecimal)value).Precision;
            } 
            return ValuePrecisionCore(value);
        } 
 
        private byte ValueScale(object value) {
            if (value is SqlDecimal) { 
                if (((SqlDecimal) value).IsNull) // MDAC #79648
                    return 0;

                return ((SqlDecimal) value).Scale; 
            }
            return ValueScaleCore(value); 
        } 

        private int ValueSize(object value) { 
            if (value is SqlString) {
                if (((SqlString) value).IsNull) // MDAC #79648
                    return 0;
 
                return ((SqlString) value).Value.Length;
            } 
            if (value is SqlChars) { 
                if (((SqlChars) value).IsNull)
                    return 0; 

                return ((SqlChars) value).Value.Length;
            }
 
            if (value is SqlBinary) {
                if (((SqlBinary) value).IsNull) // MDAC #79648 
                    return 0; 

                return ((SqlBinary) value).Length; 
            }
            if (value is SqlBytes) {
                if (((SqlBytes) value).IsNull)
                    return 0; 

                return (int)(((SqlBytes) value).Length); 
            } 
            return ValueSizeCore(value);
        } 

        //

        // parse an string of the form db.schema.name where any of the three components 
        // might have "[" "]" and dots within it.
        // returns: 
        //   [0] dbname (or null) 
        //   [1] schema (or null)
        //   [2] name 
        // NOTE: if perf/space implications of Regex is not a problem, we can get rid
        // of this and use a simple regex to do the parsing
        internal static string[] ParseTypeName(string typeName, bool isUdtTypeName) {
            Debug.Assert(null != typeName, "null typename passed to ParseTypeName"); 

            try { 
                string errorMsg; 
                if (isUdtTypeName) {
                    errorMsg = Res.SQL_UDTTypeName; 
                }
                else {
                    errorMsg = Res.SQL_TypeName;
                } 
                return MultipartIdentifier.ParseMultipartIdentifier(typeName, "[\"", "]\"", '.', 3, true, errorMsg, true);
            } 
            catch (ArgumentException) { 
                if (isUdtTypeName) {
                    throw SQL.InvalidUdt3PartNameFormat(); 
                }
                else {
                    throw SQL.InvalidParameterTypeNameFormat();
                } 
            }
        } 
 
        sealed internal class SqlParameterConverter : ExpandableObjectConverter {
 
            // converter classes should have public ctor
            public SqlParameterConverter() {
            }
 
            override public bool CanConvertTo(ITypeDescriptorContext context, Type destinationType) {
                if (typeof(System.ComponentModel.Design.Serialization.InstanceDescriptor) == destinationType) { 
                    return true; 
                }
                return base.CanConvertTo(context, destinationType); 
            }

            override public object ConvertTo(ITypeDescriptorContext context, CultureInfo culture, object value, Type destinationType) {
                if (destinationType == null) { 
                    throw ADP.ArgumentNull("destinationType");
                } 
                if ((typeof(System.ComponentModel.Design.Serialization.InstanceDescriptor) == destinationType) && (value is SqlParameter)) { 
                    return ConvertToInstanceDescriptor(value as SqlParameter);
                } 
                return base.ConvertTo(context, culture, value, destinationType);
            }

            private System.ComponentModel.Design.Serialization.InstanceDescriptor ConvertToInstanceDescriptor(SqlParameter p) { 
                // MDAC 67321 - reducing parameter generated code
                int flags = 0; // if part of the collection - the parametername can't be empty 
 
                if (p.ShouldSerializeSqlDbType()) {
                    flags |= 1; 
                }
                if (p.ShouldSerializeSize()) {
                    flags |= 2;
                } 
                if (!ADP.IsEmpty(p.SourceColumn)) {
                    flags |= 4; 
                } 
                if (null != p.Value) {
                    flags |= 8; 
                }
                if ((ParameterDirection.Input != p.Direction) || p.IsNullable
                    || p.ShouldSerializePrecision() || p.ShouldSerializeScale()
                    || (DataRowVersion.Current != p.SourceVersion) 
                    ) {
                     flags |= 16; // v1.0 everything 
                } 

                if (p.SourceColumnNullMapping || !ADP.IsEmpty(p.XmlSchemaCollectionDatabase) || 
                    !ADP.IsEmpty(p.XmlSchemaCollectionOwningSchema) || !ADP.IsEmpty(p.XmlSchemaCollectionName)) {
                    flags |= 32; // v2.0 everything
                }
 
                Type[] ctorParams;
                object[] ctorValues; 
                switch(flags) { 
                case  0: // ParameterName
                case  1: // SqlDbType 
                    ctorParams = new Type[] { typeof(string), typeof(SqlDbType) };
                    ctorValues = new object[] { p.ParameterName, p.SqlDbType };
                    break;
                case  2: // Size 
                case  3: // Size, SqlDbType
                    ctorParams = new Type[] { typeof(string), typeof(SqlDbType), typeof(int) }; 
                    ctorValues = new object[] { p.ParameterName, p.SqlDbType, p.Size }; 
                    break;
                case  4: // SourceColumn 
                case  5: // SourceColumn, SqlDbType
                case  6: // SourceColumn, Size
                case  7: // SourceColumn, Size, SqlDbType
                    ctorParams = new Type[] { typeof(string), typeof(SqlDbType), typeof(int), typeof(string) }; 
                    ctorValues = new object[] { p.ParameterName, p.SqlDbType, p.Size, p.SourceColumn };
                    break; 
                case  8: // Value 
                    ctorParams = new Type[] { typeof(string), typeof(object) };
                    ctorValues = new object[] { p.ParameterName, p.Value }; 
                    break;
                default:
                    if (0 == (32 & flags)) { // v1.0 everything
                        ctorParams = new Type[] { 
                                                    typeof(string), typeof(SqlDbType), typeof(int), typeof(ParameterDirection),
                                                    typeof(bool), typeof(byte), typeof(byte), 
                                                    typeof(string), typeof(DataRowVersion), 
                                                    typeof(object) };
                        ctorValues = new object[] { 
                                                      p.ParameterName, p.SqlDbType,  p.Size, p.Direction,
                                                      p.IsNullable, p.PrecisionInternal, p.ScaleInternal,
                                                      p.SourceColumn, p.SourceVersion,
                                                      p.Value }; 
                    }
                    else { // v2.0 everything - round trip all browsable properties + precision/scale 
                        ctorParams = new Type[] { 
                                                    typeof(string), typeof(SqlDbType), typeof(int), typeof(ParameterDirection),
                                                    typeof(byte), typeof(byte), 
                                                    typeof(string), typeof(DataRowVersion), typeof(bool),
                                                    typeof(object),
                                                    typeof(string), typeof(string),
                                                    typeof(string) }; 
                        ctorValues = new object[] {
                                                      p.ParameterName, p.SqlDbType,  p.Size, p.Direction, 
                                                      p.PrecisionInternal, p.ScaleInternal, 
                                                      p.SourceColumn, p.SourceVersion, p.SourceColumnNullMapping,
                                                      p.Value, 
                                                      p.XmlSchemaCollectionDatabase, p.XmlSchemaCollectionOwningSchema,
                                                      p.XmlSchemaCollectionName};
                    }
                    break; 
                }
                System.Reflection.ConstructorInfo ctor = typeof(SqlParameter).GetConstructor(ctorParams); 
                return new System.ComponentModel.Design.Serialization.InstanceDescriptor(ctor, ctorValues); 
            }
        } 

    }
}

// File provided for Reference Use Only by Microsoft Corporation (c) 2007.
                        

Link Menu

Network programming in C#, Network Programming in VB.NET, Network Programming in .NET
This book is available now!
Buy at Amazon US or
Buy at Amazon UK