共用方式為


SqlMetaData 建構函式

定義

多載

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 型別。

例外狀況

namenull

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

範例

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

// using Microsoft.Data.SqlClient.Server;

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

備註

只允許將下列專案傳遞至建構函式: dbTypeBit 、、 BigIntDateTimeTimeStampXmlUniqueIdentifierTinyIntSmallMoneySmallIntNumericIntSmallDateTimeDecimalFloatMoney

以下是指派給 dbType 的預設值,視 SqlDbType (XmlSchemaCollectionDatabaseXmlSchemaCollectionNameXmlSchemaCollectionOwningSchemaType 屬性設定為 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 執行個體。

例外狀況

namenull

不允許的 SqlDbType 已做為 dbType 傳遞至建構函式,或 userDefinedType 指向未宣告 SqlUserDefinedTypeAttribute 的型別。

備註

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

以下是指派給 dbType 的預設值,視 SqlDbType (XmlSchemaCollectionDatabaseXmlSchemaCollectionNameXmlSchemaCollectionOwningSchemaType 屬性設定為 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 結構描述集合的名稱。

例外狀況

namenull,或當 objectNamedatabase 為非 nullowningSchemanull

傳遞給建構函式做為 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

參數或資料行的比較規則。

例外狀況

namenull

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

備註

只允許將下列專案傳遞至建構函式: dbTypeChar 、、 NCharNtextNVarChar 、、 TextVarChar

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

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

以下是指派給 dbType 的預設值,視 SqlDbType (XmlSchemaCollectionDatabaseXmlSchemaCollectionNameXmlSchemaCollectionOwningSchemaType 屬性設定為 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

參數或資料行的小數點位數。

例外狀況

namenull

不允許的 SqlDbType 已做為 dbType 傳遞至建構函式,或 scale 大於 precision

備註

只允許將下列專案 SqlDbType 傳遞至建構函式: dbTypeDecimal

以下是指派給 dbType 的預設值,視 SqlDbType (XmlSchemaCollectionDatabaseXmlSchemaCollectionNameXmlSchemaCollectionOwningSchemaType 屬性設定為 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 執行個體。

例外狀況

namenull

不允許的 SqlDbType 已做為 dbType 傳遞至建構函式,或 userDefinedType 指向未宣告 SqlUserDefinedTypeAttribute 的型別。

備註

只允許將下列專案 SqlDbType 傳遞至建構函式: dbTypeUDT

以下是指派給 dbType 的預設值,視 SqlDbType (XmlSchemaCollectionDatabaseXmlSchemaCollectionNameXmlSchemaCollectionOwningSchemaType 屬性設定為 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

指定之型別的最大長度。

例外狀況

namenull

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

範例

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

// using Microsoft.Data.SqlClient.Server;

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

備註

只允許將下列專案傳遞至建構函式: dbTypeBinaryCharImageNCharNtextNVarCharTextVarBinaryVarChar

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

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

以下是指派給 dbType 的預設值,視 SqlDbType (XmlSchemaCollectionDatabaseXmlSchemaCollectionNameXmlSchemaCollectionOwningSchemaType 屬性設定為 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

指定排序資料行的序數。

備註

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

適用於