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

傳遞給建構函式做為 dbType 的 SqlDbType 為不允許的型別。

範例

下列範例會藉由指定資料行名稱和資料行資料類型 SqlDbTypeInt 來建立新的 SqlMetaData 物件。

// using Microsoft.Data.SqlClient.Server;

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

備註

只允許將下列專案傳遞至建構函式： dbTypeBit 、、 BigInt 、 DateTime 、 TimeStampXmlUniqueIdentifierTinyIntSmallMoneySmallIntNumericIntSmallDateTimeDecimalFloatMoney 。

以下是指派給 dbType 的預設值，視 SqlDbType (XmlSchemaCollectionDatabase 、 XmlSchemaCollectionName 、 XmlSchemaCollectionOwningSchema 和 Type 屬性設定為 null) ：

SqlDbType	長度上限	精確度	縮放	地區設定	比較選項
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	max (-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 的型別。

備註

只允許將下列專案傳遞至建構函式： dbTypeBigInt 、、 SmallIntDateTimeTextDecimalTimeStampVariantSmallMoneyXmlUniqueIdentifierTinyIntSmallDateTimeRealNumericNtextIntFloatMoneyBitBitIntImage 。

以下是指派給 dbType 的預設值，視 SqlDbType (XmlSchemaCollectionDatabase 、 XmlSchemaCollectionName 、 XmlSchemaCollectionOwningSchema 和 Type 屬性設定為 null) ：

SqlDbType	長度上限	精確度	縮放	地區設定	比較選項
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	max (-1)	0	0	0	無
Int	4	10	0	0	無
Money	8	19	4	0	無
Ntext	max (-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	max (-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	max (-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 為 null，或當 objectName 和 database 為非 null 時 owningSchema 為 null。

ArgumentException

傳遞給建構函式做為 dbType 的 SqlDbType 為不允許的型別。

備註

只允許將下列專案 SqlDbType 傳遞至建構函式： dbTypeXml 。

以下是指派給 dbType 的預設值，視 而定 SqlDbType ：

SqlDbType	長度上限	精確度	縮放	地區設定	比較選項
Xml	max (-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

傳遞給建構函式做為 dbType 的 SqlDbType 為不允許的型別。

備註

只允許將下列專案傳遞至建構函式： dbTypeChar 、、 NChar 、 Ntext 、 NVarChar 、、 TextVarChar 。

maxLength或 -1 只允許 dbTypeTextNText 或 的 Max 規格。

dbType針對 或 的 Varchar 、長度 Nvarchar 規格 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 傳遞至建構函式： dbTypeDecimal 。

以下是指派給 dbType 的預設值，視 SqlDbType (XmlSchemaCollectionDatabase 、 XmlSchemaCollectionName 、 XmlSchemaCollectionOwningSchema 和 Type 屬性設定為 null) ：

SqlDbType	長度上限	精確度	縮放	地區設定	比較選項
Decimal	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 傳遞至建構函式： dbTypeUDT 。

以下是指派給 dbType 的預設值，視 SqlDbType (XmlSchemaCollectionDatabase 、 XmlSchemaCollectionName 、 XmlSchemaCollectionOwningSchema 和 Type 屬性設定為 null) ：

SqlDbType	長度上限	精確度	縮放	地區設定	比較選項
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

傳遞給建構函式做為 dbType 的 SqlDbType 為不允許的型別。

範例

下列範例會藉由指定資料行名稱、的資料行資料類型 SqlDbType.NVarChar ，以及長度上限為 12 個字元來建立新的 SqlMetaData 物件。

// using Microsoft.Data.SqlClient.Server;

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

備註

只允許將下列專案傳遞至建構函式： dbTypeBinary 、 Char 、 Image 、 NChar 、 Ntext 、 NVarChar 、 TextVarBinary 、 VarChar 。

maxLengthMax 、 或 Image 的 只允許 TextdbType 指定 或 NText -1。

dbTypeVarchar 針對 、 或 的 、 Nvarchar 或 VarBinary 的長度規格 Max 或 -1，分別將中繼資料宣告為 Varchar (max) 、Nvarchar (max) 或 nVarbinary (max) 。

以下是指派給 dbType 的預設值，視 SqlDbType (XmlSchemaCollectionDatabase 、 XmlSchemaCollectionName 、 XmlSchemaCollectionOwningSchema 和 Type 屬性設定為 null) ：

SqlDbType	精確度	縮放	地區設定	比較選項
Binary	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
Text	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

指定排序資料行的序數。

備註

如需詳細資訊，請參閱 資料表值參數。