SqlMetaData 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
指定並擷取 SqlDataRecord 物件之參數和資料行的中繼資料 (Metadata) 資訊。 此類別無法獲得繼承。
public ref class SqlMetaData sealedpublic sealed class SqlMetaDatatype SqlMetaData = classPublic NotInheritable Class SqlMetaData- 繼承
-
SqlMetaData
範例
下列範例示範如何建立數 SqlMetaData 個 物件，其中描述記錄的資料行中繼資料，以及 建立 SqlDataRecord 。 的資料行值 SqlDataRecord 會設定，並使用 SqlDataRecord 類別傳送至呼叫程式 SqlContext 。
[Microsoft.SqlServer.Server.SqlProcedure]
public static void CreateNewRecord()
{
// Variables.
SqlMetaData column1Info;
SqlMetaData column2Info;
SqlMetaData column3Info;
SqlDataRecord record;
// Create the column metadata.
column1Info = new SqlMetaData("Column1", SqlDbType.NVarChar, 12);
column2Info = new SqlMetaData("Column2", SqlDbType.Int);
column3Info = new SqlMetaData("Column3", SqlDbType.DateTime);
// Create a new record with the column metadata.
record = new SqlDataRecord(new SqlMetaData[] { column1Info,
column2Info,
column3Info });
// Set the record fields.
record.SetString(0, "Hello World!");
record.SetInt32(1, 42);
record.SetDateTime(2, DateTime.Now);
// Send the record to the calling program.
SqlContext.Pipe.Send(record);
}
<Microsoft.SqlServer.Server.SqlProcedure()> _
Public Shared Sub CreateNewRecord()
' Variables.
Dim column1Info As SqlMetaData
Dim column2Info As SqlMetaData
Dim column3Info As SqlMetaData
Dim record As SqlDataRecord
' Create the column metadata.
column1Info = new SqlMetaData("Column1", SqlDbType.NVarChar, 12)
column2Info = new SqlMetaData("Column2", SqlDbType.Int)
column3Info = new SqlMetaData("Column3", SqlDbType.DateTime)
' Create a new record with the column metadata.
record = new SqlDataRecord(new SqlMetaData() { column1Info, _
column2Info, _
column3Info })
' Set the record fields.
record.SetString(0, "Hello World!")
record.SetInt32(1, 42)
record.SetDateTime(2, DateTime.Now)
' Send the record to the calling program.
SqlContext.Pipe.Send(record)
End Sub
建構函式
| 名稱 | Description |
|---|---|
| SqlMetaData(String, SqlDbType) |
使用指定的資料行名稱和型別，初始化 SqlMetaData 類別的新執行個體。 |
| SqlMetaData(String, SqlDbType, Boolean, Boolean, SortOrder, Int32) |
使用指定的資料行名稱和預設伺服器，初始化 SqlMetaData 類別的新執行個體。 這個形式的建構函式允許您指定資料行在資料表值參數中是否是唯一的、資料行的排序順序和排序資料行的序數，以支援資料表值參數。 |
| SqlMetaData(String, SqlDbType, Byte, Byte) |
使用指定的資料行名稱、型別、精確度和小數位數，初始化 SqlMetaData 類別的新執行個體。 |
| SqlMetaData(String, SqlDbType, Byte, Byte, Boolean, Boolean, SortOrder, Int32) |
使用指定的資料行名稱、型別、精確度、小數點位數和預設伺服器，初始化 SqlMetaData 類別的新執行個體。 這個形式的建構函式允許您指定資料行在資料表值參數中是否是唯一的、資料行的排序順序和排序資料行的序數，以支援資料表值參數。 |
| SqlMetaData(String, SqlDbType, Int64) |
使用指定的資料行名稱、型別和最大長度，初始化 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, Int64, Byte, Byte, Int64, SqlCompareOptions, Type, Boolean, Boolean, SortOrder, Int32) |
使用指定的資料行名稱、型別、最大長度、精確度、小數點位數、地區設定 ID、比較選項和使用者定義型別 (UDT)，初始化 SqlMetaData 類別的新執行個體。 這個形式的建構函式允許您指定資料行在資料表值參數中是否是唯一的、資料行的排序順序和排序資料行的序數，以支援資料表值參數。 |
| SqlMetaData(String, SqlDbType, Int64, Int64, SqlCompareOptions) |
使用指定的資料行名稱、型別、最大長度、地區設定和比較選項，初始化 SqlMetaData 類別的新執行個體。 |
| SqlMetaData(String, SqlDbType, Int64, Int64, SqlCompareOptions, Boolean, Boolean, SortOrder, Int32) |
以指定的資料行名稱、型別、最大長度、地區設定、比較選項和伺服器預設值，初始化 SqlMetaData 類別的新執行個體。 這個形式的建構函式允許您指定資料行在資料表值參數中是否是唯一的、資料行的排序順序和排序資料行的序數，以支援資料表值參數。 |
| SqlMetaData(String, SqlDbType, String, String, String) |
使用指定的資料行名稱、型別、資料庫名稱、擁有結構描述和物件名稱，初始化 SqlMetaData 類別的新執行個體。 |
| SqlMetaData(String, SqlDbType, String, String, String, Boolean, Boolean, SortOrder, Int32) |
以指定的資料行名稱、資料庫名稱、擁有結構描述、物件名稱和預設伺服器，初始化 SqlMetaData 類別的新執行個體。 這個形式的建構函式允許您指定資料行在資料表值參數中是否是唯一的、資料行的排序順序和排序資料行的序數，以支援資料表值參數。 |
| SqlMetaData(String, SqlDbType, Type) |
使用指定的資料行名稱、型別和使用者定義型別 (UDT)，初始化 SqlMetaData 類別的新執行個體。 |
| SqlMetaData(String, SqlDbType, Type, String) |
以指定的資料行名稱、使用者定義型別 (UDT) 和 SQLServer 型別，初始化 SqlMetaData 類別的新執行個體。 |
| SqlMetaData(String, SqlDbType, Type, String, Boolean, Boolean, SortOrder, Int32) |
以指定的資料行名稱、型別、使用者定義型別、SQL Server 型別和伺服器預設值，初始化 SqlMetaData 類別的新執行個體。 這個形式的建構函式允許您指定資料行在資料表值參數中是否是唯一的、資料行的排序順序和排序資料行的序數，以支援資料表值參數。 |
屬性
| 名稱 | Description |
|---|---|
| CompareOptions |
取得用於資料行或參數的比較規則。 |
| DbType |
取得資料行或參數的資料型別。 |
| IsUniqueKey |
指出資料表值參數中的資料行是否是唯一的。 |
| LocaleId |
取得資料行或參數的地區設定 ID。 |
| Max |
取得 |
| MaxLength |
取得資料行或參數的最大長度。 |
| Name |
取得資料行或參數的名稱。 |
| Precision |
取得資料行或參數的精確度。 |
| Scale |
取得資料行或參數的小數點位數。 |
| SortOrder |
傳回資料行的排序順序。 |
| SortOrdinal |
傳回排序資料行的序數。 |
| SqlDbType |
取得資料行或參數的資料型別。 |
| Type |
取得使用者定義型別 (UDT) 的 Common Language Runtime (CLR) 型別。 |
| TypeName |
取得由執行個體表示之使用者定義型別 (UDT) 或 SQL Server 型別的三部分名稱。 |
| UseServerDefault |
報告這個資料行是否應該使用預設的伺服器值。 |
| XmlSchemaCollectionDatabase |
取得這個 XML 執行個體結構描述集合所在的資料庫名稱。 |
| XmlSchemaCollectionName |
取得這個 XML 執行個體的結構描述集合名稱。 |
| XmlSchemaCollectionOwningSchema |
取得這個 XML 執行個體之結構描述集合所在的擁有關聯式結構描述。 |
方法
| 名稱 | Description |
|---|---|
| Adjust(Boolean) |
依中繼資料驗證指定的 Boolean 值，並在必要時調整此值。 |
| Adjust(Byte) |
依中繼資料驗證指定的 Byte 值，並在必要時調整此值。 |
| Adjust(Byte[]) |
依中繼資料驗證指定的 Byte 值陣列，並在必要時調整此值。 |
| Adjust(Char) |
依中繼資料驗證指定的 Char 值，並在必要時調整此值。 |
| Adjust(Char[]) |
依中繼資料驗證指定的 Char 值陣列，並在必要時調整此值。 |
| Adjust(DateTime) |
依中繼資料驗證指定的 DateTime 值，並在必要時調整此值。 |
| Adjust(DateTimeOffset) |
依中繼資料驗證指定的 DateTimeOffset 值，並在必要時調整此值。 |
| Adjust(Decimal) |
依中繼資料驗證指定的 Decimal 值，並在必要時調整此值。 |
| Adjust(Double) |
依中繼資料驗證指定的 Double 值，並在必要時調整此值。 |
| Adjust(Guid) |
依中繼資料驗證指定的 Guid 值，並在必要時調整此值。 |
| Adjust(Int16) |
依中繼資料驗證指定的 Int16 值，並在必要時調整此值。 |
| Adjust(Int32) |
依中繼資料驗證指定的 Int32 值，並在必要時調整此值。 |
| Adjust(Int64) |
依中繼資料驗證指定的 Int64 值，並在必要時調整此值。 |
| Adjust(Object) |
依中繼資料驗證指定的 Object 值，並在必要時調整此值。 |
| Adjust(Single) |
依中繼資料驗證指定的 Single 值，並在必要時調整此值。 |
| Adjust(SqlBinary) |
依中繼資料驗證指定的 SqlBinary 值，並在必要時調整此值。 |
| Adjust(SqlBoolean) |
依中繼資料驗證指定的 SqlBoolean 值，並在必要時調整此值。 |
| Adjust(SqlByte) |
依中繼資料驗證指定的 SqlByte 值，並在必要時調整此值。 |
| Adjust(SqlBytes) |
依中繼資料驗證指定的 SqlBytes 值，並在必要時調整此值。 |
| Adjust(SqlChars) |
依中繼資料驗證指定的 SqlChars 值，並在必要時調整此值。 |
| Adjust(SqlDateTime) |
依中繼資料驗證指定的 SqlDateTime 值，並在必要時調整此值。 |
| Adjust(SqlDecimal) |
依中繼資料驗證指定的 SqlDecimal 值，並在必要時調整此值。 |
| Adjust(SqlDouble) |
依中繼資料驗證指定的 SqlDouble 值，並在必要時調整此值。 |
| Adjust(SqlGuid) |
依中繼資料驗證指定的 SqlGuid 值，並在必要時調整此值。 |
| Adjust(SqlInt16) |
依中繼資料驗證指定的 SqlInt16 值，並在必要時調整此值。 |
| Adjust(SqlInt32) |
依中繼資料驗證指定的 SqlInt32 值，並在必要時調整此值。 |
| Adjust(SqlInt64) |
依中繼資料驗證指定的 SqlInt64 值，並在必要時調整此值。 |
| Adjust(SqlMoney) |
依中繼資料驗證指定的 SqlMoney 值，並在必要時調整此值。 |
| Adjust(SqlSingle) |
依中繼資料驗證指定的 SqlSingle 值，並在必要時調整此值。 |
| Adjust(SqlString) |
依中繼資料驗證指定的 SqlString 值，並在必要時調整此值。 |
| Adjust(SqlXml) |
依中繼資料驗證指定的 SqlXml 值，並在必要時調整此值。 |
| Adjust(String) |
依中繼資料驗證指定的 String 值，並在必要時調整此值。 |
| Adjust(TimeSpan) |
依中繼資料驗證指定的 TimeSpan 值，並在必要時調整此值。 |
| InferFromValue(Object, String) |
從指定的物件推斷中繼資料，並將其做為 SqlMetaData 執行個體傳回。 |