SqlDataRecord クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

SqlDataRecord クラス

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

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

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

Visual Basic (宣言)

Public NotInheritable Class
 SqlDataRecord
    Implements IDataRecord

Visual Basic (使用法)

Dim instance As SqlDataRecord

public sealed class SqlDataRecord : IDataRecord

C++

public ref class SqlDataRecord sealed : IDataRecord

public final class SqlDataRecord implements
 IDataRecord

JScript

public final class SqlDataRecord implements
 IDataRecord

解説

このクラスは、マネージコードのストアドプロシージャからクライアントに結果セットを送信するために、SqlPipe と組み合わせて使用します。

共通言語ランタイム (CLR: Common Language Runtime) アプリケーションを記述する場合は、新しい SqlDataRecord オブジェクトを毎回作成する代わりに、既存のオブジェクトを再利用するようにします。新しい SqlDataRecord オブジェクトを多数作成すると、大量のメモリ消費とパフォーマンスの悪化につながる可能性があります。

使用例

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

Visual Basic

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