Artigo
09/28/2010

Objeto SqlDataRecord

O objeto SqlDataRecord representa uma única linha de dados, junto com seus metadados relacionados.

Os procedimentos armazenados gerenciados podem enviar conjuntos de resultados ao cliente que não sejam de um SqlDataReader. A classe SqlDataRecord, junto com os métodos SendResultsStart, SendResultsRow e SendResultsEnd do objeto SqlPipe permite que os procedimentos armazenados enviem conjuntos de resultados personalizados ao cliente.

Para obter mais informações, consulte a documentação sobre referência de classe do Microsoft.SqlServer.Server.SqlDataRecord no .NET Framework SDK.

Exemplo

O exemplo a seguir cria um novo registro de funcionário e o retorna ao chamador.

[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

Consulte também

Tarefas

Exemplos do Mecanismo de Banco de Dados do SQL Server

Conceitos

Objeto SqlPipe

Histórico de alterações

Conteúdo atualizado
Link atualizado para exemplo.

Compartilhar via