SqlMetaData コンストラクター

定義

名前空間:

Microsoft.Data.SqlClient.Server

アセンブリ:

Microsoft.Data.SqlClient.dll

パッケージ:

Microsoft.Data.SqlClient v7.1.0

オーバーロード

Name	説明
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)、およびSQL Server型を使用して、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型。

例外

ArgumentNullException

name は null です。

ArgumentException

許可されていない SqlDbType は、 dbTypeとしてコンストラクターに渡されました。

例

次の例では、列名と列データ型を指定して、新しい SqlMetaData オブジェクトを作成します。 Int

using Microsoft.Data.SqlClient.Server;

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

注釈

このコンストラクターには、 dbTypeBit、 BigInt、 DateTime、 Decimal、 Float、 Int、 Money、 Numeric、 SmallDateTime、 SmallInt、 SmallMoney、 Timestamp、 TinyInt、 UniqueIdentifier、 Xmlの各コンストラクターにのみ渡すことができます。

dbTypeに割り当てられる既定値は、SqlDbType (XmlSchemaCollectionDatabase、XmlSchemaCollectionName、XmlSchemaCollectionOwningSchema、Typeの各プロパティが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

並べ替え列の序数を指定します。

注釈

詳細については、「 Table-Valued パラメーター」を参照してください。

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

並べ替え列の序数を指定します。

注釈

詳細については、「 Table-Valued パラメーター」を参照してください。

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

並べ替え列の序数を指定します。

注釈

詳細については、「 Table-Valued パラメーター」を参照してください。

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

並べ替え列の序数を指定します。

注釈

詳細については、「 Table-Valued パラメーター」を参照してください。

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

並べ替え列の序数を指定します。

注釈

詳細については、「 Table-Valued パラメーター」を参照してください。

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

並べ替え列の序数を指定します。

注釈

詳細については、「 Table-Valued パラメーター」を参照してください。

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 インスタンス。

例外

ArgumentNullException

name は null です。

ArgumentException

許可されていない SqlDbType は、 dbTypeとしてコンストラクターに渡されたか、 userDefinedType 宣言されていない型を指 SqlUserDefinedTypeAttribute 。

注釈

dbTypeとしてコンストラクターに渡すことが許可されるのは、次のBigIntだけです。 Bit、DateTime、Decimal、Float、Image、Int、Money、NText、Numeric、RealSmallDateTime、SmallInt、SmallMoney、Text、Timestamp、TinyInt、Udt、UniqueIdentifier、Variant、Xml。

dbTypeに割り当てられる既定値は、SqlDbType (XmlSchemaCollectionDatabase、XmlSchemaCollectionName、XmlSchemaCollectionOwningSchema、Typeの各プロパティが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 スキーマ コレクションの名前。

例外

ArgumentNullException

nameがnullされるか、databaseとowningSchemaがnullでない場合にobjectNameがnullされます。

ArgumentException

許可されていない SqlDbType が、 dbTypeとしてコンストラクターに渡されました。

注釈

dbTypeとしてコンストラクターに渡すことが許可されているのは、次のSqlDbTypeだけです:Xml。

SqlDbTypeに応じて、dbTypeに割り当てられる既定値を次に示します。

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

パラメーターまたは列の比較規則。

例外

ArgumentNullException

name は null です。

ArgumentException

許可されていない SqlDbType は、 dbTypeとしてコンストラクターに渡されました。

注釈

dbTypeとしてコンストラクターに渡すことが許可されるのは、Char、NChar、NText、NVarChar、Text、VarCharのみです。

TextまたはNTextのdbTypeには、Max (-1) のmaxLength指定のみが許可されます。

VarCharまたはNVarCharのdbTypeの場合、Max (-1) の長さの指定では、メタデータをそれぞれ VARCHAR(MAX) および NVARCHAR(MAX) として宣言します。

dbTypeに割り当てられる既定値は、SqlDbType (XmlSchemaCollectionDatabase、XmlSchemaCollectionName、XmlSchemaCollectionOwningSchema、Typeの各プロパティが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)、およびSQL Server型を使用して、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

パラメーターまたは列の小数点以下桁数。

例外

ArgumentNullException

name は null です。

ArgumentException

許可されていない SqlDbType が、 dbTypeとしてコンストラクターに渡されたか、 scale が precisionより大きかった。

注釈

dbTypeとしてコンストラクターに渡すことが許可されているのは、次のSqlDbTypeだけです:Decimal。

dbTypeに割り当てられる既定値は、SqlDbType (XmlSchemaCollectionDatabase、XmlSchemaCollectionName、XmlSchemaCollectionOwningSchema、Typeの各プロパティが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 インスタンス。

例外

ArgumentNullException

name は null です。

ArgumentException

許可されていない SqlDbType は、 dbTypeとしてコンストラクターに渡されたか、 userDefinedType 宣言されていない型を指 SqlUserDefinedTypeAttribute 。

注釈

dbTypeとしてコンストラクターに渡すことが許可されているのは、次のSqlDbTypeだけです:Udt。

dbTypeに割り当てられる既定値は、SqlDbType (XmlSchemaCollectionDatabase、XmlSchemaCollectionName、XmlSchemaCollectionOwningSchema、Typeの各プロパティが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

指定した型の最大長。

例外

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);
}

注釈

dbTypeとしてコンストラクターに渡すことが許可されるのは、Binary、Char、Image、NChar、NText、NVarChar、Text、VarBinary、VarCharのみです。

Text、NText、またはImageのdbTypeには、Maxまたは -1 のmaxLength指定のみが許可されます。

VarChar、NVarChar、またはVarBinaryのdbTypeの場合、Max (-1) の長さの指定では、メタデータをそれぞれVARCHAR(MAX)、NVARCHAR(MAX)、またはNVARBINARY(MAX)として宣言します。

dbTypeに割り当てられる既定値は、SqlDbType (XmlSchemaCollectionDatabase、XmlSchemaCollectionName、XmlSchemaCollectionOwningSchema、Typeの各プロパティがnullに設定されている) に応じて次のとおりです。

SqlDbType	精度	[倍率]	ロケール	オプションを比較する
Binary	0	0	0	IgnoreCase、IgnoreKanaType、IgnoreWidth
Char	0	0	<thread>	IgnoreCase、IgnoreKanaType、IgnoreWidth
Image	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

並べ替え列の序数を指定します。

注釈

詳細については、「 Table-Valued パラメーター」を参照してください。