SqlDataRecord.GetChars(Int32, Int64, Char[], Int32, Int32) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene el valor de la columna especificada por el ordinal como una matriz de objetos Char.
public:
virtual long GetChars(int ordinal, long fieldOffset, cli::array <char> ^ buffer, int bufferOffset, int length);public virtual long GetChars (int ordinal, long fieldOffset, char[] buffer, int bufferOffset, int length);abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64Public Overridable Function GetChars (ordinal As Integer, fieldOffset As Long, buffer As Char(), bufferOffset As Integer, length As Integer) As LongParámetros
- ordinal
- Int32
Ordinal basado en cero de la columna.
- fieldOffset
- Int64
Desplazamiento en el valor del campo para comenzar a recuperar caracteres.
- buffer
- Char[]
Búfer de destino en el que se van a copiar los caracteres.
- bufferOffset
- Int32
Desplazamiento en el búfer en el que se van a empezar a copiar los caracteres.
- length
- Int32
Número de caracteres que se van a copiar en el búfer.
Devoluciones
Número de caracteres copiados.
Implementaciones
Excepciones
ordinal es menor que 0 o mayor que el número de columnas (es decir, FieldCount).
La columna que especifica ordinal es nula.
Los tipos no coinciden.
Comentarios
Este método permite obtener un valor de carácter en una sola llamada o en fragmentos. Obtener el valor en fragmentos es útil para valores grandes o valores de tamaño desconocido.
Para obtener el valor en varios fragmentos, asigne una matriz char del tamaño del fragmento y llame GetChars repetidamente al ajuste del fieldOffset parámetro según corresponda en cada llamada.