SqlDataRecord Classe

Riferimento

Definizione

Spazio dei nomi:: Microsoft.SqlServer.Server

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Pacchetto:: System.Data.SqlClient v4.8.5

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta una singola riga di dati e dei relativi metadati. La classe non può essere ereditata.

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

public class SqlDataRecord : System.Data.IDataRecord

type SqlDataRecord = class
    interface IDataRecord

Public Class SqlDataRecord
Implements IDataRecord

Ereditarietà: Object
SqlDataRecord

Implementazioni: IDataRecord

Esempio

Nell'esempio seguente viene illustrato come creare diversi SqlMetaData oggetti, che descrivono i metadati di colonna di un record e la creazione di un SqlDataRecordoggetto . I valori di colonna dell'oggetto SqlDataRecord sono impostati e vengono SqlDataRecord inviati al programma chiamante usando la SqlContext classe .

[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

Commenti

Questa classe viene usata insieme SqlPipe per inviare set di risultati al client dalle stored procedure del codice gestito.

Quando si scrivono applicazioni CLR (Common Language Runtime), è consigliabile riutilizzare gli oggetti esistenti SqlDataRecord anziché crearne di nuovi ogni volta. La creazione di molti nuovi SqlDataRecord oggetti potrebbe ridurre notevolmente la memoria e influire negativamente sulle prestazioni.

Costruttori

SqlDataRecord(SqlMetaData[])

Inizializza una nuova istanza di SqlDataRecord con lo schema basato su una matrice di oggetti SqlMetaData passata come argomento.

Proprietà

FieldCount	Ottiene il numero di colonne nella riga di dati. Questa proprietà è di sola lettura.
Item[Int32]	Ottiene il valore del tipo CLR (Common Language Runtime) relativo alla colonna specificata dall'argomento `ordinal` della colonna.
Item[String]	Ottiene il valore del tipo CLR (Common Language Runtime) relativo alla colonna specificata dall'argomento `name` della colonna.

Metodi

GetBoolean(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto Boolean.
GetByte(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto Byte.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Ottiene il valore per la colonna specificata dall'ordinale come matrice di oggetti Byte.
GetChar(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto Char.
GetChars(Int32, Int64, Char[], Int32, Int32)	Ottiene il valore per la colonna specificata dall'ordinale come matrice di oggetti Char.
GetDataTypeName(Int32)	Restituisce il nome del tipo di dati per la colonna specificata dall'argomento ordinale.
GetDateTime(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto DateTime.
GetDateTimeOffset(Int32)	Restituisce i dati della colonna specificata come oggetto DateTimeOffset.
GetDecimal(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto Decimal.
GetDouble(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto Double.
GetFieldType(Int32)	Restituisce un oggetto Type che rappresenta il tipo CLR (Common Language Runtime) mappato al tipo SQL Server della colonna specificata dall'argomento `ordinal`.
GetFloat(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto `float`.
GetGuid(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto Guid.
GetInt16(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto Int16.
GetInt32(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto Int32.
GetInt64(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto Int64.
GetName(Int32)	Restituisce il nome della colonna specificata dall'argomento ordinale.
GetOrdinal(String)	Restituisce l'ordinale della colonna specificato dal nome della colonna.
GetSqlBinary(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto SqlBinary.
GetSqlBoolean(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto SqlBoolean.
GetSqlByte(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto SqlByte.
GetSqlBytes(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto SqlBytes.
GetSqlChars(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto SqlChars.
GetSqlDateTime(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto SqlDateTime.
GetSqlDecimal(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto SqlDecimal.
GetSqlDouble(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto SqlDouble.
GetSqlFieldType(Int32)	Restituisce un oggetto Type che rappresenta il tipo (come un tipo SQL Server, definito in System.Data.SqlTypes) che esegue il mapping al tipo Server SQL della colonna.
GetSqlGuid(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto SqlGuid.
GetSqlInt16(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto SqlInt16.
GetSqlInt32(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto SqlInt32.
GetSqlInt64(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto SqlInt64.
GetSqlMetaData(Int32)	Restituisce un oggetto SqlMetaData che descrive i metadati della colonna specificata dall'ordinale colonna.
GetSqlMoney(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto SqlMoney.
GetSqlSingle(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto SqlSingle.
GetSqlString(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto SqlString.
GetSqlValue(Int32)	Restituisce il valore dei dati archiviati nella colonna, espresso come tipo SQL Server, specificato dall'ordinale della colonna.
GetSqlValues(Object[])	Restituisce i valori relativi a tutte le colonne del record, espressi come tipi SQL Server, in una matrice.
GetSqlXml(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto SqlXml.
GetString(Int32)	Ottiene il valore per la colonna specificata dall'ordinale come oggetto String.
GetTimeSpan(Int32)	Restituisce i dati della colonna specificata come oggetto TimeSpan.
GetValue(Int32)	Restituisce il valore del tipo CLR (Common Language Runtime) relativo alla colonna specificata dall'argomento ordinale.
GetValues(Object[])	Restituisce i valori per tutte le colonne del record, espressi come tipi Common Language Runtime (CLR) in una matrice.
IsDBNull(Int32)	Restituisce true se la colonna specificata dal parametro dell'ordinale di colonna è null.
SetBoolean(Int32, Boolean)	Imposta i dati archiviati nella colonna sul valore specificato di Boolean.
SetByte(Int32, Byte)	Imposta i dati archiviati nella colonna sul valore specificato di Byte.
SetBytes(Int32, Int64, Byte[], Int32, Int32)	Imposta i dati archiviati nella colonna sulla matrice specificata di valori di Byte.
SetChar(Int32, Char)	Imposta i dati archiviati nella colonna sul valore specificato di Char.
SetChars(Int32, Int64, Char[], Int32, Int32)	Imposta i dati archiviati nella colonna sulla matrice specificata di valori di Char.
SetDateTime(Int32, DateTime)	Imposta i dati archiviati nella colonna sul valore specificato di DateTime.
SetDateTimeOffset(Int32, DateTimeOffset)	Imposta il valore della colonna specificata su DateTimeOffset.
SetDBNull(Int32)	Imposta il valore nella colonna specificata su DBNull.
SetDecimal(Int32, Decimal)	Imposta i dati archiviati nella colonna sul valore specificato di Decimal.
SetDouble(Int32, Double)	Imposta i dati archiviati nella colonna sul valore specificato di Double.
SetFloat(Int32, Single)	Imposta i dati archiviati nella colonna sul valore specificato di `float`.
SetGuid(Int32, Guid)	Imposta i dati archiviati nella colonna sul valore specificato di Guid.
SetInt16(Int32, Int16)	Imposta i dati archiviati nella colonna sul valore specificato di Int16.
SetInt32(Int32, Int32)	Imposta i dati archiviati nella colonna sul valore specificato di Int32.
SetInt64(Int32, Int64)	Imposta i dati archiviati nella colonna sul valore specificato di Int64.
SetSqlBinary(Int32, SqlBinary)	Imposta i dati archiviati nella colonna sul valore specificato di SqlBinary.
SetSqlBoolean(Int32, SqlBoolean)	Imposta i dati archiviati nella colonna sul valore specificato di SqlBoolean.
SetSqlByte(Int32, SqlByte)	Imposta i dati archiviati nella colonna sul valore specificato di SqlByte.
SetSqlBytes(Int32, SqlBytes)	Imposta i dati archiviati nella colonna sul valore specificato di SqlBytes.
SetSqlChars(Int32, SqlChars)	Imposta i dati archiviati nella colonna sul valore specificato di SqlChars.
SetSqlDateTime(Int32, SqlDateTime)	Imposta i dati archiviati nella colonna sul valore specificato di SqlDateTime.
SetSqlDecimal(Int32, SqlDecimal)	Imposta i dati archiviati nella colonna sul valore specificato di SqlDecimal.
SetSqlDouble(Int32, SqlDouble)	Imposta i dati archiviati nella colonna sul valore specificato di SqlDouble.
SetSqlGuid(Int32, SqlGuid)	Imposta i dati archiviati nella colonna sul valore specificato di SqlGuid.
SetSqlInt16(Int32, SqlInt16)	Imposta i dati archiviati nella colonna sul valore specificato di SqlInt16.
SetSqlInt32(Int32, SqlInt32)	Imposta i dati archiviati nella colonna sul valore specificato di SqlInt32.
SetSqlInt64(Int32, SqlInt64)	Imposta i dati archiviati nella colonna sul valore specificato di SqlInt64.
SetSqlMoney(Int32, SqlMoney)	Imposta i dati archiviati nella colonna sul valore specificato di SqlMoney.
SetSqlSingle(Int32, SqlSingle)	Imposta i dati archiviati nella colonna sul valore specificato di SqlSingle.
SetSqlString(Int32, SqlString)	Imposta i dati archiviati nella colonna sul valore specificato di SqlString.
SetSqlXml(Int32, SqlXml)	Imposta i dati archiviati nella colonna sul valore specificato di SqlXml.
SetString(Int32, String)	Imposta i dati archiviati nella colonna sul valore specificato di String.
SetTimeSpan(Int32, TimeSpan)	Imposta il valore della colonna specificata su TimeSpan.
SetValue(Int32, Object)	Imposta un nuovo valore, espresso come tipo CLR (Common Language Runtime), per la colonna specificata dall'ordinale della colonna.
SetValues(Object[])	Imposta nuovi valori per tutte le colonne nell'oggetto SqlDataRecord. Questi valori sono espressi come tipi Common Language Runtime (CLR).

Implementazioni dell'interfaccia esplicita

IDataRecord.GetData(Int32)

Non supportato in questa versione.

Si applica a