SqlDataRecord オブジェクト

SqlDataRecord オブジェクトは、1 行のデータと、そのデータに関連するメタデータを表します。

マネージ ストアド プロシージャは、SqlDataReader からのものではない結果セットをクライアントに送信することがあります。SqlDataRecord クラスを、SqlPipe オブジェクトの SendResultsStart メソッド、SendResultsRow メソッド、および SendResultsEnd メソッドと併用すると、ストアド プロシージャからクライアントにカスタム結果セットを送信できます。

詳細については、Microsoft .NET Framework SDK ドキュメントの Microsoft.SqlServer.Server.SqlDataRecord クラスのリファレンス ドキュメントを参照してください。

例

次の例では、新しい従業員レコードを作成し、これを呼び出し元に返します。

C#

[Microsoft.SqlServer.Server.SqlProcedure]
public static void CreateNewRecordProc()
{
    // Variables.       
    SqlDataRecord record;

    // Create a new record with the column metadata.  The constructor 
    // is able to accept a variable number of parameters.
    record = new SqlDataRecord(new SqlMetaData("EmployeeID", SqlDbType.Int),
                               new SqlMetaData("Surname", SqlDbType.NVarChar, 20),
                               new SqlMetaData("GivenName", SqlDbType.NVarChar, 20),
                               new SqlMetaData("StartDate", SqlDbType.DateTime) );

    // Set the record fields.
    record.SetInt32(0, 0042);
    record.SetString(1, "Funk");
    record.SetString(2, "Don");
    record.SetDateTime(3, new DateTime(2005, 7, 17));

    // Send the record to the calling program.
    SqlContext.Pipe.Send(record);

}

Visual Basic

<Microsoft.SqlServer.Server.SqlProcedure()> _
Public Shared Sub  CreateNewRecordVBProc ()
    ' Variables.
    Dim record As SqlDataRecord

    ' Create a new record with the column metadata. The constructor is 
    ' able to accept a variable number of parameters

    record = New SqlDataRecord(New SqlMetaData("EmployeeID", SqlDbType.Int), _
                           New SqlMetaData("Surname", SqlDbType.NVarChar, 20), _
                           New SqlMetaData("GivenName", SqlDbType.NVarChar, 20), _
                           New SqlMetaData("StartDate", SqlDbType.DateTime))

    ' Set the record fields.
    record.SetInt32(0, 42)
    record.SetString(1, "Funk")
    record.SetString(2, "Don")
    record.SetDateTime(3, New DateTime(2005, 7, 17))

    ' Send the record to the calling program.
    SqlContext.Pipe.Send(record)

End Sub

関連項目

タスク

SQL Server データベース エンジン サンプル

概念

SqlPipe オブジェクト