Quita registros de un origen de datos.

Descripción

Función Quitar

Use la función Quitar para quitar un registro o registros específicos de un origen de datos.

Para las colecciones, tiene que coincidir con todo el registro. Puede usar el argumento Todo para quitar todas las copias de un registro; en caso contrario, se quita solo una copia del registro.

Función RemoveIf

Use la función RemoveIf para quitar un registro o registros en función de una condición o un conjunto de condiciones. Cada condición puede ser cualquier fórmula que da como resultado true o false y puede hacer referencia a columnas del origen de datos por su nombre. Cada condición se evalúa individualmente para cada registro, y si todas las condiciones se evalúan como true se elimina el registro.

Quitar y RemoveIf devuelven el origen de datos modificado como una tabla. Puede usar ambas funciones únicamente en fórmulas de comportamiento.

También puede usar la función Clear para eliminar registros en un origen de datos.

Delegación

Cuando se usa con un origen de datos, estas funciones no se pueden delegar. Solo se recuperará la primera parte del origen de datos y, después, se aplicará la función. Es posible que el resultado no represente la situación completa. Aparecerá un punto azul durante la creación para recordarle esta limitación y sugerirle que cambie a alternativas que puedan delegarse siempre que sea posible. Para más información, consulte la introducción a la delegación.

Sintaxis

Quitar( DataSource, Record1 [, Record2, ... ] [, Todo ] )

  • DataSource: requerido. El origen de datos que contiene el registro o los registros que desea quitar.

  • Registro(s): requerido. El registro o los registros que se van a quitar.

  • Todo: opcional. En una colección, el mismo registro puede aparecer más de una vez. Puede agregar el argumento Todo para quitar todas las copias del registro.

Quitar( DataSource, Tabla [, Todo ] )

  • DataSource: requerido. El origen de datos que contiene los registros que desea quitar.

  • Tabla: requerido. Tabla de registros que se van a quitar.

  • Todo: opcional. En una colección, el mismo registro puede aparecer más de una vez. Puede agregar el argumento Todo para quitar todas las copias del registro.

RemoveIf( DataSource, Condición [,...])

  • DataSource: requerido. El origen de datos que contiene el registro o los registros que desea quitar.

  • Condition(s): requerido. Una fórmula que se evalúa como true para el registro o los registros que se van a quitar. Puede usar nombres de columna de DataSource en la fórmula. Si especifica varias Condiciones, todas se deben evaluar como true para el registro o registros que va a quitar.

Ejemplos

En estos ejemplos, va a quitar un registro o registros de un origen de datos que se denomina IceCream y que comienza con los datos en esta tabla:

Fórmula Descripción Resultado
Quitar ( IceCream,
Primero ( Filtrar ( IceCream, Flavor = "Chocolate" ) ))
Quita el registro Chocolate del origen de datos.

El origen de datos IceCream se ha modificado.
Quitar ( IceCream,
Primero ( Filtrar ( IceCream, Flavor = "Chocolate" ) ) First ( Filtrar ( IceCream, Flavor = "Strawberry" ) ) )
Quita los dos registros del origen de datos.

El origen de datos IceCream se ha modificado.
RemoveIf ( IceCream, Cantidad > 150) Quita los registros que tienen una Cantidad superior a 150.

El origen de datos IceCream se ha modificado.
RemoveIf( IceCream, Cantidad > 150, Left( Flavor, 1 ) = "S" ) Quita los registros que tienen una Cantidad superior a 150 y cuyo valor Flavor empieza con S.


El origen de datos IceCream se ha modificado.
RemoveIf ( IceCream, true) Quita todos los registros del origen de datos.

El origen de datos IceCream se ha modificado.

Paso a paso

  1. Importe o cree una colección denominada Inventory y muéstrela en una galería, como se describe en el artículo sobre la visualización de datos en una galería.

  2. En la galería, establezca la propiedad AlSeleccionar de la imagen en la expresión:
    Quitar (Inventario, EsteElemento)

  3. Presione F5 y, a continuación, seleccione una imagen en la galería.
    El elemento se quita de la galería y la colección.