SqlDataRecord Clase

Definición

Espacio de nombres:

Microsoft.SqlServer.Server

Ensamblado:

System.Data.dll

Representa una única fila de datos y sus metadatos. Esta clase no puede heredarse.

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

public class SqlDataRecord : System.Data.IDataRecord

type SqlDataRecord = class
    interface IDataRecord

Public Class SqlDataRecord
Implements IDataRecord

Herencia

Object

SqlDataRecord

Implementaciones

IDataRecord

Ejemplos

En el ejemplo siguiente se muestra cómo crear varios SqlMetaData objetos, que describen los metadatos de columna de un registro y la creación de un SqlDataRecord. Los valores de columna de SqlDataRecord se establecen y SqlDataRecord se envían al programa de llamada mediante la SqlContext clase .

[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

Comentarios

Esta clase se usa junto con SqlPipe para enviar conjuntos de resultados al cliente desde procedimientos almacenados de código administrado.

Al escribir aplicaciones de Common Language Runtime (CLR), debe volver a usar objetos existentes SqlDataRecord en lugar de crear objetos nuevos cada vez. La creación de muchos objetos nuevos SqlDataRecord podría agotar gravemente la memoria y afectar negativamente al rendimiento.

Constructores

SqlDataRecord(SqlMetaData[])

Inicializa una nueva instancia de SqlDataRecord con el esquema basado en la matriz de objetos SqlMetaData que se pasan como argumento.

Propiedades

FieldCount	Obtiene el número de columnas de la fila de datos actual. Esta propiedad es de sólo lectura.
Item[Int32]	Obtiene el valor del tipo de Common Language Runtime (CLR) para la columna especificado por el argumento ordinal de la columna.
Item[String]	Obtiene el valor del tipo de Common Language Runtime (CLR) para la columna especificado por el argumento name de la columna.

Métodos

GetBoolean(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento Boolean.
GetByte(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento Byte.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Obtiene el valor de la columna especificada por el ordinal como una matriz de objetos Byte.
GetChar(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento Char.
GetChars(Int32, Int64, Char[], Int32, Int32)	Obtiene el valor de la columna especificada por el ordinal como una matriz de objetos Char.
GetDataTypeName(Int32)	Devuelve el nombre del tipo de datos para la columna especificada por el argumento ordinal.
GetDateTime(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento DateTime.
GetDateTimeOffset(Int32)	Devuelve los datos de la columna especificada como DateTimeOffset.
GetDecimal(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento Decimal.
GetDouble(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento Double.
GetFieldType(Int32)	Devuelve un objeto Type que representa el tipo de Common Language Runtime (CLR) que se asigna al tipo de SQL Server de la columna especificada por el argumento ordinal.
GetFloat(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento float.
GetGuid(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento Guid.
GetInt16(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento Int16.
GetInt32(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento Int32.
GetInt64(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento Int64.
GetName(Int32)	Devuelve el nombre de la columna especificada por el argumento ordinal.
GetOrdinal(String)	Devuelve el índice de columna especificado por el nombre de columna.
GetSqlBinary(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento SqlBinary.
GetSqlBoolean(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento SqlBoolean.
GetSqlByte(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento SqlByte.
GetSqlBytes(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento SqlBytes.
GetSqlChars(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento SqlChars.
GetSqlDateTime(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento SqlDateTime.
GetSqlDecimal(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento SqlDecimal.
GetSqlDouble(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento SqlDouble.
GetSqlFieldType(Int32)	Devuelve un objeto Type que representa el tipo (como un tipo de SQL Server, definido en System.Data.SqlTypes) que se asigna al tipo de SQL Server de la columna.
GetSqlGuid(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento SqlGuid.
GetSqlInt16(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento SqlInt16.
GetSqlInt32(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento SqlInt32.
GetSqlInt64(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento SqlInt64.
GetSqlMetaData(Int32)	Devuelve un objeto SqlMetaData que describe los metadatos de la columna especificada por el ordinal de columna.
GetSqlMoney(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento SqlMoney.
GetSqlSingle(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento SqlSingle.
GetSqlString(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento SqlString.
GetSqlValue(Int32)	Devuelve el valor de datos almacenado en la columna, expresado como tipo de SQL Server, especificado por el ordinal de columna.
GetSqlValues(Object[])	Devuelve los valores para todas las columnas del registro, expresados como tipos de SQL Server en una matriz.
GetSqlXml(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento SqlXml.
GetString(Int32)	Obtiene el valor de la columna que el ordinal especifica como un elemento String.
GetTimeSpan(Int32)	Devuelve los datos de la columna especificada como TimeSpan.
GetValue(Int32)	Devuelve el valor del tipo de Common Language Runtime (CLR) para la columna que especifica el argumento ordinal.
GetValues(Object[])	Devuelve los valores para todas las columnas del registro, expresados como tipos de Common Language Runtime (CLR) en una matriz.
IsDBNull(Int32)	Devuelve true si la columna especificada por el parámetro ordinal de la columna es null.
SetBoolean(Int32, Boolean)	Establece los datos almacenados en la columna en el valor Boolean especificado.
SetByte(Int32, Byte)	Establece los datos almacenados en la columna en el valor Byte especificado.
SetBytes(Int32, Int64, Byte[], Int32, Int32)	Establece los datos almacenados en la columna en la matriz de valores Byte especificada.
SetChar(Int32, Char)	Establece los datos almacenados en la columna en el valor Char especificado.
SetChars(Int32, Int64, Char[], Int32, Int32)	Establece los datos almacenados en la columna en la matriz de valores Char especificada.
SetDateTime(Int32, DateTime)	Establece los datos almacenados en la columna en el valor DateTime especificado.
SetDateTimeOffset(Int32, DateTimeOffset)	Establece el valor de la columna especificada en el valor de DateTimeOffset.
SetDBNull(Int32)	Establece el valor de la columna especificada en DBNull.
SetDecimal(Int32, Decimal)	Establece los datos almacenados en la columna en el valor Decimal especificado.
SetDouble(Int32, Double)	Establece los datos almacenados en la columna en el valor Double especificado.
SetFloat(Int32, Single)	Establece los datos almacenados en la columna en el valor float especificado.
SetGuid(Int32, Guid)	Establece los datos almacenados en la columna en el valor Guid especificado.
SetInt16(Int32, Int16)	Establece los datos almacenados en la columna en el valor Int16 especificado.
SetInt32(Int32, Int32)	Establece los datos almacenados en la columna en el valor Int32 especificado.
SetInt64(Int32, Int64)	Establece los datos almacenados en la columna en el valor Int64 especificado.
SetSqlBinary(Int32, SqlBinary)	Establece los datos almacenados en la columna en el valor SqlBinary especificado.
SetSqlBoolean(Int32, SqlBoolean)	Establece los datos almacenados en la columna en el valor SqlBoolean especificado.
SetSqlByte(Int32, SqlByte)	Establece los datos almacenados en la columna en el valor SqlByte especificado.
SetSqlBytes(Int32, SqlBytes)	Establece los datos almacenados en la columna en el valor SqlBytes especificado.
SetSqlChars(Int32, SqlChars)	Establece los datos almacenados en la columna en el valor SqlChars especificado.
SetSqlDateTime(Int32, SqlDateTime)	Establece los datos almacenados en la columna en el valor SqlDateTime especificado.
SetSqlDecimal(Int32, SqlDecimal)	Establece los datos almacenados en la columna en el valor SqlDecimal especificado.
SetSqlDouble(Int32, SqlDouble)	Establece los datos almacenados en la columna en el valor SqlDouble especificado.
SetSqlGuid(Int32, SqlGuid)	Establece los datos almacenados en la columna en el valor SqlGuid especificado.
SetSqlInt16(Int32, SqlInt16)	Establece los datos almacenados en la columna en el valor SqlInt16 especificado.
SetSqlInt32(Int32, SqlInt32)	Establece los datos almacenados en la columna en el valor SqlInt32 especificado.
SetSqlInt64(Int32, SqlInt64)	Establece los datos almacenados en la columna en el valor SqlInt64 especificado.
SetSqlMoney(Int32, SqlMoney)	Establece los datos almacenados en la columna en el valor SqlMoney especificado.
SetSqlSingle(Int32, SqlSingle)	Establece los datos almacenados en la columna en el valor SqlSingle especificado.
SetSqlString(Int32, SqlString)	Establece los datos almacenados en la columna en el valor SqlString especificado.
SetSqlXml(Int32, SqlXml)	Establece los datos almacenados en la columna en el valor SqlXml especificado.
SetString(Int32, String)	Establece los datos almacenados en la columna en el valor String especificado.
SetTimeSpan(Int32, TimeSpan)	Establece el valor de la columna especificada en TimeSpan.
SetValue(Int32, Object)	Establece un nuevo valor, expresado como el tipo de Common Language Runtime (CLR), para la columna especificada por el ordinal de columna.
SetValues(Object[])	Establece nuevos valores para todas las columnas de SqlDataRecord. Estos valores se expresan como tipos de Common Language Runtime (CLR)

Implementaciones de interfaz explícitas

IDataRecord.GetData(Int32)

No se admite en esta versión.