SqlMetaData 類別

定義

指定並擷取 SqlDataRecord 物件之參數和資料行的中繼資料 (Metadata) 資訊。 此類別無法獲得繼承。

public ref class SqlMetaData sealed
public sealed class SqlMetaData
type SqlMetaData = class
Public 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

建構函式

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 類別的新執行個體。 這個形式的建構函式允許您指定資料行在資料表值參數中是否是唯一的、資料行的排序順序和排序資料行的序數,以支援資料表值參數。

屬性

CompareOptions

取得用於資料行或參數的比較規則。

DbType

取得資料行或參數的資料型別。

IsUniqueKey

指出資料表值參數中的資料行是否是唯一的。

LocaleId

取得資料行或參數的地區設定 ID。

Max

取得 textntextimage 資料型別的長度。

MaxLength

取得資料行或參數的最大長度。

Name

取得資料行或參數的名稱。

Precision

取得資料行或參數的精確度。

Scale

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

SortOrder

傳回資料行的排序順序。

SortOrdinal

傳回排序資料行的序數。

SqlDbType

取得資料行或參數的資料型別。

Type

取得使用者定義型別 (UDT) 的 Common Language Runtime (CLR) 型別。

TypeName

取得由執行個體表示之使用者定義型別 (UDT) 或 SQL Server 型別的三部分名稱。

UseServerDefault

報告這個資料行是否應該使用預設的伺服器值。

XmlSchemaCollectionDatabase

取得這個 XML 執行個體結構描述集合所在的資料庫名稱。

XmlSchemaCollectionName

取得這個 XML 執行個體的結構描述集合名稱。

XmlSchemaCollectionOwningSchema

取得這個 XML 執行個體之結構描述集合所在的擁有關聯式結構描述。

方法

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 執行個體傳回。

適用於