SetByName

Define el valor de la columna correspondiente para DataRow. Si el valor para el nombre ya existe, el valor anterior es reemplazado.

Sintaxis

Versión ASCII
int setByName(DataRow* dataRow, const char* name, const char* value) 
Versión Unicode
int setByName(DataRow* dataRow, const UChar* name, const
UChar* value) 

Parámetros

  • Datarow: DataRow (Fila de datos) a la que se aplica esta función
  • El nombre con el que debe relacionarse el valor especificado
  • El valor relacionado con el nombre especificado.

Excepciones

Si el nombre de columna está en blanco o duplicado, se obtiene un mensaje de error.

Resultados

Arroja 0 (en caso de éxito) o un código de error.

Ejemplo

Versión ASCII
int nRet; 
nRet= setByName (dataRow, "City", "Austin"); 
if(nRet != SUCCESSFUL_RETURN) 
{	printf(getErrorMessage(nRet)); 
//more code 
}
Versión Unicode
int nRet; 
UChar* error; 
UChar columnName[64]; 
char* columnNameStr= "City" 
UChar columnValue[64]; 
char* columnValueStr= "Austin"; 
u_charsToUChars(columnNameStr,	columnName, strlen(columnNameStr)); 
columnName [strlen(columnNameStr)]=0; 
u_charsToUChars(columnValueStr,	columnValue, strlen(columnValueStr)); 
columnValue [strlen(columnValueStr)]=0; 
nRet= setByName (dataRow,	columnName, columnValue); 
if(nRet != SUCCESSFUL_RETURN) 
{	error	= getErrorMessage(nRet); 
//more code 
}