¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

SqlDataRecord (Clase)

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

System.Object
  Microsoft.SqlServer.Server.SqlDataRecord

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

public class SqlDataRecord : IDataRecord

El tipo SqlDataRecord expone los siguientes miembros.

  NombreDescripción
Método públicoSqlDataRecordInicializa una nueva instancia de SqlDataRecord con el esquema basado en la matriz de objetos SqlMetaData pasada como argumento.
Arriba

  NombreDescripción
Propiedad públicaFieldCountObtiene el número de columnas de la fila de datos. Esta propiedad es de sólo lectura.
Propiedad públicaItem[Int32]Obtiene el valor del tipo de Common Language Runtime (CLR) para la columna especificada por el argumento ordinal de columna.
Propiedad públicaItem[String]Obtiene el valor del tipo de Common Language Runtime (CLR) para la columna especificada por el argumento name de columna.
Arriba

  NombreDescripción
Método públicoEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoGetBooleanObtiene el valor de la columna especificada por el ordinal como un valor Boolean.
Método públicoGetByteObtiene el valor de la columna especificada por el ordinal como un valor Byte.
Método públicoGetBytesObtiene el valor de la columna especificada por el ordinal como una matriz de objetos Byte.
Método públicoGetCharObtiene el valor de la columna especificada por el ordinal como un valor Char.
Método públicoGetCharsObtiene el valor de la columna especificada por el ordinal como una matriz de objetos Char.
Método públicoGetDataTypeNameDevuelve el nombre del tipo de datos para la columna especificada por el argumento de ordinal.
Método públicoGetDateTimeObtiene el valor de la columna especificada por el ordinal como un valor DateTime.
Método públicoGetDateTimeOffsetDevuelve los datos de la columna especificada como DateTimeOffset.
Método públicoGetDecimalObtiene el valor de la columna especificada por el ordinal como un valor Decimal.
Método públicoGetDoubleObtiene el valor de la columna especificada por el ordinal como un valor de tipo Double.
Método públicoGetFieldTypeDevuelve 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.
Método públicoGetFloatObtiene el valor de la columna especificada por el ordinal como un valor float.
Método públicoGetGuidObtiene el valor de la columna especificada por el ordinal como un valor Guid.
Método públicoGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoGetInt16Obtiene el valor de la columna especificada por el ordinal como un valor Int16.
Método públicoGetInt32Obtiene el valor de la columna especificada por el ordinal como un valor Int32.
Método públicoGetInt64Obtiene el valor de la columna especificada por el ordinal como un valor Int64.
Método públicoGetNameDevuelve el nombre de la columna especificada por el argumento de ordinal.
Método públicoGetOrdinalDevuelve el índice de columna especificado por el nombre de columna.
Método públicoGetSqlBinaryObtiene el valor de la columna especificada por el ordinal como un valor SqlBinary.
Método públicoGetSqlBooleanObtiene el valor de la columna especificada por el ordinal como un valor SqlBoolean.
Método públicoGetSqlByteObtiene el valor de la columna especificada por el ordinal como un valor SqlByte.
Método públicoGetSqlBytesObtiene el valor de la columna especificada por el ordinal como un valor SqlBytes.
Método públicoGetSqlCharsObtiene el valor de la columna especificada por el ordinal como un valor SqlChars.
Método públicoGetSqlDateTimeObtiene el valor de la columna especificada por el ordinal como un valor SqlDateTime.
Método públicoGetSqlDecimalObtiene el valor de la columna especificada por el ordinal como un valor SqlDecimal.
Método públicoGetSqlDoubleObtiene el valor de la columna especificada por el ordinal como un valor SqlDouble.
Método públicoGetSqlFieldTypeDevuelve 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.
Método públicoGetSqlGuidObtiene el valor de la columna especificada por el ordinal como un valor SqlGuid.
Método públicoGetSqlInt16Obtiene el valor de la columna especificada por el ordinal como un valor SqlInt16.
Método públicoGetSqlInt32Obtiene el valor de la columna especificada por el ordinal como un valor SqlInt32.
Método públicoGetSqlInt64Obtiene el valor de la columna especificada por el ordinal como un valor SqlInt64.
Método públicoGetSqlMetaDataDevuelve un objeto SqlMetaData, que describe los metadatos de la columna especificada por el índice de columna.
Método públicoGetSqlMoneyObtiene el valor de la columna especificada por el ordinal como un valor SqlMoney.
Método públicoGetSqlSingleObtiene el valor de la columna especificada por el ordinal como un valor SqlSingle.
Método públicoGetSqlStringObtiene el valor de la columna especificada por el ordinal como un valor SqlString.
Método públicoGetSqlValueDevuelve el valor de datos almacenado en la columna especificada por el índice de columna como un tipo de SQL Server.
Método públicoGetSqlValuesDevuelve en una matriz los valores de todas las columnas en el registro, expresados como tipos de SQL Server.
Método públicoGetSqlXmlObtiene el valor de la columna especificada por el ordinal como un valor SqlXml.
Método públicoGetStringObtiene el valor de la columna especificada por el ordinal como un valor String.
Método públicoGetTimeSpanDevuelve los datos de la columna especificada como TimeSpan.
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoGetValueDevuelve el valor del tipo de Common Language Runtime (CLR) para la columna especificada por el argumento de ordinal.
Método públicoGetValuesDevuelve en una matriz los valores de todas las columnas en el registro, expresados como tipos de Common Language Runtime (CLR).
Método públicoIsDBNullDevuelve true si la columna especificada por el parámetro de índice de columna es null.
Método protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método públicoSetBooleanEstablece los datos almacenados en la columna en el valor Boolean especificado.
Método públicoSetByteEstablece los datos almacenados en la columna en el valor Byte especificado.
Método públicoSetBytesEstablece los datos almacenados en la columna en la matriz especificada de valores de Byte.
Método públicoSetCharEstablece los datos almacenados en la columna en el valor Char especificado.
Método públicoSetCharsEstablece los datos almacenados en la columna en la matriz especificada de valores de Char.
Método públicoSetDateTimeEstablece los datos almacenados en la columna en el valor de DateTime especificado.
Método públicoSetDateTimeOffsetEstablece el valor de la columna especificada en el valor DateTimeOffset.
Método públicoSetDBNullEstablece el valor de la columna especificada en DBNull.
Método públicoSetDecimalEstablece los datos almacenados en la columna en el valor Decimal especificado.
Método públicoSetDoubleEstablece los datos almacenados en la columna en el valor Double especificado.
Método públicoSetFloatEstablece los datos almacenados en la columna en el valor float especificado.
Método públicoSetGuidEstablece los datos almacenados en la columna en el valor de Guid especificado.
Método públicoSetInt16Establece los datos almacenados en la columna en el valor Int16 especificado.
Método públicoSetInt32Establece los datos almacenados en la columna en el valor Int32 especificado.
Método públicoSetInt64Establece los datos almacenados en la columna en el valor Int64 especificado.
Método públicoSetSqlBinaryEstablece los datos almacenados en la columna en el valor SqlBinary especificado.
Método públicoSetSqlBooleanEstablece los datos almacenados en la columna en el valor SqlBoolean especificado.
Método públicoSetSqlByteEstablece los datos almacenados en la columna en el valor de SqlByte especificado.
Método públicoSetSqlBytesEstablece los datos almacenados en la columna en el valor de SqlBytes especificado.
Método públicoSetSqlCharsEstablece los datos almacenados en la columna en el valor de SqlChars especificado.
Método públicoSetSqlDateTimeEstablece los datos almacenados en la columna en el valor de SqlDateTime especificado.
Método públicoSetSqlDecimalEstablece los datos almacenados en la columna en el valor SqlDecimal especificado.
Método públicoSetSqlDoubleEstablece los datos almacenados en la columna en el valor SqlDouble especificado.
Método públicoSetSqlGuidEstablece los datos almacenados en la columna en el valor de SqlGuid especificado.
Método públicoSetSqlInt16Establece los datos almacenados en la columna en el valor SqlInt16 especificado.
Método públicoSetSqlInt32Establece los datos almacenados en la columna en el valor SqlInt32 especificado.
Método públicoSetSqlInt64Establece los datos almacenados en la columna en el valor SqlInt64 especificado.
Método públicoSetSqlMoneyEstablece los datos almacenados en la columna en el valor SqlMoney especificado.
Método públicoSetSqlSingleEstablece los datos almacenados en la columna en el valor SqlSingle especificado.
Método públicoSetSqlStringEstablece los datos almacenados en la columna en el valor SqlString especificado.
Método públicoSetSqlXmlEstablece los datos almacenados en la columna en el valor SqlXml especificado.
Método públicoSetStringEstablece los datos almacenados en la columna en el valor String especificado.
Método públicoSetTimeSpanEstablece el valor de la columna especificada en TimeSpan.
Método públicoSetValueEstablece un nuevo valor, expresado como un tipo de Common Language Runtime (CLR), para la columna especificada por el índice de columna.
Método públicoSetValuesEstablece nuevos valores para todas las columnas de SqlDataRecord. Estos valores se expresan como tipos de Common Language Runtime (CLR).
Método públicoToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Arriba

  NombreDescripción
Implementación explícita de interfacesMétodo privadoIDataRecord.GetDataNo es compatible con esta versión.
Arriba

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

Al escribir aplicaciones de Common Language Runtime (CLR), debe volver a utilizar los objetos SqlDataRecord existentes en lugar de crear objetos nuevos cada vez. La creación de muchos objetos SqlDataRecord nuevos puede mermar la memoria en exceso y afectar negativamente al rendimiento.

En el ejemplo siguiente se muestra la forma de crear varios objetos SqlMetaData, que describen los metadatos de la columna de un registro, así como la forma de crear SqlDataRecord. Se establecen los valores de columna de SqlDataRecord, y SqlDataRecord se envía al programa que realiza la llamada utilizando la clase SqlContext.


[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

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft