Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase SqlDataRecord

 

Publicado: octubre de 2016

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

Espacio de nombres:   Microsoft.SqlServer.Server
Ensamblado:  System.Data (en System.Data.dll)

System.Object
  Microsoft.SqlServer.Server.SqlDataRecord

public class SqlDataRecord : IDataRecord

NombreDescripción
System_CAPS_pubmethodSqlDataRecord(SqlMetaData[])

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

NombreDescripción
System_CAPS_pubpropertyFieldCount

Obtiene el número de columnas de la fila de datos actual. Esta propiedad es de sólo lectura.

System_CAPS_pubpropertyItem[Int32]

Obtiene el valor del tipo de Common Language Runtime (CLR) para la columna especificado por el argumento ordinal de la columna.

System_CAPS_pubpropertyItem[String]

Obtiene el valor del tipo de Common Language Runtime (CLR) para la columna especificado por el argumento name de la columna.

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodGetBoolean(Int32)

Obtiene el valor de la columna especificada por el ordinal como Boolean.

System_CAPS_pubmethodGetByte(Int32)

Obtiene el valor de la columna especificada por el ordinal como Byte.

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

Obtiene el valor de la columna especificada por el ordinal como una matriz de objetos Byte.

System_CAPS_pubmethodGetChar(Int32)

Obtiene el valor de la columna especificada por el ordinal como Char.

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

Obtiene el valor de la columna especificada por el ordinal como una matriz de objetos Char.

System_CAPS_pubmethodGetDataTypeName(Int32)

Devuelve el nombre del tipo de datos para la columna especificada por el argumento ordinal.

System_CAPS_pubmethodGetDateTime(Int32)

Obtiene el valor de la columna especificada por el ordinal como DateTime.

System_CAPS_pubmethodGetDateTimeOffset(Int32)

Devuelve los datos de la columna especificada como DateTimeOffset.

System_CAPS_pubmethodGetDecimal(Int32)

Obtiene el valor de la columna especificada por el ordinal como Decimal.

System_CAPS_pubmethodGetDouble(Int32)

Obtiene el valor de la columna especificada por el ordinal como Double.

System_CAPS_pubmethodGetFieldType(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.

System_CAPS_pubmethodGetFloat(Int32)

Obtiene el valor de la columna especificada por el ordinal como float.

System_CAPS_pubmethodGetGuid(Int32)

Obtiene el valor de la columna especificada por el ordinal como Guid.

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetInt16(Int32)

Obtiene el valor de la columna especificada por el ordinal como Int16.

System_CAPS_pubmethodGetInt32(Int32)

Obtiene el valor de la columna especificada por el ordinal como Int32.

System_CAPS_pubmethodGetInt64(Int32)

Obtiene el valor de la columna especificada por el ordinal como Int64.

System_CAPS_pubmethodGetName(Int32)

Devuelve el nombre de la columna especificada por el argumento ordinal.

System_CAPS_pubmethodGetOrdinal(String)

Devuelve el índice de columna especificado por el nombre de columna.

System_CAPS_pubmethodGetSqlBinary(Int32)

Obtiene el valor de la columna especificada por el ordinal como SqlBinary.

System_CAPS_pubmethodGetSqlBoolean(Int32)

Obtiene el valor de la columna especificada por el ordinal como SqlBoolean.

System_CAPS_pubmethodGetSqlByte(Int32)

Obtiene el valor de la columna especificada por el ordinal como SqlByte.

System_CAPS_pubmethodGetSqlBytes(Int32)

Obtiene el valor de la columna especificada por el ordinal como SqlBytes.

System_CAPS_pubmethodGetSqlChars(Int32)

Obtiene el valor de la columna especificada por el ordinal como SqlChars.

System_CAPS_pubmethodGetSqlDateTime(Int32)

Obtiene el valor de la columna especificada por el ordinal como SqlDateTime.

System_CAPS_pubmethodGetSqlDecimal(Int32)

Obtiene el valor de la columna especificada por el ordinal como SqlDecimal.

System_CAPS_pubmethodGetSqlDouble(Int32)

Obtiene el valor de la columna especificada por el ordinal como SqlDouble.

System_CAPS_pubmethodGetSqlFieldType(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.

System_CAPS_pubmethodGetSqlGuid(Int32)

Obtiene el valor de la columna especificada por el ordinal como SqlGuid.

System_CAPS_pubmethodGetSqlInt16(Int32)

Obtiene el valor de la columna especificada por el ordinal como SqlInt16.

System_CAPS_pubmethodGetSqlInt32(Int32)

Obtiene el valor de la columna especificada por el ordinal como SqlInt32.

System_CAPS_pubmethodGetSqlInt64(Int32)

Obtiene el valor de la columna especificada por el ordinal como SqlInt64.

System_CAPS_pubmethodGetSqlMetaData(Int32)

Devuelve un objeto SqlMetaData que describe los metadatos de la columna especificada por el ordinal de columna.

System_CAPS_pubmethodGetSqlMoney(Int32)

Obtiene el valor de la columna especificada por el ordinal como SqlMoney.

System_CAPS_pubmethodGetSqlSingle(Int32)

Obtiene el valor de la columna especificada por el ordinal como SqlSingle.

System_CAPS_pubmethodGetSqlString(Int32)

Obtiene el valor de la columna especificada por el ordinal como SqlString.

System_CAPS_pubmethodGetSqlValue(Int32)

Devuelve el valor de datos almacenado en la columna, expresado como tipo de SQL Server, especificado por el ordinal de columna.

System_CAPS_pubmethodGetSqlValues(Object[])

Devuelve los valores para todas las columnas del registro, expresados como tipos de SQL Server en una matriz.

System_CAPS_pubmethodGetSqlXml(Int32)

Obtiene el valor de la columna especificada por el ordinal como SqlXml.

System_CAPS_pubmethodGetString(Int32)

Obtiene el valor de la columna especificada por el ordinal como String.

System_CAPS_pubmethodGetTimeSpan(Int32)

Devuelve los datos de la columna especificada como TimeSpan.

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodGetValue(Int32)

Devuelve el valor del tipo de Common Language Runtime (CLR) para la columna que especifica el argumento ordinal.

System_CAPS_pubmethodGetValues(Object[])

Devuelve los valores para todas las columnas del registro, expresados como tipos de Common Language Runtime (CLR) en una matriz.

System_CAPS_pubmethodIsDBNull(Int32)

Devuelve true si la columna especificada por el parámetro ordinal de la columna es null.

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodSetBoolean(Int32, Boolean)

Establece los datos almacenados en la columna en el valor Boolean especificado.

System_CAPS_pubmethodSetByte(Int32, Byte)

Establece los datos almacenados en la columna en el valor Byte especificado.

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

Establece los datos almacenados en la columna en la matriz de valores Byte especificada.

System_CAPS_pubmethodSetChar(Int32, Char)

Establece los datos almacenados en la columna en el valor Char especificado.

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

Establece los datos almacenados en la columna en la matriz de valores Char especificada.

System_CAPS_pubmethodSetDateTime(Int32, DateTime)

Establece los datos almacenados en la columna en el valor DateTime especificado.

System_CAPS_pubmethodSetDateTimeOffset(Int32, DateTimeOffset)

Establece el valor de la columna especificada en el valor de DateTimeOffset.

System_CAPS_pubmethodSetDBNull(Int32)

Establece el valor de la columna especificada en DBNull.

System_CAPS_pubmethodSetDecimal(Int32, Decimal)

Establece los datos almacenados en la columna en el valor Decimal especificado.

System_CAPS_pubmethodSetDouble(Int32, Double)

Establece los datos almacenados en la columna en el valor Double especificado.

System_CAPS_pubmethodSetFloat(Int32, Single)

Establece los datos almacenados en la columna en el valor float especificado.

System_CAPS_pubmethodSetGuid(Int32, Guid)

Establece los datos almacenados en la columna en el valor Guid especificado.

System_CAPS_pubmethodSetInt16(Int32, Int16)

Establece los datos almacenados en la columna en el valor Int16 especificado.

System_CAPS_pubmethodSetInt32(Int32, Int32)

Establece los datos almacenados en la columna en el valor Int32 especificado.

System_CAPS_pubmethodSetInt64(Int32, Int64)

Establece los datos almacenados en la columna en el valor Int64 especificado.

System_CAPS_pubmethodSetSqlBinary(Int32, SqlBinary)

Establece los datos almacenados en la columna en el valor SqlBinary especificado.

System_CAPS_pubmethodSetSqlBoolean(Int32, SqlBoolean)

Establece los datos almacenados en la columna en el valor SqlBoolean especificado.

System_CAPS_pubmethodSetSqlByte(Int32, SqlByte)

Establece los datos almacenados en la columna en el valor SqlByte especificado.

System_CAPS_pubmethodSetSqlBytes(Int32, SqlBytes)

Establece los datos almacenados en la columna en el valor SqlBytes especificado.

System_CAPS_pubmethodSetSqlChars(Int32, SqlChars)

Establece los datos almacenados en la columna en el valor SqlChars especificado.

System_CAPS_pubmethodSetSqlDateTime(Int32, SqlDateTime)

Establece los datos almacenados en la columna en el valor SqlDateTime especificado.

System_CAPS_pubmethodSetSqlDecimal(Int32, SqlDecimal)

Establece los datos almacenados en la columna en el valor SqlDecimal especificado.

System_CAPS_pubmethodSetSqlDouble(Int32, SqlDouble)

Establece los datos almacenados en la columna en el valor SqlDouble especificado.

System_CAPS_pubmethodSetSqlGuid(Int32, SqlGuid)

Establece los datos almacenados en la columna en el valor SqlGuid especificado.

System_CAPS_pubmethodSetSqlInt16(Int32, SqlInt16)

Establece los datos almacenados en la columna en el valor SqlInt16 especificado.

System_CAPS_pubmethodSetSqlInt32(Int32, SqlInt32)

Establece los datos almacenados en la columna en el valor SqlInt32 especificado.

System_CAPS_pubmethodSetSqlInt64(Int32, SqlInt64)

Establece los datos almacenados en la columna en el valor SqlInt64 especificado.

System_CAPS_pubmethodSetSqlMoney(Int32, SqlMoney)

Establece los datos almacenados en la columna en el valor SqlMoney especificado.

System_CAPS_pubmethodSetSqlSingle(Int32, SqlSingle)

Establece los datos almacenados en la columna en el valor SqlSingle especificado.

System_CAPS_pubmethodSetSqlString(Int32, SqlString)

Establece los datos almacenados en la columna en el valor SqlString especificado.

System_CAPS_pubmethodSetSqlXml(Int32, SqlXml)

Establece los datos almacenados en la columna en el valor SqlXml especificado.

System_CAPS_pubmethodSetString(Int32, String)

Establece los datos almacenados en la columna en el valor String especificado.

System_CAPS_pubmethodSetTimeSpan(Int32, TimeSpan)

Establece el valor de la columna especificada en TimeSpan.

System_CAPS_pubmethodSetValue(Int32, Object)

Establece un nuevo valor, expresado como el tipo de Common Language Runtime (CLR), para la columna especificada por el ordinal de columna.

System_CAPS_pubmethodSetValues(Object[])

Establece nuevos valores para todas las columnas de SqlDataRecord. Estos valores se expresan como tipos de Common Language Runtime (CLR)

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethodIDataRecord.GetData(Int32)

No se admite en esta versión.

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

Al escribir common language runtime (CLR) aplicaciones, debe volver a usar existente SqlDataRecord objetos en lugar de crear nuevos cada vez. Crear muchas nuevas SqlDataRecord objetos pueden mermar la memoria en exceso y afectar negativamente al rendimiento.

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 la SqlDataRecord se establecen y SqlDataRecord se envía al programa que realiza la 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);
}

.NET Framework
Disponible desde 2.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: