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

SqlDataRecord クラス

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

単一行のデータおよびそのメタデータ表します。このクラス継承できません。

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

Public NotInheritable Class
 SqlDataRecord
    Implements IDataRecord
Dim instance As SqlDataRecord
public sealed class SqlDataRecord : IDataRecord
public ref class SqlDataRecord sealed : IDataRecord
public final class SqlDataRecord implements
 IDataRecord
public final class SqlDataRecord implements
 IDataRecord
解説解説
使用例使用例

レコードの列メタデータ定義するいくつかの 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.SqlDataRecord
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバ場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
SqlDataRecord メンバ
Microsoft.SqlServer.Server 名前空間

SqlDataRecord コンストラクタ

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

引数として渡されSqlMetaData オブジェクト配列に基づくスキーマで、新しSqlDataRecord インスタンス作成します

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

Public Sub New ( _
    ParamArray metaData As SqlMetaData() _
)
Dim metaData As SqlMetaData()

Dim instance As New SqlDataRecord(metaData)
public SqlDataRecord (
    params SqlMetaData[] metaData
)
public:
SqlDataRecord (
    ... array<SqlMetaData^>^ metaData
)
public SqlDataRecord (
    SqlMetaData[] metaData
)
public function SqlDataRecord (
    ... metaData : SqlMetaData[]
)

パラメータ

metaData

SqlDataRecord の各列を表す SqlMetaData オブジェクト配列

例外例外
例外種類条件

ArgumentNullException

metaDatanull 参照 (Visual Basic では Nothing) です。

使用例使用例

列名とデータ型を示す 2 つSqlMetaData オブジェクトから新しSqlDataRecord オブジェクト作成する方法の例を次に示します

' Variables.
Dim column1Info As SqlMetaData 
Dim column2Info As SqlMetaData
Dim record As SqlDataRecord

' Create the column metadata.
column1Info = new SqlMetaData("Column1",
 SqlDbType.NVarChar, 12)
column2Info = new SqlMetaData("Column2",
 SqlDbType.Int)

' Create a new record with the column metadata.      
record = new SqlDataRecord(new SqlMetaData()
 { column1Info, _
                                               column2Info })
// Variables.
SqlMetaData column1Info;
SqlMetaData column2Info;
SqlDataRecord record;

// Create the column metadata.
column1Info = new SqlMetaData("Column1", SqlDbType.NVarChar,
 12);
column2Info = new SqlMetaData("Column2", SqlDbType.Int);

// Create a new record with the column metadata.      
record = new SqlDataRecord(new SqlMetaData[]
 { column1Info, 
                                                  column2Info });
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
SqlDataRecord クラス
SqlDataRecord メンバ
Microsoft.SqlServer.Server 名前空間

SqlDataRecord プロパティ


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

参照参照

関連項目

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

SqlDataRecord メソッド


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

( プロテクト メソッド参照)
  名前 説明
パブリック メソッド Equals  オーバーロードされます2 つObject インスタンス等しかどうか判断します。 ( Object から継承されます。)
パブリック メソッド GetBoolean 序数指定された列の値を Boolean として取得します
パブリック メソッド GetByte 序数指定された列の値を Byte として取得します
パブリック メソッド GetBytes 序数指定された列の値を Byte オブジェクト配列として取得します
パブリック メソッド GetChar 序数指定された列の値を Char として取得します
パブリック メソッド GetChars 序数指定された列の値を Char オブジェクト配列として取得します
パブリック メソッド GetDataTypeName 列の序数引数として受け取り対応する列のデータ型名を返します
パブリック メソッド GetDateTime 序数指定された列の値を DateTime として取得します
パブリック メソッド GetDecimal 序数指定された列の値を Decimal として取得します
パブリック メソッド GetDouble 序数指定された列の値を Double として取得します
パブリック メソッド GetFieldType 列の序数引数として受け取り、その列の SQL Server データ型対応する共通言語ランタイム (CLR) のデータ型を、Type オブジェクトとして返します
パブリック メソッド GetFloat 序数指定された列の値を float として取得します
パブリック メソッド GetGuid 序数指定された列の値を Guid として取得します
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用適してます。 ( Object から継承されます。)
パブリック メソッド GetInt16 序数指定された列の値を Int16 として取得します
パブリック メソッド GetInt32 序数指定された列の値を Int32 として取得します
パブリック メソッド GetInt64 序数指定された列の値を Int64 として取得します
パブリック メソッド GetName 列の序数引数として受け取り対応する列の名前を返します
パブリック メソッド GetOrdinal 列名を引数受け取り対応する列の序数返します
パブリック メソッド GetSqlBinary 序数指定された列の値を SqlBinary として取得します
パブリック メソッド GetSqlBoolean 序数指定された列の値を SqlBoolean として取得します
パブリック メソッド GetSqlByte 序数指定された列の値を SqlByte として取得します
パブリック メソッド GetSqlBytes 序数指定された列の値を SqlBytes として取得します
パブリック メソッド GetSqlChars 序数指定された列の値を SqlChars として取得します
パブリック メソッド GetSqlDateTime 序数指定された列の値を SqlDateTime として取得します
パブリック メソッド GetSqlDecimal 序数指定された列の値を SqlDecimal として取得します
パブリック メソッド GetSqlDouble 序数指定された列の値を SqlDouble として取得します
パブリック メソッド GetSqlFieldType SQL Server の列型 (System.Data.SqlTypes で定義されている SQL Serverデータ型) に対応するデータ型を表す Type オブジェクト返します
パブリック メソッド GetSqlGuid 序数指定された列の値を SqlGuid として取得します
パブリック メソッド GetSqlInt16 序数指定された列の値を SqlInt16 として取得します
パブリック メソッド GetSqlInt32 序数指定された列の値を SqlInt32 として取得します
パブリック メソッド GetSqlInt64 序数指定された列の値を SqlInt64 として取得します
パブリック メソッド GetSqlMetaData 列の序数引数として受け取り対応する列のメタデータを表す SqlMetaData オブジェクト返します
パブリック メソッド GetSqlMoney 序数指定された列の値を SqlMoney として取得します
パブリック メソッド GetSqlSingle 序数指定された列の値を SqlSingle として取得します
パブリック メソッド GetSqlString 序数指定された列の値を SqlString として取得します
パブリック メソッド GetSqlValue 列の序数引数として受け取り対応する列に SQL Serverデータ型表現格納されているデータ値を返します
パブリック メソッド GetSqlValues レコード構成するすべての列について、SQL Serverデータ型表現格納されている値を配列として返します
パブリック メソッド GetSqlXml 序数指定された列の値を SqlXml として取得します
パブリック メソッド GetString 序数指定された列の値を String として取得します
パブリック メソッド GetType  現在のインスタンスType取得します。 ( Object から継承されます。)
パブリック メソッド GetValue 列の序数引数として受け取り対応する列の共通言語ランタイム (CLR) 型の値を返します
パブリック メソッド GetValues レコード構成するすべての列について、共通言語ランタイム (CLR) のデータ型表現格納されている値を配列として返します
パブリック メソッド IsDBNull 列の序数パラメータとして受け取り対応する列が null 参照 (Visual Basic では Nothing) の場合true返します
パブリック メソッド ReferenceEquals  指定した複数Object インスタンス同一かどうか判断します。 ( Object から継承されます。)
パブリック メソッド SetBoolean 列に格納されデータを、指定されBoolean 値に設定します
パブリック メソッド SetByte 列に格納されデータを、指定されByte 値に設定します
パブリック メソッド SetBytes 列に格納されデータを、指定されByte 値の配列設定します
パブリック メソッド SetChar 列に格納されデータを、指定されChar 値に設定します
パブリック メソッド SetChars 列に格納されデータを、指定されChar 値の配列設定します
パブリック メソッド SetDateTime 列に格納されデータを、指定されDateTime 値に設定します
パブリック メソッド SetDecimal 列に格納されデータを、指定されDecimal 値に設定します
パブリック メソッド SetDouble 列に格納されデータを、指定されDouble 値に設定します
パブリック メソッド SetFloat 列に格納されデータを、指定されfloat 値に設定します
パブリック メソッド SetGuid 列に格納されデータを、指定されGuid 値に設定します
パブリック メソッド SetInt16 列に格納されデータを、指定されInt16 値に設定します
パブリック メソッド SetInt32 列に格納されデータを、指定されInt32 値に設定します
パブリック メソッド SetInt64 列に格納されデータを、指定されInt64 値に設定します
パブリック メソッド SetSqlBinary 列に格納されデータを、指定されSqlBinary 値に設定します
パブリック メソッド SetSqlBoolean 列に格納されデータを、指定されSqlBoolean 値に設定します
パブリック メソッド SetSqlByte 列に格納されデータを、指定されSqlByte 値に設定します
パブリック メソッド SetSqlBytes 列に格納されデータを、指定されSqlBytes 値に設定します
パブリック メソッド SetSqlChars 列に格納されデータを、指定されSqlChars 値に設定します
パブリック メソッド SetSqlDateTime 列に格納されデータを、指定されSqlDateTime 値に設定します
パブリック メソッド SetSqlDecimal 列に格納されデータを、指定されSqlDecimal 値に設定します
パブリック メソッド SetSqlDouble 列に格納されデータを、指定されSqlDouble 値に設定します
パブリック メソッド SetSqlGuid 列に格納されデータを、指定されSqlGuid 値に設定します
パブリック メソッド SetSqlInt16 列に格納されデータを、指定されSqlInt16 値に設定します
パブリック メソッド SetSqlInt32 列に格納されデータを、指定されSqlInt32 値に設定します
パブリック メソッド SetSqlInt64 列に格納されデータを、指定されSqlInt64 値に設定します
パブリック メソッド SetSqlMoney 列に格納されデータを、指定されSqlMoney 値に設定します
パブリック メソッド SetSqlSingle 列に格納されデータを、指定されSqlSingle 値に設定します
パブリック メソッド SetSqlString 列に格納されデータを、指定されSqlString 値に設定します
パブリック メソッド SetSqlXml 列に格納されデータを、指定されSqlXml 値に設定します
パブリック メソッド SetString 列に格納されデータを、指定されString 値に設定します
パブリック メソッド SetValue 列の序数引数として受け取り対応する列の新しい値を共通言語ランタイム (CLR) のデータ型表現設定します
パブリック メソッド SetValues SqlDataRecord 内のすべての列に対し新しい値を、共通言語ランタイム (CLR) のデータ型表現設定します
パブリック メソッド ToString  現在の Object を表す String返します。 ( Object から継承されます。)
プロテクト メソッドプロテクト メソッド
明示的インターフェイスの実装明示的インターフェイス実装
  名前 説明
インターフェイスの明示的な実装 System.Data.IDataRecord.GetData このリリースではサポートされません。
参照参照

関連項目

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

SqlDataRecord メンバ

単一行のデータおよびそのメタデータ表します。このクラス継承できません。

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


パブリック コンストラクタパブリック コンストラクタ
  名前 説明
パブリック メソッド SqlDataRecord 引数として渡された SqlMetaData オブジェクト配列に基づくスキーマで、新しい SqlDataRecord インスタンス作成します
パブリック プロパティパブリック プロパティ
パブリック メソッドパブリック メソッド
( プロテクト メソッド参照)
  名前 説明
パブリック メソッド Equals  オーバーロードされます2 つObject インスタンス等しかどうか判断します。 (Object から継承されます。)
パブリック メソッド GetBoolean 序数指定された列の値を Boolean として取得します
パブリック メソッド GetByte 序数指定された列の値を Byte として取得します
パブリック メソッド GetBytes 序数指定された列の値を Byte オブジェクト配列として取得します
パブリック メソッド GetChar 序数指定された列の値を Char として取得します
パブリック メソッド GetChars 序数指定された列の値を Char オブジェクト配列として取得します
パブリック メソッド GetDataTypeName 列の序数引数として受け取り対応する列のデータ型名を返します
パブリック メソッド GetDateTime 序数指定された列の値を DateTime として取得します
パブリック メソッド GetDecimal 序数指定された列の値を Decimal として取得します
パブリック メソッド GetDouble 序数指定された列の値を Double として取得します
パブリック メソッド GetFieldType 列の序数引数として受け取り、その列の SQL Server データ型対応する共通言語ランタイム (CLR) のデータ型を、Type オブジェクトとして返します
パブリック メソッド GetFloat 序数指定された列の値を float として取得します
パブリック メソッド GetGuid 序数指定された列の値を Guid として取得します
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用適してます。 (Object から継承されます。)
パブリック メソッド GetInt16 序数指定された列の値を Int16 として取得します
パブリック メソッド GetInt32 序数指定された列の値を Int32 として取得します
パブリック メソッド GetInt64 序数指定された列の値を Int64 として取得します
パブリック メソッド GetName 列の序数引数として受け取り対応する列の名前を返します
パブリック メソッド GetOrdinal 列名を引数受け取り対応する列の序数返します
パブリック メソッド GetSqlBinary 序数指定された列の値を SqlBinary として取得します
パブリック メソッド GetSqlBoolean 序数指定された列の値を SqlBoolean として取得します
パブリック メソッド GetSqlByte 序数指定された列の値を SqlByte として取得します
パブリック メソッド GetSqlBytes 序数指定された列の値を SqlBytes として取得します
パブリック メソッド GetSqlChars 序数指定された列の値を SqlChars として取得します
パブリック メソッド GetSqlDateTime 序数指定された列の値を SqlDateTime として取得します
パブリック メソッド GetSqlDecimal 序数指定された列の値を SqlDecimal として取得します
パブリック メソッド GetSqlDouble 序数指定された列の値を SqlDouble として取得します
パブリック メソッド GetSqlFieldType SQL Server の列型 (System.Data.SqlTypes で定義されている SQL Serverデータ型) に対応するデータ型を表す Type オブジェクト返します
パブリック メソッド GetSqlGuid 序数指定された列の値を SqlGuid として取得します
パブリック メソッド GetSqlInt16 序数指定された列の値を SqlInt16 として取得します
パブリック メソッド GetSqlInt32 序数指定された列の値を SqlInt32 として取得します
パブリック メソッド GetSqlInt64 序数指定された列の値を SqlInt64 として取得します
パブリック メソッド GetSqlMetaData 列の序数引数として受け取り対応する列のメタデータを表す SqlMetaData オブジェクト返します
パブリック メソッド GetSqlMoney 序数指定された列の値を SqlMoney として取得します
パブリック メソッド GetSqlSingle 序数指定された列の値を SqlSingle として取得します
パブリック メソッド GetSqlString 序数指定された列の値を SqlString として取得します
パブリック メソッド GetSqlValue 列の序数引数として受け取り対応する列に SQL Serverデータ型表現格納されているデータ値を返します
パブリック メソッド GetSqlValues レコード構成するすべての列について、SQL Serverデータ型表現格納されている値を配列として返します
パブリック メソッド GetSqlXml 序数指定された列の値を SqlXml として取得します
パブリック メソッド GetString 序数指定された列の値を String として取得します
パブリック メソッド GetType  現在のインスタンスType取得します。 (Object から継承されます。)
パブリック メソッド GetValue 列の序数引数として受け取り対応する列の共通言語ランタイム (CLR) 型の値を返します
パブリック メソッド GetValues レコード構成するすべての列について、共通言語ランタイム (CLR) のデータ型表現格納されている値を配列として返します
パブリック メソッド IsDBNull 列の序数パラメータとして受け取り対応する列が null 参照 (Visual Basic では Nothing) の場合true返します
パブリック メソッド ReferenceEquals  指定した複数Object インスタンス同一かどうか判断します。 (Object から継承されます。)
パブリック メソッド SetBoolean 列に格納されデータを、指定されBoolean 値に設定します
パブリック メソッド SetByte 列に格納されデータを、指定されByte 値に設定します
パブリック メソッド SetBytes 列に格納されデータを、指定されByte 値の配列設定します
パブリック メソッド SetChar 列に格納されデータを、指定されChar 値に設定します
パブリック メソッド SetChars 列に格納されデータを、指定されChar 値の配列設定します
パブリック メソッド SetDateTime 列に格納されデータを、指定されDateTime 値に設定します
パブリック メソッド SetDecimal 列に格納されデータを、指定されDecimal 値に設定します
パブリック メソッド SetDouble 列に格納されデータを、指定されDouble 値に設定します
パブリック メソッド SetFloat 列に格納されデータを、指定されfloat 値に設定します
パブリック メソッド SetGuid 列に格納されデータを、指定されGuid 値に設定します
パブリック メソッド SetInt16 列に格納されデータを、指定されInt16 値に設定します
パブリック メソッド SetInt32 列に格納されデータを、指定されInt32 値に設定します
パブリック メソッド SetInt64 列に格納されデータを、指定されInt64 値に設定します
パブリック メソッド SetSqlBinary 列に格納されデータを、指定されSqlBinary 値に設定します
パブリック メソッド SetSqlBoolean 列に格納されデータを、指定されSqlBoolean 値に設定します
パブリック メソッド SetSqlByte 列に格納されデータを、指定されSqlByte 値に設定します
パブリック メソッド SetSqlBytes 列に格納されデータを、指定されSqlBytes 値に設定します
パブリック メソッド SetSqlChars 列に格納されデータを、指定されSqlChars 値に設定します
パブリック メソッド SetSqlDateTime 列に格納されデータを、指定されSqlDateTime 値に設定します
パブリック メソッド SetSqlDecimal 列に格納されデータを、指定されSqlDecimal 値に設定します
パブリック メソッド SetSqlDouble 列に格納されデータを、指定されSqlDouble 値に設定します
パブリック メソッド SetSqlGuid 列に格納されデータを、指定されSqlGuid 値に設定します
パブリック メソッド SetSqlInt16 列に格納されデータを、指定されSqlInt16 値に設定します
パブリック メソッド SetSqlInt32 列に格納されデータを、指定されSqlInt32 値に設定します
パブリック メソッド SetSqlInt64 列に格納されデータを、指定されSqlInt64 値に設定します
パブリック メソッド SetSqlMoney 列に格納されデータを、指定されSqlMoney 値に設定します
パブリック メソッド SetSqlSingle 列に格納されデータを、指定されSqlSingle 値に設定します
パブリック メソッド SetSqlString 列に格納されデータを、指定されSqlString 値に設定します
パブリック メソッド SetSqlXml 列に格納されデータを、指定されSqlXml 値に設定します
パブリック メソッド SetString 列に格納されデータを、指定されString 値に設定します
パブリック メソッド SetValue 列の序数引数として受け取り対応する列の新しい値を共通言語ランタイム (CLR) のデータ型表現設定します
パブリック メソッド SetValues SqlDataRecord 内のすべての列に対し新しい値を、共通言語ランタイム (CLR) のデータ型表現設定します
パブリック メソッド ToString  現在の Object を表す String返します。 (Object から継承されます。)
プロテクト メソッドプロテクト メソッド
明示的インターフェイスの実装明示的インターフェイス実装
  名前 説明
インターフェイスの明示的な実装 System.Data.IDataRecord.GetData このリリースではサポートされません。
参照参照

関連項目

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



英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

すべての辞書の索引

「SqlDataRecord」の関連用語

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

   

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



SqlDataRecordのページの著作権
Weblio 辞書 情報提供元は 参加元一覧 にて確認できます。

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

©2025 GRAS Group, Inc.RSS