SqlDataRecord 類別

定義

public ref class SqlDataRecord : System::Data::IDataRecord

public class SqlDataRecord : System.Data.IDataRecord

type SqlDataRecord = class
    interface IDataRecord

Public Class SqlDataRecord
Implements IDataRecord

繼承

Object

SqlDataRecord

實作

IDataRecord

範例

下列範例示範如何建立數 SqlMetaData 個物件，其中描述記錄的資料行中繼資料，以及建立 SqlDataRecord 。 的資料行值 SqlDataRecord 會設定，並使用 SqlDataRecord 類別傳送至呼叫程式 SqlContext 。

[Microsoft.SqlServer.Server.SqlProcedure]
public static void CreateNewRecord()
{

   // 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[] { new SqlMetaData("Column1", SqlDbType.NVarChar, 12),
                                                  new SqlMetaData("Column2", SqlDbType.Int),
                                                  new SqlMetaData("Column3", SqlDbType.DateTime) });

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

<Microsoft.SqlServer.Server.SqlProcedure()> _
Public Shared Sub CreateNewRecord()

   ' 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() {New SqlMetaData("Column1", SqlDbType.NVarChar, 12), _
                                                 New SqlMetaData("Column2", SqlDbType.Int), _
                                                 New SqlMetaData("Column3", SqlDbType.DateTime)})

   ' 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

備註

這個類別會與 搭配 SqlPipe 使用，從 Managed 程式碼預存程式將結果集傳送至用戶端。

撰寫 Common Language Runtime (CLR) 應用程式時，您應該重複使用現有的 SqlDataRecord 物件，而不是每次建立新的物件。 建立許多新 SqlDataRecord 物件可能會嚴重耗盡記憶體，並對效能造成負面影響。

建構函式

屬性

方法

明確介面實作

適用於