SqlMetaData クラス

定義

名前空間:

Microsoft.SqlServer.Server

アセンブリ:

System.Data.SqlClient.dll

パッケージ:

System.Data.SqlClient v4.8.5

SqlDataRecord オブジェクトのパラメーターおよび列からメタデータ情報を指定して取得します。 このクラスは継承できません。

public ref class SqlMetaData sealed

public sealed class SqlMetaData

type SqlMetaData = class

Public NotInheritable Class SqlMetaData

継承

Object

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	text、ntext、image の各データ型の長さを取得します。
MaxLength	列またはパラメーターの最大長を取得します。
Name	列またはパラメーターの名前を取得します。
Precision	列またはパラメーターの有効桁数を取得します。
Scale	列またはパラメーターの小数点以下桁数を取得します。
SortOrder	列の並べ替え順序を返します。
SortOrdinal	並べ替え列の序数を返します。
SqlDbType	列またはパラメーターのデータ型を取得します。
Type	ユーザー定義型 (UDT) の共通言語ランタイム (CLR) 型を取得します。
TypeName	インスタンスによって表されるユーザー定義型 (UDT) または SQL Server データ型の、3 つの部分で構成される名前を取得します。
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 のインスタンスとして返します。