SqlMetaData 构造函数

定义

命名空间:

Microsoft.Data.SqlClient.Server

程序集:

Microsoft.Data.SqlClient.dll

包:

Microsoft.Data.SqlClient v5.2.0

重载

SqlMetaData(String, SqlDbType)	使用指定的列名称和类型初始化 SqlMetaData 类的新实例。
SqlMetaData(String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type, Boolean, Boolean, SortOrder, Int32)	使用指定的列名称、类型、最大长度、精度、小数位数、区域设置 ID、比较选项和用户定义的类型 (UDT) 初始化 SqlMetaData 类的新实例。 这种形式的构造函数通过允许指定表值参数中的列是否唯一、列的排序顺序和列排序的序号，支持表值参数。
SqlMetaData(String, SqlDbType, String, String, String, Boolean, Boolean, SortOrder, Int32)	使用指定的列名称、数据库名称、所属架构、对象名称和默认服务器初始化 SqlMetaData 类的新实例。 这种形式的构造函数通过允许指定表值参数中的列是否唯一、列的排序顺序和列排序的序号，支持表值参数。
SqlMetaData(String, SqlDbType, Int64, Int64, SqlCompareOptions, Boolean, Boolean, SortOrder, Int32)	使用指定的列名称、类型、最大长度、区域设置、比较选项和服务器默认值初始化 SqlMetaData 类的新实例。 这种形式的构造函数通过允许指定表值参数中的列是否唯一、列的排序顺序和列排序的序号，支持表值参数。
SqlMetaData(String, SqlDbType, Type, String, Boolean, Boolean, SortOrder, Int32)	使用指定的列名称、类型、用户定义的类型、SQL Server 类型和服务器默认值初始化 SqlMetaData 类的新实例。 这种形式的构造函数通过允许指定表值参数中的列是否唯一、列的排序顺序和列排序的序号，支持表值参数。
SqlMetaData(String, SqlDbType, Byte, Byte, Boolean, Boolean, SortOrder, Int32)	使用指定的列名称、类型、精度、小数位数和服务器默认值初始化 SqlMetaData 类的新实例。 这种形式的构造函数通过允许指定表值参数中的列是否唯一、列的排序顺序和列排序的序号，支持表值参数。
SqlMetaData(String, SqlDbType, Int64, Boolean, Boolean, SortOrder, Int32)	使用指定的列名称、类型、最大长度和服务器默认值初始化 SqlMetaData 类的新实例。 这种形式的构造函数通过允许指定表值参数中的列是否唯一、列的排序顺序和列排序的序号，支持表值参数。
SqlMetaData(String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type)	使用指定的列名称、类型、最大长度、精度、小数位数、区域设置 ID、比较选项和用户定义的类型 (UDT) 初始化 SqlMetaData 类的新实例。
SqlMetaData(String, SqlDbType, String, String, String)	使用指定的列名称、类型、数据库名称、所属架构和对象名称初始化 SqlMetaData 类的新实例。
SqlMetaData(String, SqlDbType, Int64, Int64, SqlCompareOptions)	使用指定的列名称、类型、最大长度、区域设置和比较选项初始化 SqlMetaData 类的新实例。
SqlMetaData(String, SqlDbType, Type, String)	使用指定的列名称、用户定义的类型 (UDT) 和 SQLServer 类型初始化 SqlMetaData 类的新实例。
SqlMetaData(String, SqlDbType, Byte, Byte)	使用指定的列名称、类型、精度和小数位数初始化 SqlMetaData 类的新实例。
SqlMetaData(String, SqlDbType, Type)	使用指定的列名称、类型和用户定义的类型 (UDT) 初始化 SqlMetaData 类的新实例。
SqlMetaData(String, SqlDbType, Int64)	使用指定的列名称、类型和最大长度初始化 SqlMetaData 类的新实例。
SqlMetaData(String, SqlDbType, Boolean, Boolean, SortOrder, Int32)	使用指定的列名称和默认服务器初始化 SqlMetaData 类的新实例。 这种形式的构造函数通过允许指定表值参数中的列是否唯一、列的排序顺序和列排序的序号，支持表值参数。

SqlMetaData(String, SqlDbType)

使用指定的列名称和类型初始化 SqlMetaData 类的新实例。

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType);

public SqlMetaData (string name, System.Data.SqlDbType dbType);

new Microsoft.Data.SqlClient.Server.SqlMetaData : string * System.Data.SqlDbType -> Microsoft.Data.SqlClient.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType)

参数

name

String

列的名称。

dbType

SqlDbType

参数或列的 SQL Server 类型。

例外

ArgumentNullException

name 为 null。

ArgumentException

不允许的 SqlDbType 作为 dbType 传递给了构造函数。

示例

以下示例通过指定列名和列数据类型 SqlDbTypeInt创建一个新的 SqlMetaData 对象。

// using Microsoft.Data.SqlClient.Server;

public static void CreateSqlMetaData2()
{
    SqlMetaData columnInfo;
    columnInfo = new SqlMetaData("Column2", SqlDbType.Int);
}

注解

仅允许将以下内容作为 dbType传递给构造函数：Bit、、、DateTimeDecimalFloatIntMoneyBigIntSmallMoneySmallDateTimeNumericSmallInt、、TimeStamp、TinyInt、、 。 XmlUniqueIdentifier

以下是分配给 dbType的默认值，具体取决于 SqlDbType (XmlSchemaCollectionDatabase、 XmlSchemaCollectionName、 XmlSchemaCollectionOwningSchema和 Type 属性设置为 null) ：

SqlDbType	最大长度	精度	缩放	Locale	比较选项
Bit	1	1	0	0	无
BigInt	8	19	0	0	无
DateTime	8	23	3	0	无
Decimal	9	18	0	0	无
Float	8	53	0	0	无
Int	4	10	0	0	无
Money	8	19	4	0	无
Numeric	9	18	0	0	无
SmallDateTime	4	16	0	0	无
SmallInt	2	5	0	0	无
SmallMoney	4	10	4	0	无
TimeStamp	8	0	0	0	无
TinyInt	1	3	0	0	无
UniqueIdentifier	16	0	0	0	无
Xml	最大 (-1)	0	0	0	IgnoreCase、IgnoreKanaType、IgnoreWidth

SqlMetaData(String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type, Boolean, Boolean, SortOrder, Int32)

使用指定的列名称、类型、最大长度、精度、小数位数、区域设置 ID、比较选项和用户定义的类型 (UDT) 初始化 SqlMetaData 类的新实例。 这种形式的构造函数通过允许指定表值参数中的列是否唯一、列的排序顺序和列排序的序号，支持表值参数。

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, long maxLength, System::Byte precision, System::Byte scale, long localeId, System::Data::SqlTypes::SqlCompareOptions compareOptions, Type ^ userDefinedType, bool useServerDefault, bool isUniqueKey, Microsoft::Data::SqlClient::SortOrder columnSortOrder, int sortOrdinal);

public SqlMetaData (string name, System.Data.SqlDbType dbType, long maxLength, byte precision, byte scale, long localeId, System.Data.SqlTypes.SqlCompareOptions compareOptions, Type userDefinedType, bool useServerDefault, bool isUniqueKey, Microsoft.Data.SqlClient.SortOrder columnSortOrder, int sortOrdinal);

new Microsoft.Data.SqlClient.Server.SqlMetaData : string * System.Data.SqlDbType * int64 * byte * byte * int64 * System.Data.SqlTypes.SqlCompareOptions * Type * bool * bool * Microsoft.Data.SqlClient.SortOrder * int -> Microsoft.Data.SqlClient.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, maxLength As Long, precision As Byte, scale As Byte, localeId As Long, compareOptions As SqlCompareOptions, userDefinedType As Type, useServerDefault As Boolean, isUniqueKey As Boolean, columnSortOrder As SortOrder, sortOrdinal As Integer)

参数

name

String

列的名称。

dbType

SqlDbType

参数或列的 SQL Server 类型。

maxLength

Int64

指定类型的最大长度。

precision

Byte

参数或列的精度。

scale

Byte

参数或列的小数位数。

localeId

Int64

参数或列的区域设置 ID。

compareOptions

SqlCompareOptions

参数或列的比较规则。

userDefinedType

Type

一个指向该 UDT 的 Type 实例。

useServerDefault

Boolean

指定此列是否应使用默认服务器值。

isUniqueKey

Boolean

指定表值参数中的列是否唯一。

columnSortOrder

SortOrder

指定列的排序顺序。

sortOrdinal

Int32

指定列排序的序号。

注解

有关详细信息，请参阅 表值参数。

SqlMetaData(String, SqlDbType, String, String, String, Boolean, Boolean, SortOrder, Int32)

使用指定的列名称、数据库名称、所属架构、对象名称和默认服务器初始化 SqlMetaData 类的新实例。 这种形式的构造函数通过允许指定表值参数中的列是否唯一、列的排序顺序和列排序的序号，支持表值参数。

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, System::String ^ database, System::String ^ owningSchema, System::String ^ objectName, bool useServerDefault, bool isUniqueKey, Microsoft::Data::SqlClient::SortOrder columnSortOrder, int sortOrdinal);

public SqlMetaData (string name, System.Data.SqlDbType dbType, string database, string owningSchema, string objectName, bool useServerDefault, bool isUniqueKey, Microsoft.Data.SqlClient.SortOrder columnSortOrder, int sortOrdinal);

new Microsoft.Data.SqlClient.Server.SqlMetaData : string * System.Data.SqlDbType * string * string * string * bool * bool * Microsoft.Data.SqlClient.SortOrder * int -> Microsoft.Data.SqlClient.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, database As String, owningSchema As String, objectName As String, useServerDefault As Boolean, isUniqueKey As Boolean, columnSortOrder As SortOrder, sortOrdinal As Integer)

参数

name

String

列的名称。

dbType

SqlDbType

参数或列的 SQL Server 类型。

database

String

类型化 XML 实例的 XML 架构集合的数据库名称。

owningSchema

String

类型化 XML 实例的 XML 架构集合的关系架构名称。

objectName

String

类型化 XML 实例的 XML 架构集合的名称。

useServerDefault

Boolean

指定此列是否应使用默认服务器值。

isUniqueKey

Boolean

指定表值参数中的列是否唯一。

columnSortOrder

SortOrder

指定列的排序顺序。

sortOrdinal

Int32

指定列排序的序号。

注解

有关详细信息，请参阅 表值参数。

SqlMetaData(String, SqlDbType, Int64, Int64, SqlCompareOptions, Boolean, Boolean, SortOrder, Int32)

使用指定的列名称、类型、最大长度、区域设置、比较选项和服务器默认值初始化 SqlMetaData 类的新实例。 这种形式的构造函数通过允许指定表值参数中的列是否唯一、列的排序顺序和列排序的序号，支持表值参数。

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, long maxLength, long locale, System::Data::SqlTypes::SqlCompareOptions compareOptions, bool useServerDefault, bool isUniqueKey, Microsoft::Data::SqlClient::SortOrder columnSortOrder, int sortOrdinal);

public SqlMetaData (string name, System.Data.SqlDbType dbType, long maxLength, long locale, System.Data.SqlTypes.SqlCompareOptions compareOptions, bool useServerDefault, bool isUniqueKey, Microsoft.Data.SqlClient.SortOrder columnSortOrder, int sortOrdinal);

new Microsoft.Data.SqlClient.Server.SqlMetaData : string * System.Data.SqlDbType * int64 * int64 * System.Data.SqlTypes.SqlCompareOptions * bool * bool * Microsoft.Data.SqlClient.SortOrder * int -> Microsoft.Data.SqlClient.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, maxLength As Long, locale As Long, compareOptions As SqlCompareOptions, useServerDefault As Boolean, isUniqueKey As Boolean, columnSortOrder As SortOrder, sortOrdinal As Integer)

参数

name

String

列的名称。

dbType

SqlDbType

参数或列的 SQL Server 类型。

maxLength

Int64

指定类型的最大长度。

locale

Int64

参数或列的区域设置 ID。

compareOptions

SqlCompareOptions

参数或列的比较规则。

useServerDefault

Boolean

指定此列是否应使用默认服务器值。

isUniqueKey

Boolean

指定表值参数中的列是否唯一。

columnSortOrder

SortOrder

指定列的排序顺序。

sortOrdinal

Int32

指定列排序的序号。

注解

有关详细信息，请参阅 表值参数。

SqlMetaData(String, SqlDbType, Type, String, Boolean, Boolean, SortOrder, Int32)

使用指定的列名称、类型、用户定义的类型、SQL Server 类型和服务器默认值初始化 SqlMetaData 类的新实例。 这种形式的构造函数通过允许指定表值参数中的列是否唯一、列的排序顺序和列排序的序号，支持表值参数。

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, Type ^ userDefinedType, System::String ^ serverTypeName, bool useServerDefault, bool isUniqueKey, Microsoft::Data::SqlClient::SortOrder columnSortOrder, int sortOrdinal);

public SqlMetaData (string name, System.Data.SqlDbType dbType, Type userDefinedType, string serverTypeName, bool useServerDefault, bool isUniqueKey, Microsoft.Data.SqlClient.SortOrder columnSortOrder, int sortOrdinal);

new Microsoft.Data.SqlClient.Server.SqlMetaData : string * System.Data.SqlDbType * Type * string * bool * bool * Microsoft.Data.SqlClient.SortOrder * int -> Microsoft.Data.SqlClient.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, userDefinedType As Type, serverTypeName As String, useServerDefault As Boolean, isUniqueKey As Boolean, columnSortOrder As SortOrder, sortOrdinal As Integer)

参数

name

String

列的名称。

dbType

SqlDbType

参数或列的 SQL Server 类型。

userDefinedType

Type

一个指向该 UDT 的 Type 实例。

serverTypeName

String

userDefinedType 的 SQL Server 类型名称。

useServerDefault

Boolean

指定此列是否应使用默认服务器值。

isUniqueKey

Boolean

指定表值参数中的列是否唯一。

columnSortOrder

SortOrder

指定列的排序顺序。

sortOrdinal

Int32

指定列排序的序号。

注解

有关详细信息，请参阅 表值参数。

SqlMetaData(String, SqlDbType, Byte, Byte, Boolean, Boolean, SortOrder, Int32)

使用指定的列名称、类型、精度、小数位数和服务器默认值初始化 SqlMetaData 类的新实例。 这种形式的构造函数通过允许指定表值参数中的列是否唯一、列的排序顺序和列排序的序号，支持表值参数。

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, System::Byte precision, System::Byte scale, bool useServerDefault, bool isUniqueKey, Microsoft::Data::SqlClient::SortOrder columnSortOrder, int sortOrdinal);

public SqlMetaData (string name, System.Data.SqlDbType dbType, byte precision, byte scale, bool useServerDefault, bool isUniqueKey, Microsoft.Data.SqlClient.SortOrder columnSortOrder, int sortOrdinal);

new Microsoft.Data.SqlClient.Server.SqlMetaData : string * System.Data.SqlDbType * byte * byte * bool * bool * Microsoft.Data.SqlClient.SortOrder * int -> Microsoft.Data.SqlClient.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, precision As Byte, scale As Byte, useServerDefault As Boolean, isUniqueKey As Boolean, columnSortOrder As SortOrder, sortOrdinal As Integer)

参数

name

String

列的名称。

dbType

SqlDbType

参数或列的 SQL Server 类型。

precision

Byte

参数或列的精度。

scale

Byte

参数或列的小数位数。

useServerDefault

Boolean

指定此列是否应使用默认服务器值。

isUniqueKey

Boolean

指定表值参数中的列是否唯一。

columnSortOrder

SortOrder

指定列的排序顺序。

sortOrdinal

Int32

指定列排序的序号。

注解

有关详细信息，请参阅 表值参数。

SqlMetaData(String, SqlDbType, Int64, Boolean, Boolean, SortOrder, Int32)

使用指定的列名称、类型、最大长度和服务器默认值初始化 SqlMetaData 类的新实例。 这种形式的构造函数通过允许指定表值参数中的列是否唯一、列的排序顺序和列排序的序号，支持表值参数。

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, long maxLength, bool useServerDefault, bool isUniqueKey, Microsoft::Data::SqlClient::SortOrder columnSortOrder, int sortOrdinal);

public SqlMetaData (string name, System.Data.SqlDbType dbType, long maxLength, bool useServerDefault, bool isUniqueKey, Microsoft.Data.SqlClient.SortOrder columnSortOrder, int sortOrdinal);

new Microsoft.Data.SqlClient.Server.SqlMetaData : string * System.Data.SqlDbType * int64 * bool * bool * Microsoft.Data.SqlClient.SortOrder * int -> Microsoft.Data.SqlClient.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, maxLength As Long, useServerDefault As Boolean, isUniqueKey As Boolean, columnSortOrder As SortOrder, sortOrdinal As Integer)

参数

name

String

列的名称。

dbType

SqlDbType

参数或列的 SQL Server 类型。

maxLength

Int64

指定类型的最大长度。

useServerDefault

Boolean

指定此列是否应使用默认服务器值。

isUniqueKey

Boolean

指定表值参数中的列是否唯一。

columnSortOrder

SortOrder

指定列的排序顺序。

sortOrdinal

Int32

指定列排序的序号。

注解

有关详细信息，请参阅 表值参数。

SqlMetaData(String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type)

使用指定的列名称、类型、最大长度、精度、小数位数、区域设置 ID、比较选项和用户定义的类型 (UDT) 初始化 SqlMetaData 类的新实例。

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, long maxLength, System::Byte precision, System::Byte scale, long locale, System::Data::SqlTypes::SqlCompareOptions compareOptions, Type ^ userDefinedType);

public SqlMetaData (string name, System.Data.SqlDbType dbType, long maxLength, byte precision, byte scale, long locale, System.Data.SqlTypes.SqlCompareOptions compareOptions, Type userDefinedType);

new Microsoft.Data.SqlClient.Server.SqlMetaData : string * System.Data.SqlDbType * int64 * byte * byte * int64 * System.Data.SqlTypes.SqlCompareOptions * Type -> Microsoft.Data.SqlClient.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, maxLength As Long, precision As Byte, scale As Byte, locale As Long, compareOptions As SqlCompareOptions, userDefinedType As Type)

参数

name

String

列的名称。

dbType

SqlDbType

参数或列的 SQL Server 类型。

maxLength

Int64

指定类型的最大长度。

precision

Byte

参数或列的精度。

scale

Byte

参数或列的小数位数。

locale

Int64

参数或列的区域设置 ID。

compareOptions

SqlCompareOptions

参数或列的比较规则。

userDefinedType

Type

一个指向该 UDT 的 Type 实例。

例外

ArgumentNullException

name 为 null。

ArgumentException

不允许的 SqlDbType 作为 dbType 传递给了构造函数，或者 userDefinedType 指向了未声明 SqlUserDefinedTypeAttribute 的类型。

注解

仅允许将以下内容作为以下项传递给构造函数dbType：、、Bit、BitInt、SmallMoneySmallDateTimeTinyIntImageDecimalFloatDateTimeMoneyIntNumericTextTimeStampSmallIntRealNtext、UniqueIdentifier、Variant、、 。 XmlBigInt

以下是分配给 dbType的默认值，具体取决于 SqlDbType (XmlSchemaCollectionDatabase、 XmlSchemaCollectionName、 XmlSchemaCollectionOwningSchema和 Type 属性设置为 null) ：

SqlDbType	最大长度	精度	缩放	Locale	比较选项
BigInt	8	19	0	0	无
Bit	1	1	0	0	无
DateTime	8	23	3	0	无
Decimal	9	18	0	0	无
Float	8	53	0	0	无
Image	最大 (-1)	0	0	0	无
Int	4	10	0	0	无
Money	8	19	4	0	无
Ntext	最大 (-1)	0	0	<thread>	IgnoreCase、IgnoreKanaType、IgnoreWidth
Real	4	24	0	0	无
Row	<列数>	0	0	0	无
SmallDateTime	4	16	0	0	无
SmallInt	2	5	0	0	无
SmallMoney	4	10	4	0	无
Text	最大 (-1)	0	0	<thread>	IgnoreCase、IgnoreKanaType、IgnoreWidth
TimeStamp	8	0	0	0	无
TinyInt	1	3	0	0	无
UniqueIdentifier	16	0	0	0	无
UDT	<类型> 的最大长度或 -1	0	0	0	无
Variant	8016	0	0	0	无
Xml	最大 (-1)	0	0	0	IgnoreCase、IgnoreKanaType、IgnoreWidth

SqlMetaData(String, SqlDbType, String, String, String)

使用指定的列名称、类型、数据库名称、所属架构和对象名称初始化 SqlMetaData 类的新实例。

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, System::String ^ database, System::String ^ owningSchema, System::String ^ objectName);

public SqlMetaData (string name, System.Data.SqlDbType dbType, string database, string owningSchema, string objectName);

new Microsoft.Data.SqlClient.Server.SqlMetaData : string * System.Data.SqlDbType * string * string * string -> Microsoft.Data.SqlClient.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, database As String, owningSchema As String, objectName As String)

参数

name

String

列的名称。

dbType

SqlDbType

参数或列的 SQL Server 类型。

database

String

类型化 XML 实例的 XML 架构集合的数据库名称。

owningSchema

String

类型化 XML 实例的 XML 架构集合的关系架构名称。

objectName

String

类型化 XML 实例的 XML 架构集合的名称。

例外

ArgumentNullException

当 name 和 objectName 不为 null 时，database 为 null，或 owningSchema 为 null。

ArgumentException

不允许的 SqlDbType 作为 dbType 传递给了构造函数。

注解

仅允许将以下内容 SqlDbType 作为 传递给构造函数 dbType： Xml。

以下是分配给 dbType的默认值， SqlDbType具体取决于 ：

SqlDbType	最大长度	精度	缩放	Locale	比较选项
Xml	最大 (-1)	0	0	0	IgnoreCase、IgnoreKanaType、IgnoreWidth

SqlMetaData(String, SqlDbType, Int64, Int64, SqlCompareOptions)

使用指定的列名称、类型、最大长度、区域设置和比较选项初始化 SqlMetaData 类的新实例。

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, long maxLength, long locale, System::Data::SqlTypes::SqlCompareOptions compareOptions);

public SqlMetaData (string name, System.Data.SqlDbType dbType, long maxLength, long locale, System.Data.SqlTypes.SqlCompareOptions compareOptions);

new Microsoft.Data.SqlClient.Server.SqlMetaData : string * System.Data.SqlDbType * int64 * int64 * System.Data.SqlTypes.SqlCompareOptions -> Microsoft.Data.SqlClient.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, maxLength As Long, locale As Long, compareOptions As SqlCompareOptions)

参数

name

String

参数或列的名称。

dbType

SqlDbType

参数或列的 SQL Server 类型。

maxLength

Int64

指定类型的最大长度。

locale

Int64

参数或列的区域设置 ID。

compareOptions

SqlCompareOptions

参数或列的比较规则。

例外

ArgumentNullException

name 为 null。

ArgumentException

不允许的 SqlDbType 作为 dbType 传递给了构造函数。

注解

仅允许将以下内容作为 传递给构造函数dbType：Char、、NChar、Ntext、NVarCharText、VarChar。

maxLength对于 或 的 Max，只允许dbType使用 、 或 NText-1 的Text规范。

dbType对于 或 Nvarchar的 Varchar ，长度规范为 Max或 -1，分别将元数据声明为 varchar (max) 和 nvarchar (max) 。

以下是分配给 dbType的默认值，具体取决于 SqlDbType (XmlSchemaCollectionDatabase、 XmlSchemaCollectionName、 XmlSchemaCollectionOwningSchema和 Type 属性设置为 null) ：

SqlDbType	精度	缩放
Char	0	0
NChar	0	0
NText	0	0
NVarChar	0	0
Text	0	0
VarChar	0	0

SqlMetaData(String, SqlDbType, Type, String)

使用指定的列名称、用户定义的类型 (UDT) 和 SQLServer 类型初始化 SqlMetaData 类的新实例。

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, Type ^ userDefinedType, System::String ^ serverTypeName);

public SqlMetaData (string name, System.Data.SqlDbType dbType, Type userDefinedType, string serverTypeName);

new Microsoft.Data.SqlClient.Server.SqlMetaData : string * System.Data.SqlDbType * Type * string -> Microsoft.Data.SqlClient.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, userDefinedType As Type, serverTypeName As String)

参数

name

String

列的名称。

dbType

SqlDbType

参数或列的 SQL Server 类型。

userDefinedType

Type

一个指向该 UDT 的 Type 实例。

serverTypeName

String

userDefinedType 的 SQL Server 类型名称。

SqlMetaData(String, SqlDbType, Byte, Byte)

使用指定的列名称、类型、精度和小数位数初始化 SqlMetaData 类的新实例。

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, System::Byte precision, System::Byte scale);

public SqlMetaData (string name, System.Data.SqlDbType dbType, byte precision, byte scale);

new Microsoft.Data.SqlClient.Server.SqlMetaData : string * System.Data.SqlDbType * byte * byte -> Microsoft.Data.SqlClient.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, precision As Byte, scale As Byte)

参数

name

String

参数或列的名称。

dbType

SqlDbType

参数或列的 SQL Server 类型。

precision

Byte

参数或列的精度。

scale

Byte

参数或列的小数位数。

例外

ArgumentNullException

name 为 null。

ArgumentException

不允许的 SqlDbType 作为 dbType 传递给了构造函数，或者 scale 大于 precision。

注解

仅允许将以下内容 SqlDbType 作为 传递给构造函数 dbType： Decimal。

以下是分配给 dbType的默认值，具体取决于 SqlDbType (XmlSchemaCollectionDatabase、 XmlSchemaCollectionName、 XmlSchemaCollectionOwningSchema和 Type 属性设置为 null) ：

SqlDbType	最大长度	精度	缩放	Locale	比较选项
小数	9	18	0	0	无

SqlMetaData(String, SqlDbType, Type)

使用指定的列名称、类型和用户定义的类型 (UDT) 初始化 SqlMetaData 类的新实例。

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, Type ^ userDefinedType);

public SqlMetaData (string name, System.Data.SqlDbType dbType, Type userDefinedType);

new Microsoft.Data.SqlClient.Server.SqlMetaData : string * System.Data.SqlDbType * Type -> Microsoft.Data.SqlClient.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, userDefinedType As Type)

参数

name

String

列的名称。

dbType

SqlDbType

参数或列的 SQL Server 类型。

userDefinedType

Type

一个指向该 UDT 的 Type 实例。

例外

ArgumentNullException

name 为 null。

ArgumentException

不允许的 SqlDbType 作为 dbType 传递给了构造函数，或者 userDefinedType 指向了未声明 SqlUserDefinedTypeAttribute 的类型。

注解

仅允许将以下内容 SqlDbType 作为 传递给构造函数 dbType： UDT。

以下是分配给 dbType的默认值，具体取决于 SqlDbType (XmlSchemaCollectionDatabase、 XmlSchemaCollectionName、 XmlSchemaCollectionOwningSchema和 Type 属性设置为 null) ：

SqlDbType	最大长度	精度	缩放	Locale	比较选项
UDT	<类型> 的最大长度或 -1	0	0	0	无

SqlMetaData(String, SqlDbType, Int64)

使用指定的列名称、类型和最大长度初始化 SqlMetaData 类的新实例。

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, long maxLength);

public SqlMetaData (string name, System.Data.SqlDbType dbType, long maxLength);

new Microsoft.Data.SqlClient.Server.SqlMetaData : string * System.Data.SqlDbType * int64 -> Microsoft.Data.SqlClient.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, maxLength As Long)

参数

name

String

列的名称。

dbType

SqlDbType

参数或列的 SQL Server 类型。

maxLength

Int64

指定类型的最大长度。

例外

ArgumentNullException

name 为 null。

ArgumentException

不允许的 SqlDbType 作为 dbType 传递给了构造函数。

示例

以下示例通过指定列名、列数据类型SqlDbType.NVarChar和最大长度 12 个字符来创建一个新的 SqlMetaData 对象。

// using Microsoft.Data.SqlClient.Server;

public static void CreateSqlMetaData1()
{
    SqlMetaData columnInfo;
    columnInfo = new SqlMetaData("Column1", SqlDbType.NVarChar, 12);
}

注解

仅允许将以下内容作为 传递到构造函数dbType：、、Char、、ImageNCharNtext、NVarChar、、Text、VarBinary、、 。 VarCharBinary

maxLength、 或 的 Max只允许dbType使用 、 或 Image的TextNText规范 。

对于 、 或 的 Varchar，dbType长度规范为 Max或 -1，分别将元数据声明为 varchar (max) 、nvarchar (max) 或 nvarbinary VarBinary (max) 。 Nvarchar

以下是分配给 dbType的默认值，具体取决于 SqlDbType (XmlSchemaCollectionDatabase、 XmlSchemaCollectionName、 XmlSchemaCollectionOwningSchema和 Type 属性设置为 null) ：

SqlDbType	精度	缩放	Locale	比较选项
二进制	0	0	0	IgnoreCase、IgnoreKanaType、IgnoreWidth
Char	0	0	<thread>	IgnoreCase、IgnoreKanaType、IgnoreWidth
图像	0	0	0	无
NChar	0	0	<thread>	IgnoreCase、IgnoreKanaType、IgnoreWidth
NText	0	0	<thread>	IgnoreCase、IgnoreKanaType、IgnoreWidth
NVarChar	0	0	<thread>	IgnoreCase、IgnoreKanaType、IgnoreWidth
文本	0	0	<thread>	IgnoreCase、IgnoreKanaType、IgnoreWidth
VarBinary	0	0		IgnoreCase、IgnoreKanaType、IgnoreWidth
VarChar	0	0	<thread>	IgnoreCase、IgnoreKanaType、IgnoreWidth

SqlMetaData(String, SqlDbType, Boolean, Boolean, SortOrder, Int32)

使用指定的列名称和默认服务器初始化 SqlMetaData 类的新实例。 这种形式的构造函数通过允许指定表值参数中的列是否唯一、列的排序顺序和列排序的序号，支持表值参数。

public:
 SqlMetaData(System::String ^ name, System::Data::SqlDbType dbType, bool useServerDefault, bool isUniqueKey, Microsoft::Data::SqlClient::SortOrder columnSortOrder, int sortOrdinal);

public SqlMetaData (string name, System.Data.SqlDbType dbType, bool useServerDefault, bool isUniqueKey, Microsoft.Data.SqlClient.SortOrder columnSortOrder, int sortOrdinal);

new Microsoft.Data.SqlClient.Server.SqlMetaData : string * System.Data.SqlDbType * bool * bool * Microsoft.Data.SqlClient.SortOrder * int -> Microsoft.Data.SqlClient.Server.SqlMetaData

Public Sub New (name As String, dbType As SqlDbType, useServerDefault As Boolean, isUniqueKey As Boolean, columnSortOrder As SortOrder, sortOrdinal As Integer)

参数

name

String

列的名称。

dbType

SqlDbType

参数或列的 SQL Server 类型。

useServerDefault

Boolean

指定此列是否应使用默认服务器值。

isUniqueKey

Boolean

指定表值参数中的列是否唯一。

columnSortOrder

SortOrder

指定列的排序顺序。

sortOrdinal

Int32

指定列排序的序号。

注解

有关详细信息，请参阅 表值参数。