SqlDataRecord Clase

Definición

Representa una única fila de datos y sus metadatos.Represents a single row of data and its metadata. Esta clase no puede heredarse.This class cannot be inherited.

public ref class SqlDataRecord : System::Data::IDataRecord
public class SqlDataRecord : System.Data.IDataRecord
type SqlDataRecord = class
    interface IDataRecord
Public Class SqlDataRecord
Implements IDataRecord
Herencia
SqlDataRecord
Implementaciones

Ejemplos

En el ejemplo siguiente se muestra cómo crear varios objetos SqlMetaData, que describen los metadatos de columna de un registro y la creación de un SqlDataRecord.The following example shows how to create several SqlMetaData objects, which describe the column metadata of a record, and creating a SqlDataRecord. Los valores de columna del SqlDataRecord se establecen y el SqlDataRecord se envía al programa que realiza la llamada mediante la clase SqlContext.The column values of the SqlDataRecord are set and the SqlDataRecord is sent to the calling program by using the SqlContext class.

[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 los procedimientos almacenados de código administrado.This class is used together with SqlPipe to send result sets to the client from managed code stored-procedures.

Al escribir aplicaciones Common Language Runtime (CLR), debe volver a usar los objetos SqlDataRecord existentes en lugar de crear los nuevos cada vez.When writing common language runtime (CLR) applications, you should re-use existing SqlDataRecord objects instead of creating new ones every time. La creación de muchos objetos SqlDataRecord nuevos podría reducir gravemente la memoria y afectar negativamente al rendimiento.Creating many new SqlDataRecord objects could severely deplete memory and adversely affect performance.

Constructores

SqlDataRecord(SqlMetaData[])

Inicializa una nueva instancia de SqlDataRecord con el esquema basado en la matriz de objetos SqlMetaData que se pasan como argumento.Inititializes a new SqlDataRecord instance with the schema based on the array of SqlMetaData objects passed as an argument.

Propiedades

FieldCount

Obtiene el número de columnas de la fila de datos actual.Gets the number of columns in the data row. Esta propiedad es de sólo lectura.This property is read-only.

Item[Int32]

Obtiene el valor del tipo de Common Language Runtime (CLR) para la columna especificado por el argumento ordinal de la columna.Gets the common language runtime (CLR) type value for the column specified by the column ordinal argument.

Item[String]

Obtiene el valor del tipo de Common Language Runtime (CLR) para la columna especificado por el argumento name de la columna.Gets the common language runtime (CLR) type value for the column specified by the column name argument.

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetBoolean(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento Boolean.Gets the value for the column specified by the ordinal as a Boolean.

GetByte(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento Byte.Gets the value for the column specified by the ordinal as a Byte.

GetBytes(Int32, Int64, Byte[], Int32, Int32)

Obtiene el valor de la columna especificada por el ordinal como una matriz de objetos Byte.Gets the value for the column specified by the ordinal as an array of Byte objects.

GetChar(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento Char.Gets the value for the column specified by the ordinal as a Char.

GetChars(Int32, Int64, Char[], Int32, Int32)

Obtiene el valor de la columna especificada por el ordinal como una matriz de objetos Char.Gets the value for the column specified by the ordinal as an array of Char objects.

GetData(Int32)
GetDataTypeName(Int32)

Devuelve el nombre del tipo de datos para la columna especificada por el argumento ordinal.Returns the name of the data type for the column specified by the ordinal argument.

GetDateTime(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento DateTime.Gets the value for the column specified by the ordinal as a DateTime.

GetDateTimeOffset(Int32)

Devuelve los datos de la columna especificada como DateTimeOffset.Returns the specified column's data as a DateTimeOffset.

GetDecimal(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento Decimal.Gets the value for the column specified by the ordinal as a Decimal.

GetDouble(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento Double.Gets the value for the column specified by the ordinal as a 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.Returns a Type object representing the common language runtime (CLR) type that maps to the SQL Server type of the column specified by the ordinal argument.

GetFloat(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento float.Gets the value for the column specified by the ordinal as a float.

GetGuid(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento Guid.Gets the value for the column specified by the ordinal as a Guid.

GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetInt16(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento Int16.Gets the value for the column specified by the ordinal as a Int16.

GetInt32(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento Int32.Gets the value for the column specified by the ordinal as a Int32.

GetInt64(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento Int64.Gets the value for the column specified by the ordinal as a Int64.

GetName(Int32)

Devuelve el nombre de la columna especificada por el argumento ordinal.Returns the name of the column specified by the ordinal argument.

GetOrdinal(String)

Devuelve el índice de columna especificado por el nombre de columna.Returns the column ordinal specified by the column name.

GetSqlBinary(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento SqlBinary.Gets the value for the column specified by the ordinal as a SqlBinary.

GetSqlBoolean(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento SqlBoolean.Gets the value for the column specified by the ordinal as a SqlBoolean.

GetSqlByte(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento SqlByte.Gets the value for the column specified by the ordinal as a SqlByte.

GetSqlBytes(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento SqlBytes.Gets the value for the column specified by the ordinal as a SqlBytes.

GetSqlChars(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento SqlChars.Gets the value for the column specified by the ordinal as a SqlChars.

GetSqlDateTime(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento SqlDateTime.Gets the value for the column specified by the ordinal as a SqlDateTime.

GetSqlDecimal(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento SqlDecimal.Gets the value for the column specified by the ordinal as a SqlDecimal.

GetSqlDouble(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento SqlDouble.Gets the value for the column specified by the ordinal as a 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.Returns a Type object that represents the type (as a SQL Server type, defined in System.Data.SqlTypes) that maps to the SQL Server type of the column.

GetSqlGuid(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento SqlGuid.Gets the value for the column specified by the ordinal as a SqlGuid.

GetSqlInt16(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento SqlInt16.Gets the value for the column specified by the ordinal as a SqlInt16.

GetSqlInt32(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento SqlInt32.Gets the value for the column specified by the ordinal as a SqlInt32.

GetSqlInt64(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento SqlInt64.Gets the value for the column specified by the ordinal as a SqlInt64.

GetSqlMetaData(Int32)

Devuelve un objeto SqlMetaData que describe los metadatos de la columna especificada por el ordinal de columna.Returns a SqlMetaData object, describing the metadata of the column specified by the column ordinal.

GetSqlMoney(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento SqlMoney.Gets the value for the column specified by the ordinal as a SqlMoney.

GetSqlSingle(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento SqlSingle.Gets the value for the column specified by the ordinal as a SqlSingle.

GetSqlString(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento SqlString.Gets the value for the column specified by the ordinal as a SqlString.

GetSqlValue(Int32)

Devuelve el valor de datos almacenado en la columna, expresado como tipo de SQL Server, especificado por el ordinal de columna.Returns the data value stored in the column, expressed as a SQL Server type, specified by the column ordinal.

GetSqlValues(Object[])

Devuelve los valores para todas las columnas del registro, expresados como tipos de SQL Server en una matriz.Returns the values for all the columns in the record, expressed as SQL Server types, in an array.

GetSqlXml(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento SqlXml.Gets the value for the column specified by the ordinal as a SqlXml.

GetString(Int32)

Obtiene el valor de la columna que el ordinal especifica como un elemento String.Gets the value for the column specified by the ordinal as a String.

GetTimeSpan(Int32)

Devuelve los datos de la columna especificada como TimeSpan.Returns the specified column's data as a TimeSpan.

GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
GetValue(Int32)

Devuelve el valor del tipo de Common Language Runtime (CLR) para la columna que especifica el argumento ordinal.Returns the common language runtime (CLR) type value for the column specified by the ordinal argument.

GetValues(Object[])

Devuelve los valores para todas las columnas del registro, expresados como tipos de Common Language Runtime (CLR) en una matriz.Returns the values for all the columns in the record, expressed as common language runtime (CLR) types, in an array.

IsDBNull(Int32)

Devuelve true si la columna especificada por el parámetro ordinal de la columna es null.Returns true if the column specified by the column ordinal parameter is null.

MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
SetBoolean(Int32, Boolean)

Establece los datos almacenados en la columna en el valor Boolean especificado.Sets the data stored in the column to the specified Boolean value.

SetByte(Int32, Byte)

Establece los datos almacenados en la columna en el valor Byte especificado.Sets the data stored in the column to the specified Byte value.

SetBytes(Int32, Int64, Byte[], Int32, Int32)

Establece los datos almacenados en la columna en la matriz de valores Byte especificada.Sets the data stored in the column to the specified array of Byte values.

SetChar(Int32, Char)

Establece los datos almacenados en la columna en el valor Char especificado.Sets the data stored in the column to the specified Char value.

SetChars(Int32, Int64, Char[], Int32, Int32)

Establece los datos almacenados en la columna en la matriz de valores Char especificada.Sets the data stored in the column to the specified array of Char values.

SetDateTime(Int32, DateTime)

Establece los datos almacenados en la columna en el valor DateTime especificado.Sets the data stored in the column to the specified DateTime value.

SetDateTimeOffset(Int32, DateTimeOffset)

Establece el valor de la columna especificada en el valor de DateTimeOffset.Sets the value of the column specified to the DateTimeOffset value.

SetDBNull(Int32)

Establece el valor de la columna especificada en DBNull.Sets the value in the specified column to DBNull.

SetDecimal(Int32, Decimal)

Establece los datos almacenados en la columna en el valor Decimal especificado.Sets the data stored in the column to the specified Decimal value.

SetDouble(Int32, Double)

Establece los datos almacenados en la columna en el valor Double especificado.Sets the data stored in the column to the specified Double value.

SetFloat(Int32, Single)

Establece los datos almacenados en la columna en el valor float especificado.Sets the data stored in the column to the specified float value.

SetGuid(Int32, Guid)

Establece los datos almacenados en la columna en el valor Guid especificado.Sets the data stored in the column to the specified Guid value.

SetInt16(Int32, Int16)

Establece los datos almacenados en la columna en el valor Int16 especificado.Sets the data stored in the column to the specified Int16 value.

SetInt32(Int32, Int32)

Establece los datos almacenados en la columna en el valor Int32 especificado.Sets the data stored in the column to the specified Int32 value.

SetInt64(Int32, Int64)

Establece los datos almacenados en la columna en el valor Int64 especificado.Sets the data stored in the column to the specified Int64 value.

SetSqlBinary(Int32, SqlBinary)

Establece los datos almacenados en la columna en el valor SqlBinary especificado.Sets the data stored in the column to the specified SqlBinary value.

SetSqlBoolean(Int32, SqlBoolean)

Establece los datos almacenados en la columna en el valor SqlBoolean especificado.Sets the data stored in the column to the specified SqlBoolean value.

SetSqlByte(Int32, SqlByte)

Establece los datos almacenados en la columna en el valor SqlByte especificado.Sets the data stored in the column to the specified SqlByte value.

SetSqlBytes(Int32, SqlBytes)

Establece los datos almacenados en la columna en el valor SqlBytes especificado.Sets the data stored in the column to the specified SqlBytes value.

SetSqlChars(Int32, SqlChars)

Establece los datos almacenados en la columna en el valor SqlChars especificado.Sets the data stored in the column to the specified SqlChars value.

SetSqlDateTime(Int32, SqlDateTime)

Establece los datos almacenados en la columna en el valor SqlDateTime especificado.Sets the data stored in the column to the specified SqlDateTime value.

SetSqlDecimal(Int32, SqlDecimal)

Establece los datos almacenados en la columna en el valor SqlDecimal especificado.Sets the data stored in the column to the specified SqlDecimal value.

SetSqlDouble(Int32, SqlDouble)

Establece los datos almacenados en la columna en el valor SqlDouble especificado.Sets the data stored in the column to the specified SqlDouble value.

SetSqlGuid(Int32, SqlGuid)

Establece los datos almacenados en la columna en el valor SqlGuid especificado.Sets the data stored in the column to the specified SqlGuid value.

SetSqlInt16(Int32, SqlInt16)

Establece los datos almacenados en la columna en el valor SqlInt16 especificado.Sets the data stored in the column to the specified SqlInt16 value.

SetSqlInt32(Int32, SqlInt32)

Establece los datos almacenados en la columna en el valor SqlInt32 especificado.Sets the data stored in the column to the specified SqlInt32 value.

SetSqlInt64(Int32, SqlInt64)

Establece los datos almacenados en la columna en el valor SqlInt64 especificado.Sets the data stored in the column to the specified SqlInt64 value.

SetSqlMoney(Int32, SqlMoney)

Establece los datos almacenados en la columna en el valor SqlMoney especificado.Sets the data stored in the column to the specified SqlMoney value.

SetSqlSingle(Int32, SqlSingle)

Establece los datos almacenados en la columna en el valor SqlSingle especificado.Sets the data stored in the column to the specified SqlSingle value.

SetSqlString(Int32, SqlString)

Establece los datos almacenados en la columna en el valor SqlString especificado.Sets the data stored in the column to the specified SqlString value.

SetSqlXml(Int32, SqlXml)

Establece los datos almacenados en la columna en el valor SqlXml especificado.Sets the data stored in the column to the specified SqlXml value.

SetString(Int32, String)

Establece los datos almacenados en la columna en el valor String especificado.Sets the data stored in the column to the specified String value.

SetTimeSpan(Int32, TimeSpan)

Establece el valor de la columna especificada en TimeSpan.Sets the value of the column specified to the 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.Sets a new value, expressed as a common language runtime (CLR) type, for the column specified by the column ordinal.

SetValues(Object[])

Establece nuevos valores para todas las columnas de SqlDataRecord.Sets new values for all of the columns in the SqlDataRecord. Estos valores se expresan como tipos de Common Language Runtime (CLR)These values are expressed as common language runtime (CLR) types.

ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Implementaciones de interfaz explícitas

IDataRecord.GetData(Int32)

No se admite en esta versión.Not supported in this release.

Se aplica a