Rename Column

Rename Column

Tipo: rename-column  ·  Paquete: DataTable Activities v1.0.5  ·  Salida: DataTable

Cambia el nombre de una columna de una DataTable y devuelve una tabla nueva. Útil para normalizar encabezados antes de combinar tablas con Join, o para darle nombres legibles a columnas que vienen de una fuente con títulos poco claros.

Cómo funciona

Copia la tabla y renombra la columna column a newName, conservando su posición, su tipo y sus datos. La búsqueda de column no distingue mayúsculas de minúsculas. La tabla original no cambia.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
table	DataTable	—	La DataTable a modificar.
column	string	—	Nombre actual de la columna.
newName	string	—	Nombre nuevo. No debe coincidir con otra columna existente.

Parámetros opcionales

Ninguno.

Salida

Devuelve una DataTable nueva, idéntica a la original salvo por el nombre de la columna.

Errores comunes

Mensaje	Causa y solución
'table' debe ser una DataTable.	table no evalúa a una DataTable.
'column' es obligatorio. / 'newName' es obligatorio.	Falta el nombre actual o el nuevo.
No se encontró la columna '…'.	La columna a renombrar no existe. Revisa el nombre.
A column named '…' already belongs to this DataTable.	newName ya es el nombre de otra columna (mensaje de .NET, sin traducir). Quita esa columna antes con Drop Column o elige otro nombre.

Ejemplo

Rename Column   table = datos   column = "col1"   newName = "Cliente"   → output: legible
Join DataTable  left = legible   right = clientes   on = "Cliente"   → output: completo

Antes de un Join

Para unir dos tablas por una columna común, ambas deben tener esa columna con el mismo nombre. Si en una se llama nit y en otra NumeroIdentificacion, renombra una de ellas primero para que coincidan.

Actividades relacionadas

• Drop Column — eliminar columnas.
• Join DataTable — unir tablas por una columna común.