Artikel
09/24/2010

SqlDataRecord-Objekt

Das SqlDataRecord-Objekt stellt eine einzelne Datenzeile mit zugehörigen Metadaten dar.

Verwaltete gespeicherte Prozeduren können Resultsets an den Client senden, die nicht von SqlDataReader stammen. Die SqlDataRecord-Klasse ermöglicht zusammen mit den Methoden SendResultsStart, SendResultsRow und SendResultsEnd des SqlPipe-Objekts gespeicherten Prozeduren, benutzerdefinierte Resultsets an den Client zu senden.

Weitere Informationen finden Sie in der Referenz zu der Microsoft.SqlServer.Server.SqlDataRecord-Klasse und in der .NET Framework SDK-Dokumentation.

Beispiel

Das folgende Beispiel erstellt einen neuen Mitarbeiterdatensatz und gibt ihn an den Aufrufer zurück.

[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

Siehe auch

Aufgaben

Beispiele für SQL Server Database Engine

Konzepte

SqlPipe-Objekt

Änderungsverlauf

Aktualisierter Inhalt
Aktualisierter Link zum Beispiel.

Freigeben über