SqlMetaData 建構函式

定義

命名空間:: Microsoft.Data.SqlClient.Server

組件:: Microsoft.Data.SqlClient.dll

套件:: Microsoft.Data.SqlClient v1.0.19269.1

套件:: Microsoft.Data.SqlClient v1.1.4

套件:: Microsoft.Data.SqlClient v2.0.1

套件:: Microsoft.Data.SqlClient v2.1.4

套件:: Microsoft.Data.SqlClient v3.0.1

套件:: Microsoft.Data.SqlClient v3.1.0

套件:: Microsoft.Data.SqlClient v4.0.1

套件:: Microsoft.Data.SqlClient v4.1.0

套件:: Microsoft.Data.SqlClient v5.0.0

套件:: Microsoft.Data.SqlClient v5.1.0

套件:: Microsoft.Data.SqlClient v5.2.0

套件:: Microsoft.Data.SqlClient v6.0.2

套件:: Microsoft.Data.SqlClient v6.1.3

套件:: Microsoft.Data.SqlClient v7.0.3

套件:: Microsoft.Data.SqlClient v7.1.0

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

名稱	Description
SqlMetaData(String, SqlDbType)	初始化一個以指定欄位名稱與型別的類別新實例 SqlMetaData 。
SqlMetaData(String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type, Boolean, Boolean, SortOrder, Int32)	初始化一個新的類別實例 SqlMetaData ，並以指定的欄位名稱、類型、最大長度、精確度、縮放、區域 ID、比較選項及使用者定義型別（UDT）初始化。這種形式的建構函式支援資料表值參數，方法是透過允許您指定資料表值參數中的資料行是否為唯一、資料行的排序次序，以及排序資料行的序數。
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)	初始化一個新的類別實例SqlMetaData，使用指定的欄位名稱、類型、使用者定義類型、SQL Server 類型及伺服器預設值。這種形式的建構函式支援資料表值參數，方法是透過允許您指定資料表值參數中的資料行是否為唯一、資料行的排序次序，以及排序資料行的序數。
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)	初始化一個新的類別實例 SqlMetaData ，並以指定的欄位名稱、類型、最大長度、精確度、縮放、區域 ID、比較選項及使用者定義型別（UDT）初始化。
SqlMetaData(String, SqlDbType, String, String, String)	初始化一個新的類別實例 SqlMetaData ，包含指定的欄位名稱、類型、資料庫名稱、擁有結構及物件名稱。
SqlMetaData(String, SqlDbType, Int64, Int64, SqlCompareOptions)	初始化一個新實例 SqlMetaData ，並以指定的欄位名稱、類型、最大長度、位置及比較選項。
SqlMetaData(String, SqlDbType, Type, String)	初始化一個新的類別實例SqlMetaData，使用指定的欄位名稱、使用者定義型別（UDT）及 SQL Server 型別。
SqlMetaData(String, SqlDbType, Byte, Byte)	初始化一個類別的新實例 SqlMetaData ，並以指定的欄位名稱、類型、精確度和縮放值。
SqlMetaData(String, SqlDbType, Type)	初始化一個新的類別實例 SqlMetaData ，並以指定的欄位名稱、型別及使用者定義型別（UDT）初始化。
SqlMetaData(String, SqlDbType, Int64)	初始化一個以指定欄位名稱、類型及最大長度的新類別實例 SqlMetaData 。
SqlMetaData(String, SqlDbType, Boolean, Boolean, SortOrder, Int32)	初始化一個以指定欄位名稱和預設伺服器的新類別實例 SqlMetaData 。這種形式的建構函式支援資料表值參數，方法是透過允許您指定資料表值參數中的資料行是否為唯一、資料行的排序次序，以及排序資料行的序數。

SqlMetaData(String, SqlDbType)

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

初始化一個以指定欄位名稱與型別的類別新實例 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

不允許的 A SqlDbType 被傳遞給 dbType構造子。

範例

以下範例透過指定欄位名稱及欄位資料型態來建立一個新 SqlMetaData 物件 Int

using Microsoft.Data.SqlClient.Server;

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

備註

僅允許以下內容傳遞給此構造子：dbTypeBit， DateTime Money IntNumericFloat SmallDateTime SmallInt Decimal BigInt Timestamp TinyInt SmallMoney UniqueIdentifier，，，，， Xml

以下是根據的預設值分配給（， XmlSchemaCollectionDatabase，，，及Type屬性設為null）： XmlSchemaCollectionOwningSchema XmlSchemaCollectionName SqlDbTypedbType

SqlDbType	最大長度	精確度	調整	比較選項
Bit	1	1	0	None
BigInt	8	19	0	None
DateTime	8	23	3	None
Decimal	9	18	0	None
Float	8	53	0	None
Int	4	10	0	None
Money	8	19	4	None
`Numeric`	9	18	0	None
SmallDateTime	4	16	0	None
SmallInt	2	5	0	None
SmallMoney	4	10	4	None
Timestamp	8	0	0	None
TinyInt	1	3	0	None
UniqueIdentifier	16	0	0	None
Xml	麥克斯（-1）	0	0	忽略大小寫、忽略KanaType、忽略寬度

適用於

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

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

初始化一個新的類別實例 SqlMetaData ，並以指定的欄位名稱、類型、最大長度、精確度、縮放、區域 ID、比較選項及使用者定義型別（UDT）初始化。這種形式的建構函式支援資料表值參數，方法是透過允許您指定資料表值參數中的資料行是否為唯一、資料行的排序次序，以及排序資料行的序數。

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

參數或欄位的區域識別碼。

compareOptions: SqlCompareOptions

參數或欄位的比較規則。

userDefinedType: Type

這也 Type 指向UDT的例子。

useServerDefault: Boolean

指定此欄位是否應使用預設伺服器值。

isUniqueKey: Boolean

指定表值參數中的欄位是否唯一。

columnSortOrder: SortOrder

指定欄位的排序順序。

sortOrdinal: Int32

指定排序欄的序數。

備註

欲了解更多資訊，請參閱 Table-Valued 參數。

適用於

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

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

初始化一個新實例 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

指定排序欄的序數。

備註

欲了解更多資訊，請參閱 Table-Valued 參數。

適用於

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

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

初始化一個新實例 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

參數或欄位的區域識別碼。

compareOptions: SqlCompareOptions

參數或欄位的比較規則。

useServerDefault: Boolean

指定此欄位是否應使用預設伺服器值。

isUniqueKey: Boolean

指定表值參數中的欄位是否唯一。

columnSortOrder: SortOrder

指定欄位的排序順序。

sortOrdinal: Int32

指定排序欄的序數。

備註

欲了解更多資訊，請參閱 Table-Valued 參數。

適用於

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

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

初始化一個新的類別實例SqlMetaData，使用指定的欄位名稱、類型、使用者定義類型、SQL Server 類型及伺服器預設值。這種形式的建構函式支援資料表值參數，方法是透過允許您指定資料表值參數中的資料行是否為唯一、資料行的排序次序，以及排序資料行的序數。

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

這也 Type 指向UDT的例子。

serverTypeName: String

SQL Server 類型名稱為 userDefinedType。

useServerDefault: Boolean

指定此欄位是否應使用預設伺服器值。

isUniqueKey: Boolean

指定表值參數中的欄位是否唯一。

columnSortOrder: SortOrder

指定欄位的排序順序。

sortOrdinal: Int32

指定排序欄的序數。

備註

欲了解更多資訊，請參閱 Table-Valued 參數。

適用於

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

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

初始化一個新的類別實例 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

指定排序欄的序數。

備註

欲了解更多資訊，請參閱 Table-Valued 參數。

適用於

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

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

初始化一個以指定欄位名稱、類型、最大長度及伺服器預設值的新類別實例 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

指定排序欄的序數。

備註

欲了解更多資訊，請參閱 Table-Valued 參數。

適用於

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

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

初始化一個新的類別實例 SqlMetaData ，並以指定的欄位名稱、類型、最大長度、精確度、縮放、區域 ID、比較選項及使用者定義型別（UDT）初始化。

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

參數或欄位的區域識別碼。

compareOptions: SqlCompareOptions

參數或欄位的比較規則。

userDefinedType: Type

這也 Type 指向UDT的例子。

例外狀況

ArgumentNullException

name 是 null。

ArgumentException

不允許的 A SqlDbType 被傳遞給建構子，作為 dbType，或 userDefinedType 指向未宣 SqlUserDefinedTypeAttribute 告的型別。

備註

僅允許以下內容傳遞給構造者：dbTypeBigInt， Bit， DateTime， Udt Decimal Float RealNumericSmallDateTime NText SmallInt Money SmallMoney Text Int Image TinyInt UniqueIdentifier Timestamp Variant，， Xml

以下是根據的預設值分配給（， XmlSchemaCollectionDatabase，，，及Type屬性設為null）： XmlSchemaCollectionOwningSchema XmlSchemaCollectionName SqlDbTypedbType

SqlDbType	最大長度	精確度	調整	地區設定	比較選項
BigInt	8	19	0	0	None
Bit	1	1	0	0	None
DateTime	8	23	3	0	None
Decimal	9	18	0	0	None
Float	8	53	0	0	None
Image	麥克斯（-1）	0	0	0	None
Int	4	10	0	0	None
Money	8	19	4	0	None
NText	麥克斯（-1）	0	0	<線索>	忽略大小寫、忽略KanaType、忽略寬度
Real	4	24	0	0	None
`Row`	<欄數>	0	0	0	None
SmallDateTime	4	16	0	0	None
SmallInt	2	5	0	0	None
SmallMoney	4	10	4	0	None
Text	麥克斯（-1）	0	0	<線索>	忽略大小寫、忽略KanaType、忽略寬度
Timestamp	8	0	0	0	None
TinyInt	1	3	0	0	None
UniqueIdentifier	16	0	0	0	None
Udt	<該類型> 或 -1 的最大長度	0	0	0	None
Variant	8016	0	0	0	None
Xml	麥克斯（-1）	0	0	0	忽略大小寫、忽略KanaType、忽略寬度

適用於

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

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

初始化一個新的類別實例 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 當 nulldatabase 且 owningSchema 非 null時。

ArgumentException

不允許的 SqlDbType 會被傳給建構子。dbType

備註

僅允許以下內容SqlDbType傳遞給構造子： dbTypeXml。

以下是根據的SqlDbType預設值分配給 dbType：

SqlDbType	最大長度	精確度	調整	地區設定	比較選項
Xml	麥克斯（-1）	0	0	0	忽略大小寫、忽略KanaType、忽略寬度

適用於

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

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

初始化一個新實例 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

參數或欄位的區域識別碼。

compareOptions: SqlCompareOptions

參數或欄位的比較規則。

例外狀況

ArgumentNullException

name 是 null。

ArgumentException

不允許的 A SqlDbType 被傳遞給 dbType構造子。

備註

僅允許以下資料傳遞給構造者：dbTypeChar， NChar， NText NVarChar Text VarChar。

對於或 NText Text 的，僅maxLength允許 dbType 的規格Max為，或 -1。

對於 dbType 或 VarChar NVarChar，長度規格為 Max，或為 -1，分別宣告元資料為 VARCHAR（MAX）與 NVARCHAR（MAX）。

以下是根據的預設值分配給（， XmlSchemaCollectionDatabase，，，及Type屬性設為null）： XmlSchemaCollectionOwningSchema XmlSchemaCollectionName SqlDbTypedbType

SqlDbType	精確度	調整
Char	0	0
NChar	0	0
NText	0	0
NVarChar	0	0
Text	0	0
VarChar	0	0

適用於

SqlMetaData(String, SqlDbType, Type, String)

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

初始化一個新的類別實例SqlMetaData，使用指定的欄位名稱、使用者定義型別（UDT）及 SQL Server 型別。

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

這也 Type 指向UDT的例子。

serverTypeName: String

SQL Server 類型名稱為 userDefinedType。

適用於

SqlMetaData(String, SqlDbType, Byte, Byte)

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

初始化一個類別的新實例 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

不允許的 A SqlDbType 被傳遞給構造者，作為 dbType，或 scale 大於 precision。

備註

僅允許以下內容SqlDbType傳遞給構造子： dbTypeDecimal。

以下是根據的預設值分配給（， XmlSchemaCollectionDatabase，，，及Type屬性設為null）： XmlSchemaCollectionOwningSchema XmlSchemaCollectionName SqlDbTypedbType

SqlDbType	最大長度	精確度	調整	地區設定	比較選項
Decimal	9	18	0	0	None

適用於

SqlMetaData(String, SqlDbType, Type)

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

初始化一個新的類別實例 SqlMetaData ，並以指定的欄位名稱、型別及使用者定義型別（UDT）初始化。

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

這也 Type 指向UDT的例子。

例外狀況

ArgumentNullException

name 是 null。

ArgumentException

不允許的 A SqlDbType 被傳遞給建構子，作為 dbType，或 userDefinedType 指向未宣 SqlUserDefinedTypeAttribute 告的型別。

備註

僅允許以下內容SqlDbType傳遞給構造子： dbTypeUdt。

以下是根據的預設值分配給（， XmlSchemaCollectionDatabase，，，及Type屬性設為null）： XmlSchemaCollectionOwningSchema XmlSchemaCollectionName SqlDbTypedbType

SqlDbType	最大長度	精確度	調整	地區設定	比較選項
Udt	<該類型> 或 -1 的最大長度	0	0	0	None

適用於

SqlMetaData(String, SqlDbType, Int64)

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

初始化一個以指定欄位名稱、類型及最大長度的新類別實例 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

範例

以下範例透過指定欄位名稱、欄位資料型態 NVarChar，以及最大長度為 12 個字元來建立一個新SqlMetaData物件。

using Microsoft.Data.SqlClient.Server;

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

備註

僅允許以下內容傳遞給構造子：dbTypeBinary， Char， VarChar Text NText VarBinary Image NChar NVarChar。

對於、 NText Text、或 Image的，僅maxLength允許 dbType 的規範 Max、或 -1。

對於 dbType 、 NVarChar VarChar、或 VarBinary，長度規格Max為、或 -1，分別宣告元資料為 VARCHAR(MAX)、 NVARCHAR(MAX)、或 NVARBINARY(MAX)。

以下是根據的預設值分配給（， XmlSchemaCollectionDatabase，，，及Type屬性設為null）： XmlSchemaCollectionOwningSchema XmlSchemaCollectionName SqlDbTypedbType

SqlDbType	地區設定	比較選項
Binary	0	忽略大小寫、忽略KanaType、忽略寬度
Char	<線索>	忽略大小寫、忽略KanaType、忽略寬度
Image	0	None
NChar	<線索>	忽略大小寫、忽略KanaType、忽略寬度
NText	<線索>	忽略大小寫、忽略KanaType、忽略寬度
NVarChar	<線索>	忽略大小寫、忽略KanaType、忽略寬度
Text	<線索>	忽略大小寫、忽略KanaType、忽略寬度
VarBinary		忽略大小寫、忽略KanaType、忽略寬度
VarChar	<線索>	忽略大小寫、忽略KanaType、忽略寬度

適用於

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

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

來源:: SqlMetaData.cs

初始化一個以指定欄位名稱和預設伺服器的新類別實例 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

指定排序欄的序數。

備註

欲了解更多資訊，請參閱 Table-Valued 參數。

適用於