SqlMetaDataとは? わかりやすく解説

SqlMetaData クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: Microsoft.SqlServer.Server
アセンブリ: System.Data (system.data.dll 内)
構文構文

Public NotInheritable Class
 SqlMetaData
public sealed class SqlMetaData
public ref class SqlMetaData sealed
public final class SqlMetaData
使用例使用例

レコードの列メタデータを定義するいくつかの SqlMetaData オブジェクトを作成する方法、および SqlDataRecord を作成する方法の例を次に示します。SqlDataRecord の列の値を設定し、SqlContext クラスを使用する呼び出し元のプログラムに SqlDataRecord を送信します。

<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
[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);
}
継承階層継承階層
System.Object
  Microsoft.SqlServer.Server.SqlMetaData
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
SqlMetaData メンバ
Microsoft.SqlServer.Server 名前空間

SqlMetaData クラス

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

名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)
構文構文

Public NotInheritable Class
 SqlMetaData
public sealed class SqlMetaData
public ref class SqlMetaData sealed
public final class SqlMetaData
継承階層継承階層
System.Object
   System.Data.InternalDataCollectionBase
    System.Data.SqlServerCe.SqlMetaData
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
SqlMetaData メンバ
System.Data.SqlServerCe 名前空間

SqlMetaData コンストラクタ

SqlMetaData クラスの新しいインスタンスを初期化します。
オーバーロードの一覧オーバーロードの一覧

名前 説明
SqlMetaData (String, SqlDbType) 指定された列名と型で SqlMetaData クラスの新しいインスタンスを初期化します。
SqlMetaData (String, SqlDbType, Int64) 指定された列名、型、および最大長で SqlMetaData クラスの新しいインスタンスを初期化します。
SqlMetaData (String, SqlDbType, Type) 指定された列名、型、およびユーザー定義型 (UDT) で SqlMetaData クラスの新しいインスタンスを初期化します。
SqlMetaData (String, SqlDbType, Byte, Byte) 指定された列名、型、有効桁数、および小数点以下桁数で SqlMetaData クラスの新しいインスタンスを初期化します。
SqlMetaData (String, SqlDbType, Int64, Int64, SqlCompareOptions) 指定された列名、型、最大長、ロケール、および比較オプションで SqlMetaData クラスの新しいインスタンスを初期化します。
SqlMetaData (String, SqlDbType, String, String, String) 指定された列名、型、データベース名、所有スキーマ、およびオブジェクト名で SqlMetaData クラスの新しいインスタンスを初期化します。
SqlMetaData (String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type) 指定された列名、型、最大長、有効桁数、小数点以下桁数、ロケール ID、比較オプション、およびユーザー定義型 (UDT) で SqlMetaData クラスの新しいインスタンスを初期化します。
参照参照

関連項目

SqlMetaData クラス
SqlMetaData メンバ
Microsoft.SqlServer.Server 名前空間

SqlMetaData コンストラクタ (String, SqlDbType, Byte, Byte)

指定された列名、型、およびユーザー定義型で SqlMetaData クラスの新しいインスタンスを初期化します。

名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)
構文構文

Public Sub New ( _
    name As String, _
    dbType As SqlDbType, _
    precision As Byte, _
    scale As Byte _
)
Dim name As String
Dim dbType As SqlDbType
Dim precision As Byte
Dim scale As Byte

Dim instance As New SqlMetaData(name,
 dbType, precision, scale)
public SqlMetaData (
    string name,
    SqlDbType dbType,
    byte precision,
    byte scale
)
public:
SqlMetaData (
    String^ name, 
    SqlDbType dbType, 
    unsigned char precision, 
    unsigned char scale
)
public SqlMetaData (
    String name, 
    SqlDbType dbType, 
    byte precision, 
    byte scale
)
public function SqlMetaData (
    name : String, 
    dbType : SqlDbType, 
    precision : byte, 
    scale : byte
)

パラメータ

name

列の名前。

dbType

パラメータまたは列の SQL Server データ型。

precision

パラメータまたは列の有効桁数。

scale

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

.NET Framework のセキュリティ.NET Framework のセキュリティ
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
SqlMetaData クラス
SqlMetaData メンバ
System.Data.SqlServerCe 名前空間

SqlMetaData コンストラクタ (String, SqlDbType, Int64, Int64, SqlCompareOptions)

指定された列名、型、有効桁数、および小数点以下桁数で SqlMetaData クラスの新しいインスタンスを初期化します。

名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)
構文構文

Public Sub New ( _
    name As String, _
    dbType As SqlDbType, _
    maxLength As Long, _
    locale As Long, _
    compareOptions As SqlCompareOptions _
)
Dim name As String
Dim dbType As SqlDbType
Dim maxLength As Long
Dim locale As Long
Dim compareOptions As SqlCompareOptions

Dim instance As New SqlMetaData(name,
 dbType, maxLength, locale, compareOptions)
public SqlMetaData (
    string name,
    SqlDbType dbType,
    long maxLength,
    long locale,
    SqlCompareOptions compareOptions
)
public:
SqlMetaData (
    String^ name, 
    SqlDbType dbType, 
    long long maxLength, 
    long long locale, 
    SqlCompareOptions compareOptions
)
public SqlMetaData (
    String name, 
    SqlDbType dbType, 
    long maxLength, 
    long locale, 
    SqlCompareOptions compareOptions
)
public function SqlMetaData (
    name : String, 
    dbType : SqlDbType, 
    maxLength : long, 
    locale : long, 
    compareOptions : SqlCompareOptions
)

パラメータ

name

パラメータまたは列の名前。

dbType

パラメータまたは列の SQL Server データ型。

maxLength

指定された型の最大長。

locale

パラメータまたは列のロケール ID。

compareOptions

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

.NET Framework のセキュリティ.NET Framework のセキュリティ
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
SqlMetaData クラス
SqlMetaData メンバ
System.Data.SqlServerCe 名前空間

SqlMetaData コンストラクタ (String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type)

指定された列名、型、最大長、有効桁数、小数点以下桁数、ロケール ID、比較オプション、およびユーザー定義型で SqlMetaData クラスの新しいインスタンスを初期化します。

名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)
構文構文

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 _
)
Dim name As String
Dim dbType As SqlDbType
Dim maxLength As Long
Dim precision As Byte
Dim scale As Byte
Dim localeId As Long
Dim compareOptions As SqlCompareOptions
Dim userDefinedType As Type

Dim instance As New SqlMetaData(name,
 dbType, maxLength, precision, scale, localeId, compareOptions, userDefinedType)
public SqlMetaData (
    string name,
    SqlDbType dbType,
    long maxLength,
    byte precision,
    byte scale,
    long localeId,
    SqlCompareOptions compareOptions,
    Type userDefinedType
)
public:
SqlMetaData (
    String^ name, 
    SqlDbType dbType, 
    long long maxLength, 
    unsigned char precision, 
    unsigned char scale, 
    long long localeId, 
    SqlCompareOptions compareOptions, 
    Type^ userDefinedType
)
public SqlMetaData (
    String name, 
    SqlDbType dbType, 
    long maxLength, 
    byte precision, 
    byte scale, 
    long localeId, 
    SqlCompareOptions compareOptions, 
    Type userDefinedType
)
public function SqlMetaData (
    name : String, 
    dbType : SqlDbType, 
    maxLength : long, 
    precision : byte, 
    scale : byte, 
    localeId : long, 
    compareOptions : SqlCompareOptions, 
    userDefinedType : Type
)

パラメータ

name

パラメータまたは列の名前。

dbType

パラメータまたは列の SQL Server データ型。

maxLength

指定された型の最大長。

precision

パラメータまたは列の有効桁数。

scale

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

localeId

パラメータまたは列のロケール ID。

compareOptions

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

userDefinedType

ユーザー定義型を指す Type のインスタンス。

.NET Framework のセキュリティ.NET Framework のセキュリティ
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
SqlMetaData クラス
SqlMetaData メンバ
System.Data.SqlServerCe 名前空間

SqlMetaData コンストラクタ (String, SqlDbType, String, String, String)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

指定された列名、型、データベース名、所有スキーマ、およびオブジェクト名で SqlMetaData クラスの新しいインスタンスを初期化します。

名前空間: Microsoft.SqlServer.Server
アセンブリ: System.Data (system.data.dll 内)
構文構文

Public Sub New ( _
    name As String, _
    dbType As SqlDbType, _
    database As String, _
    owningSchema As String, _
    objectName As String _
)
Dim name As String
Dim dbType As SqlDbType
Dim database As String
Dim owningSchema As String
Dim objectName As String

Dim instance As New SqlMetaData(name,
 dbType, database, owningSchema, objectName)
public SqlMetaData (
    string name,
    SqlDbType dbType,
    string database,
    string owningSchema,
    string objectName
)
public:
SqlMetaData (
    String^ name, 
    SqlDbType dbType, 
    String^ database, 
    String^ owningSchema, 
    String^ objectName
)
public SqlMetaData (
    String name, 
    SqlDbType dbType, 
    String database, 
    String owningSchema, 
    String objectName
)
public function SqlMetaData (
    name : String, 
    dbType : SqlDbType, 
    database : String, 
    owningSchema : String, 
    objectName : String
)

パラメータ

name

列の名前。

dbType

パラメータまたは列の SQL Server データ型。

database

型指定された XML インスタンスの XML スキーマ コレクションのデータベース名。

owningSchema

型指定された XML インスタンスの XML スキーマ コレクションのリレーショナル スキーマ名。

objectName

型指定された XML インスタンスの XML スキーマ コレクションの名前。

例外例外
例外の種類条件

ArgumentNullException

Name が null 参照 (Visual Basic では Nothing) であるか、database と owningSchema が null 参照 (Visual Basic では Nothing) 以外の場合、objectName が null 参照 (Visual Basic では Nothing) です。

ArgumentException

使用できない SqlDbType が dbType としてコンストラクタに渡されました。

解説解説

コンストラクタに dbType として渡すことのできる SqlDbType は、Xml だけです。

次の表は、dbType に割り当てられる既定値を SqlDbType ごとに示したものです。

SqlDbType

最大長

有効桁数

小数点以下桁数

Locale

比較オプション

Xml

Max (-1)

0

0

0

IgnoreCase、IgnoreKanaType、IgnoreWidth

プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
SqlMetaData クラス
SqlMetaData メンバ
Microsoft.SqlServer.Server 名前空間

SqlMetaData コンストラクタ

SqlMetaData クラスの新しいインスタンスを初期化します。
オーバーロードの一覧オーバーロードの一覧

名前 説明
SqlMetaData (String, SqlDbType) 指定された列名と型で SqlMetaData クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

SqlMetaData (String, SqlDbType, Int64) 指定された列名、型、および最大長で SqlMetaData クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

SqlMetaData (String, SqlDbType, Byte, Byte) 指定された列名、型、およびユーザー定義型で SqlMetaData クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

SqlMetaData (String, SqlDbType, Int64, Int64, SqlCompareOptions) 指定された列名、型、有効桁数、および小数点以下桁数で SqlMetaData クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

SqlMetaData (String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type) 指定された列名、型、最大長、有効桁数、小数点以下桁数、ロケール ID、比較オプション、およびユーザー定義型で SqlMetaData クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

参照参照

関連項目

SqlMetaData クラス
SqlMetaData メンバ
System.Data.SqlServerCe 名前空間

SqlMetaData コンストラクタ (String, SqlDbType)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

指定された列名と型で SqlMetaData クラスの新しいインスタンスを初期化します。

名前空間: Microsoft.SqlServer.Server
アセンブリ: System.Data (system.data.dll 内)
構文構文

Public Sub New ( _
    name As String, _
    dbType As SqlDbType _
)
Dim name As String
Dim dbType As SqlDbType

Dim instance As New SqlMetaData(name,
 dbType)
public SqlMetaData (
    string name,
    SqlDbType dbType
)
public:
SqlMetaData (
    String^ name, 
    SqlDbType dbType
)
public SqlMetaData (
    String name, 
    SqlDbType dbType
)
public function SqlMetaData (
    name : String, 
    dbType : SqlDbType
)

パラメータ

name

列の名前。

dbType

パラメータまたは列の SQL Server データ型。

例外例外
例外の種類条件

ArgumentNullException

Name が null 参照 (Visual Basic では Nothing) です。

ArgumentException

使用できない SqlDbType が dbType としてコンストラクタに渡されました。

解説解説

コンストラクタに dbType として渡すことができるのは、Bit、BigInt、DateTime、Decimal、Float、Int、Money、Numeric、SmallDateTime、SmallInt、SmallMoney、TimeStamp、TinyInt、UniqueIdentifier、Xml だけです。

次の表は、dbType に割り当てられる既定値を SqlDbType ごとに示したものです (XmlSchemaCollectionDatabase、XmlSchemaCollectionName、XmlSchemaCollectionOwningSchema、および Type の各プロパティは null 参照 (Visual Basic では Nothing) に設定されています)。

SqlDbType

最大長

有効桁数

小数点以下桁数

Locale

比較オプション

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

使用例使用例

列名および SqlDbType.Int の列のデータ型を指定して、新しい SqlMetaData オブジェクトを作成する方法の例を次に示します。

Public Shared Sub CreateSqlMetaData2()

   Dim columnInfo As SqlMetaData
   columnInfo = new SqlMetaData("ColumnName",
 SqlDbType.Int)

End Sub
public static void CreateSqlMetaData2()
{
   SqlMetaData columnInfo;
   columnInfo = new SqlMetaData("Column2", SqlDbType.Int);
}
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
SqlMetaData クラス
SqlMetaData メンバ
Microsoft.SqlServer.Server 名前空間

SqlMetaData コンストラクタ (String, SqlDbType, Int64)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

指定された列名、型、および最大長で SqlMetaData クラスの新しいインスタンスを初期化します。

名前空間: Microsoft.SqlServer.Server
アセンブリ: System.Data (system.data.dll 内)
構文構文

Public Sub New ( _
    name As String, _
    dbType As SqlDbType, _
    maxLength As Long _
)
Dim name As String
Dim dbType As SqlDbType
Dim maxLength As Long

Dim instance As New SqlMetaData(name,
 dbType, maxLength)
public SqlMetaData (
    string name,
    SqlDbType dbType,
    long maxLength
)
public:
SqlMetaData (
    String^ name, 
    SqlDbType dbType, 
    long long maxLength
)
public SqlMetaData (
    String name, 
    SqlDbType dbType, 
    long maxLength
)
public function SqlMetaData (
    name : String, 
    dbType : SqlDbType, 
    maxLength : long
)

パラメータ

name

列の名前。

dbType

パラメータまたは列の SQL Server データ型。

maxLength

指定された型の最大長。

例外例外
例外の種類条件

ArgumentNullException

Name が null 参照 (Visual Basic では Nothing) です。

ArgumentException

使用できない SqlDbType が dbType としてコンストラクタに渡されました。

解説解説

コンストラクタに dbType として渡すことができるのは、Binary、Char、Image、NChar、Ntext、NVarChar、Text、VarBinary、VarChar だけです。

dbType が Text、NText、または Image の場合、maxLength には Max (-1) のみ指定できます。

dbType が Varchar、Nvarchar、または VarBinary の場合、長さを Max (-1) として指定することにより、メタデータがそれぞれ、varchar(max)、nvarchar(max)、nvarbinary(max) として宣言されます。

次の表は、dbType に割り当てられる既定値を SqlDbType ごとに示したものです (XmlSchemaCollectionDatabase、XmlSchemaCollectionName、XmlSchemaCollectionOwningSchema、および Type の各プロパティは null 参照 (Visual Basic では Nothing) に設定されています)。

SqlDbType

有効桁数

小数点以下桁数

Locale

比較オプション

Binary

0

0

0

IgnoreCase、IgnoreKanaType、IgnoreWidth

Char

0

0

<スレッド>

IgnoreCase、IgnoreKanaType、IgnoreWidth

Image

0

0

0

なし

NChar

0

0

<スレッド>

IgnoreCase、IgnoreKanaType、IgnoreWidth

NText

0

0

<スレッド>

IgnoreCase、IgnoreKanaType、IgnoreWidth

NVarChar

0

0

<スレッド>

IgnoreCase、IgnoreKanaType、IgnoreWidth

Text

0

0

<スレッド>

IgnoreCase、IgnoreKanaType、IgnoreWidth

VarBinary

0

0

IgnoreCase、IgnoreKanaType、IgnoreWidth

VarChar

0

0

<スレッド>

IgnoreCase、IgnoreKanaType、IgnoreWidth

使用例使用例

列名、SqlDbType.NVarChar の列のデータ型、および最大長として 12 文字を指定して、新しい SqlMetaData オブジェクトを作成する方法の例を次に示します。

Public Shared Sub CreateSqlMetaData1()

   Dim columnInfo As SqlMetaData
   columnInfo = new SqlMetaData("ColumnName",
 SqlDbType.NVarChar, 12)

End Sub
public static void CreateSqlMetaData1()
{
   SqlMetaData columnInfo;
   columnInfo = new SqlMetaData("Column1", SqlDbType.NVarChar,
 12);
}
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
SqlMetaData クラス
SqlMetaData メンバ
Microsoft.SqlServer.Server 名前空間

SqlMetaData コンストラクタ (String, SqlDbType, Type)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

指定された列名、型、およびユーザー定義型 (UDT) で SqlMetaData クラスの新しいインスタンスを初期化します。

名前空間: Microsoft.SqlServer.Server
アセンブリ: System.Data (system.data.dll 内)
構文構文

Public Sub New ( _
    name As String, _
    dbType As SqlDbType, _
    userDefinedType As Type _
)
Dim name As String
Dim dbType As SqlDbType
Dim userDefinedType As Type

Dim instance As New SqlMetaData(name,
 dbType, userDefinedType)
public SqlMetaData (
    string name,
    SqlDbType dbType,
    Type userDefinedType
)
public:
SqlMetaData (
    String^ name, 
    SqlDbType dbType, 
    Type^ userDefinedType
)
public SqlMetaData (
    String name, 
    SqlDbType dbType, 
    Type userDefinedType
)
public function SqlMetaData (
    name : String, 
    dbType : SqlDbType, 
    userDefinedType : Type
)

パラメータ

name

列の名前。

dbType

パラメータまたは列の SQL Server データ型。

userDefinedType

UDT を指す Type のインスタンス。

例外例外
例外の種類条件

ArgumentNullException

Name が null 参照 (Visual Basic では Nothing) です。

ArgumentException

使用できない SqlDbType が dbType としてコンストラクタに渡されたか、userDefinedType が、SqlUserDefinedTypeAttribute の宣言されていない型を指しています。

解説解説

コンストラクタに dbType として渡すことのできる SqlDbType は、UDT だけです。

次の表は、dbType に割り当てられる既定値を SqlDbType ごとに示したものです (XmlSchemaCollectionDatabase、XmlSchemaCollectionName、XmlSchemaCollectionOwningSchema、および Type の各プロパティは null 参照 (Visual Basic では Nothing) に設定されています)。

SqlDbType

最大長

有効桁数

小数点以下桁数

Locale

比較オプション

UDT

<型の最大長> または -1

0

0

0

なし

プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
SqlMetaData クラス
SqlMetaData メンバ
Microsoft.SqlServer.Server 名前空間

SqlMetaData コンストラクタ (String, SqlDbType, Byte, Byte)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

指定された列名、型、有効桁数、および小数点以下桁数で SqlMetaData クラスの新しいインスタンスを初期化します。

名前空間: Microsoft.SqlServer.Server
アセンブリ: System.Data (system.data.dll 内)
構文構文

Public Sub New ( _
    name As String, _
    dbType As SqlDbType, _
    precision As Byte, _
    scale As Byte _
)
Dim name As String
Dim dbType As SqlDbType
Dim precision As Byte
Dim scale As Byte

Dim instance As New SqlMetaData(name,
 dbType, precision, scale)
public SqlMetaData (
    string name,
    SqlDbType dbType,
    byte precision,
    byte scale
)
public:
SqlMetaData (
    String^ name, 
    SqlDbType dbType, 
    unsigned char precision, 
    unsigned char scale
)
public SqlMetaData (
    String name, 
    SqlDbType dbType, 
    byte precision, 
    byte scale
)
public function SqlMetaData (
    name : String, 
    dbType : SqlDbType, 
    precision : byte, 
    scale : byte
)

パラメータ

name

パラメータまたは列の名前。

dbType

パラメータまたは列の SQL Server データ型。

precision

パラメータまたは列の有効桁数。

scale

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

例外例外
例外の種類条件

ArgumentNullException

Name が null 参照 (Visual Basic では Nothing) です。

ArgumentException

使用できない SqlDbType が dbType としてコンストラクタに渡されたか、scale が precision を超えています。

解説解説

コンストラクタに dbType として渡すことのできる SqlDbType は、Decimal だけです。

次の表は、dbType に割り当てられる既定値を SqlDbType ごとに示したものです (XmlSchemaCollectionDatabase、XmlSchemaCollectionName、XmlSchemaCollectionOwningSchema、および Type の各プロパティは null 参照 (Visual Basic では Nothing) に設定されています)。

プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
SqlMetaData クラス
SqlMetaData メンバ
Microsoft.SqlServer.Server 名前空間

SqlMetaData コンストラクタ (String, SqlDbType, Int64, Int64, SqlCompareOptions)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

指定された列名、型、最大長、ロケール、および比較オプションで SqlMetaData クラスの新しいインスタンスを初期化します。

名前空間: Microsoft.SqlServer.Server
アセンブリ: System.Data (system.data.dll 内)
構文構文

Public Sub New ( _
    name As String, _
    dbType As SqlDbType, _
    maxLength As Long, _
    locale As Long, _
    compareOptions As SqlCompareOptions _
)
Dim name As String
Dim dbType As SqlDbType
Dim maxLength As Long
Dim locale As Long
Dim compareOptions As SqlCompareOptions

Dim instance As New SqlMetaData(name,
 dbType, maxLength, locale, compareOptions)
public SqlMetaData (
    string name,
    SqlDbType dbType,
    long maxLength,
    long locale,
    SqlCompareOptions compareOptions
)
public:
SqlMetaData (
    String^ name, 
    SqlDbType dbType, 
    long long maxLength, 
    long long locale, 
    SqlCompareOptions compareOptions
)
public SqlMetaData (
    String name, 
    SqlDbType dbType, 
    long maxLength, 
    long locale, 
    SqlCompareOptions compareOptions
)
public function SqlMetaData (
    name : String, 
    dbType : SqlDbType, 
    maxLength : long, 
    locale : long, 
    compareOptions : SqlCompareOptions
)

パラメータ

name

パラメータまたは列の名前。

dbType

パラメータまたは列の SQL Server データ型。

maxLength

指定された型の最大長。

locale

パラメータまたは列のロケール ID。

compareOptions

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

例外例外
例外の種類条件

ArgumentNullException

Name が null 参照 (Visual Basic では Nothing) です。

ArgumentException

使用できない SqlDbType が dbType としてコンストラクタに渡されました。

解説解説

コンストラクタに dbType として渡すことができるのは、Char、NChar、Ntext、NVarChar、Text、VarChar だけです。

dbType が Text または NText の場合、maxLength には Max (-1) のみ指定できます。

dbType が Varchar または Nvarchar の場合、長さを Max (-1) として指定することにより、メタデータがそれぞれ、varchar(max) および nvarchar(max) として宣言されます。

次の表は、dbType に割り当てられる既定値を SqlDbType ごとに示したものです (XmlSchemaCollectionDatabase、XmlSchemaCollectionName、XmlSchemaCollectionOwningSchema、および Type の各プロパティは null 参照 (Visual Basic では Nothing) に設定されています)。

SqlDbType

有効桁数

小数点以下桁数

Char

0

0

NChar

0

0

NText

0

0

NVarChar

0

0

Text

0

0

VarChar

0

0

プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
SqlMetaData クラス
SqlMetaData メンバ
Microsoft.SqlServer.Server 名前空間

SqlMetaData コンストラクタ (String, SqlDbType, Int64, Byte, Byte, Int64, SqlCompareOptions, Type)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

指定された列名、型、最大長、有効桁数、小数点以下桁数、ロケール ID、比較オプション、およびユーザー定義型 (UDT) で SqlMetaData クラスの新しいインスタンスを初期化します。

名前空間: Microsoft.SqlServer.Server
アセンブリ: System.Data (system.data.dll 内)
構文構文

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 _
)
Dim name As String
Dim dbType As SqlDbType
Dim maxLength As Long
Dim precision As Byte
Dim scale As Byte
Dim localeId As Long
Dim compareOptions As SqlCompareOptions
Dim userDefinedType As Type

Dim instance As New SqlMetaData(name,
 dbType, maxLength, precision, scale, localeId, compareOptions, userDefinedType)
public SqlMetaData (
    string name,
    SqlDbType dbType,
    long maxLength,
    byte precision,
    byte scale,
    long localeId,
    SqlCompareOptions compareOptions,
    Type userDefinedType
)
public:
SqlMetaData (
    String^ name, 
    SqlDbType dbType, 
    long long maxLength, 
    unsigned char precision, 
    unsigned char scale, 
    long long localeId, 
    SqlCompareOptions compareOptions, 
    Type^ userDefinedType
)
public SqlMetaData (
    String name, 
    SqlDbType dbType, 
    long maxLength, 
    byte precision, 
    byte scale, 
    long localeId, 
    SqlCompareOptions compareOptions, 
    Type userDefinedType
)
public function SqlMetaData (
    name : String, 
    dbType : SqlDbType, 
    maxLength : long, 
    precision : byte, 
    scale : byte, 
    localeId : long, 
    compareOptions : SqlCompareOptions, 
    userDefinedType : Type
)

パラメータ

name

列の名前。

dbType

パラメータまたは列の SQL Server データ型。

maxLength

指定された型の最大長。

precision

パラメータまたは列の有効桁数。

scale

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

localeId

パラメータまたは列のロケール ID。

compareOptions

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

userDefinedType

UDT を指す Type のインスタンス。

例外例外
例外の種類条件

ArgumentNullException

Name が null 参照 (Visual Basic では Nothing) です。

ArgumentException

使用できない SqlDbType が dbType としてコンストラクタに渡されたか、userDefinedType が、SqlUserDefinedTypeAttribute の宣言されていない型を指しています。

解説解説

コンストラクタに dbType として渡すことができるのは、BigInt、Bit、BitInt、DateTime、Decimal、Float、Image、Int、Money、Ntext、Numeric、Real、SmallDateTime、SmallInt、SmallMoney、Text、TimeStamp、TinyInt、UniqueIdentifier、Variant、Xml だけです。

次の表は、dbType に割り当てられる既定値を SqlDbType ごとに示したものです (XmlSchemaCollectionDatabase、XmlSchemaCollectionName、XmlSchemaCollectionOwningSchema、および Type の各プロパティは null 参照 (Visual Basic では Nothing) に設定されています)。

SqlDbType

最大長

有効桁数

小数点以下桁数

Locale

比較オプション

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

<スレッド>

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

<スレッド>

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 クラス
SqlMetaData メンバ
Microsoft.SqlServer.Server 名前空間

SqlMetaData コンストラクタ (String, SqlDbType)

指定された列名と型で SqlMetaData クラスの新しいインスタンスを初期化します。

名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)
構文構文

Public Sub New ( _
    name As String, _
    dbType As SqlDbType _
)
Dim name As String
Dim dbType As SqlDbType

Dim instance As New SqlMetaData(name,
 dbType)
public SqlMetaData (
    string name,
    SqlDbType dbType
)
public:
SqlMetaData (
    String^ name, 
    SqlDbType dbType
)
public SqlMetaData (
    String name, 
    SqlDbType dbType
)
public function SqlMetaData (
    name : String, 
    dbType : SqlDbType
)

パラメータ

name

列の名前。

dbType

パラメータまたは列の SQL Server データ型。

.NET Framework のセキュリティ.NET Framework のセキュリティ
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
SqlMetaData クラス
SqlMetaData メンバ
System.Data.SqlServerCe 名前空間

SqlMetaData コンストラクタ (String, SqlDbType, Int64)

指定された列名、型、および最大長で SqlMetaData クラスの新しいインスタンスを初期化します。

名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (system.data.sqlserverce.dll 内)
構文構文

Public Sub New ( _
    name As String, _
    dbType As SqlDbType, _
    maxLength As Long _
)
Dim name As String
Dim dbType As SqlDbType
Dim maxLength As Long

Dim instance As New SqlMetaData(name,
 dbType, maxLength)
public SqlMetaData (
    string name,
    SqlDbType dbType,
    long maxLength
)
public:
SqlMetaData (
    String^ name, 
    SqlDbType dbType, 
    long long maxLength
)
public SqlMetaData (
    String name, 
    SqlDbType dbType, 
    long maxLength
)
public function SqlMetaData (
    name : String, 
    dbType : SqlDbType, 
    maxLength : long
)

パラメータ

name

列の名前。

dbType

パラメータまたは列の SQL Server データ型。

maxLength

指定された型の最大長。

.NET Framework のセキュリティ.NET Framework のセキュリティ
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
SqlMetaData クラス
SqlMetaData メンバ
System.Data.SqlServerCe 名前空間

SqlMetaData プロパティ


パブリック プロパティパブリック プロパティ

  名前 説明
パブリック プロパティ MaxLength 列またはパラメータの最大長を取得します。
パブリック プロパティ Name 列またはパラメータの名前を取得します。
パブリック プロパティ Precision 列またはパラメータの有効桁数を取得します。
パブリック プロパティ Scale 列またはパラメータの小数点以下桁数を取得します。
パブリック プロパティ SqlDbType 列またはパラメータのデータ型を取得します。
パブリック プロパティ Type ユーザー定義型 (UDT) の共通言語ランタイム (CLR) 型を取得します。
パブリック プロパティ TypeName インスタンスによって表されるユーザー定義型 (UDT) または SQL Server データ型の、3 つの部分で構成される名前を取得します。
パブリック プロパティ XmlSchemaCollectionDatabase この XML インスタンスのスキーマ コレクションが置かれているデータベースの名前を取得します。
パブリック プロパティ XmlSchemaCollectionName この XML インスタンスに対応するスキーマ コレクションの名前を取得します。
パブリック プロパティ XmlSchemaCollectionOwningSchema この XML インスタンスのスキーマ コレクションが置かれている所有リレーショナル スキーマを取得します。
参照参照

関連項目

SqlMetaData クラス
Microsoft.SqlServer.Server 名前空間

SqlMetaData プロパティ


パブリック プロパティパブリック プロパティ

  名前 説明
パブリック プロパティ TypeName  
参照参照

関連項目

SqlMetaData クラス
System.Data.SqlServerCe 名前空間

SqlMetaData メソッド


パブリック メソッドパブリック メソッド

プロテクト メソッドプロテクト メソッド
参照参照

関連項目

SqlMetaData クラス
Microsoft.SqlServer.Server 名前空間

SqlMetaData メソッド


パブリック メソッドパブリック メソッド

プロテクト メソッドプロテクト メソッド
参照参照

関連項目

SqlMetaData クラス
System.Data.SqlServerCe 名前空間

SqlMetaData メンバ

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

SqlMetaData データ型で公開されるメンバを以下の表に示します。


パブリック コンストラクタパブリック コンストラクタ
パブリック プロパティパブリック プロパティ
  名前 説明
パブリック プロパティ MaxLength 列またはパラメータの最大長を取得します。
パブリック プロパティ Name 列またはパラメータの名前を取得します。
パブリック プロパティ Precision 列またはパラメータの有効桁数を取得します。
パブリック プロパティ Scale 列またはパラメータの小数点以下桁数を取得します。
パブリック プロパティ SqlDbType 列またはパラメータのデータ型を取得します。
パブリック プロパティ Type ユーザー定義型 (UDT) の共通言語ランタイム (CLR) 型を取得します。
パブリック プロパティ TypeName インスタンスによって表されるユーザー定義型 (UDT) または SQL Server データ型の、3 つの部分で構成される名前を取得します。
パブリック プロパティ XmlSchemaCollectionDatabase この XML インスタンスのスキーマ コレクションが置かれているデータベースの名前を取得します。
パブリック プロパティ XmlSchemaCollectionName この XML インスタンスに対応するスキーマ コレクションの名前を取得します。
パブリック プロパティ XmlSchemaCollectionOwningSchema この XML インスタンスのスキーマ コレクションが置かれている所有リレーショナル スキーマを取得します。
パブリック メソッドパブリック メソッド
プロテクト メソッドプロテクト メソッド
参照参照

関連項目

SqlMetaData クラス
Microsoft.SqlServer.Server 名前空間

SqlMetaData メンバ

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

SqlMetaData データ型で公開されるメンバを以下の表に示します。


パブリック コンストラクタパブリック コンストラクタ
パブリック プロパティパブリック プロパティ
  名前 説明
パブリック プロパティ TypeName  
パブリック メソッドパブリック メソッド
プロテクト メソッドプロテクト メソッド
参照参照

関連項目

SqlMetaData クラス
System.Data.SqlServerCe 名前空間



英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

「SqlMetaData」の関連用語

SqlMetaDataのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



SqlMetaDataのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS