CharField es un campo de string, para strings de tamaño pequeño a grande. Es como un campo de string en C/C+++. CharField se usa generalmente para almacenar strings pequeñas como nombre, apellido, etc. Para almacenar texto más grande, se usa TextField. El widget de formulario predeterminado para este campo es TextInput .
CharField tiene un argumento adicional requerido:
CharField.max_length
La longitud máxima (en caracteres) del campo. max_length se aplica a nivel de base de datos y en la validación de Django usando MaxLengthValidator .
Sintaxis:
field_name = models.CharField(max_length=200, **options)
Django Model CharField Explicación
Ilustración de CharField utilizando un ejemplo. Considere un proyecto llamado geeksforgeeks que tenga una aplicación llamada geeks.
Consulte los siguientes artículos para comprobar cómo crear un proyecto y una aplicación en Django.
Ingrese el siguiente código en el archivo models.py de la aplicación geeks .
Python3
from django.db import models from django.db.models import Model # Create your models here. class GeeksModel(Model): geeks_field = models.CharField(max_length = 200)
Agregue la aplicación geeks a INSTALLED_APPS
Python3
# Application definition INSTALLED_APPS = [ 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.messages', 'django.contrib.staticfiles', 'geeks', ]
Ahora, cuando ejecutamos el comando makemigrations desde la terminal,
Python manage.py makemigrations
Se crearía una nueva carpeta llamada migraciones en el directorio geeks con un archivo llamado 0001_initial.py
Python3
# Generated by Django 2.2.5 on 2019-09-25 06:00 from django.db import migrations, models class Migration(migrations.Migration): initial = True dependencies = [ ] operations = [ migrations.CreateModel( name ='GeeksModel', fields =[ ('id', models.AutoField( auto_created = True, primary_key = True, serialize = False, verbose_name ='ID' )), ('geeks_field', models.CharField( max_length = 200, )), ], ), ]
Ahora corre,
Python manage.py migrate
Por lo tanto, se crea un CharField geeks_field cuando ejecuta migraciones en el proyecto. Es un campo para almacenar strings de pequeño a gran tamaño.
¿Cómo usar CharField?
CharField se utiliza para almacenar strings de pequeño tamaño en la base de datos. Uno puede almacenar Nombre, Apellido, Detalles de dirección, etc. CharField debe recibir un argumento max_length para especificar la longitud máxima de la string que se requiere almacenar. En el servidor de producción, después de implementar la aplicación Django, el espacio es muy limitado. Por lo tanto, siempre es óptimo usar max_length de acuerdo con los requisitos del campo. Vamos a crear una instancia del CharField que creamos y verificar si funciona.
Python3
# importing the model # from geeks app from geeks.models import GeeksModel # creating a instance of # GeeksModel geek_object = GeeksModel.objects.create(geeks_field ="GFG is Best") geek_object.save()
Ahora vamos a comprobarlo en el servidor de administración. Hemos creado una instancia de GeeksModel.
Opciones de campo
Las opciones de campo son los argumentos dados a cada campo para aplicar alguna restricción o impartir una característica particular a un campo en particular. Por ejemplo, agregar un argumento null = True a CharField le permitirá almacenar valores vacíos para esa tabla en una base de datos relacional.
Estas son las opciones de campo y los atributos que puede usar un CharField.
Opciones de campo | Descripción |
---|---|
Nulo | Si es True , Django almacenará valores vacíos como NULL en la base de datos. El valor predeterminado es Falso . |
Vacío | Si es True , el campo puede estar en blanco. El valor predeterminado es Falso . |
columna_db | El nombre de la columna de la base de datos que se usará para este campo. Si no se proporciona, Django usará el nombre del campo. |
índice_db | Si es Verdadero, se creará un índice de base de datos para este campo |
db_tablespace | El nombre del tablespace de la base de datos que se usará para el índice de este campo, si este campo está indexado. El valor predeterminado es la configuración DEFAULT_INDEX_TABLESPACE del proyecto, si está establecida, o el db_tablespace del modelo, si lo hay. Si el backend no admite espacios de tabla para índices, esta opción se ignora. |
Defecto | El valor predeterminado para el campo. Puede ser un valor o un objeto invocable. Si es invocable, se llamará cada vez que se cree un nuevo objeto. |
texto de ayuda | Texto adicional de «ayuda» que se mostrará con el widget de formulario. Es útil para la documentación incluso si su campo no se usa en un formulario. |
Clave primaria | Si es Verdadero, este campo es la clave principal para el modelo. |
editable | Si es False , el campo no se mostrará en el administrador ni en ningún otro ModelForm. También se omiten durante la validación del modelo. El valor predeterminado es Verdadero . |
error de mensajes | El argumento error_messages le permite anular los mensajes predeterminados que generará el campo. Pase un diccionario con claves que coincidan con los mensajes de error que desea anular. |
texto de ayuda | Texto adicional de «ayuda» que se mostrará con el widget de formulario. Es útil para la documentación incluso si su campo no se usa en un formulario. |
nombre_verbose | Un nombre legible por humanos para el campo. Si no se proporciona el nombre detallado, Django lo creará automáticamente utilizando el nombre del atributo del campo, convirtiendo los guiones bajos en espacios. |
validadores | Una lista de validadores para ejecutar para este campo. Consulte la documentación de los validadores para obtener más información. |
Único | Si es Verdadero, este campo debe ser único en toda la tabla. |
Publicación traducida automáticamente
Artículo escrito por NaveenArora y traducido por Barcelona Geeks. The original can be accessed here. Licence: CCBY-SA