Funciones VB personalizadas

Función: serializar

• Función: String Serialize(Object value)
• Descripción: devuelve una representación de cadena del objeto especificado.
• Ejemplo:

  Serialize(Queues.testQueue.arg1)
  

Función: deserializar

• Función: T Deserialize<T>(string obj)
• Descripción: devuelve un objeto de tipo T. Toma como entrada una representación de cadena JSON válida de un objeto.
• Ejemplo:

  Deserialize(Of AppsFile)(textV)
  

Donde textV es una variable de tipo Texto, que contiene la cadena serializada del objeto.

Función: App.QueryParam

Para objetos

• Función: T? App.QueryParam<T>((string param, T? defaultValue = default(T))
• Descripción:
  • Si el parámetro de consulta se pasa en la URL , la función devuelve ese valor deserializado en función del tipo genérico T.
  • Si la deserialización falla o si el parámetro de consulta no se pasa en la URL, la función devuelve el valor por defecto.
• Ejemplo:

  App.QueryParam(Of AppsFile)("file", new AppsFile("https://i0.wp.com/
  imagelinkmri.com/wp-content/uploads/2021/08/imagelink-04.png"))
  

Para cadenas

• Función: string App.QueryParam(string param, string? defaultValue = "")
• Descripción:
  • Si el parámetro de consulta se pasa en la URL, la función devuelve ese valor como string.
  • Si el parámetro de consulta no se pasa en la URL, la función devuelve el valor predeterminado.
• Ejemplo:

  App.QueryParam("stringVariable", "defaultText")
  

Función: añadir elemento a la lista

• Función: List<T> AddItemToList<T>(List<T> list, T value)
• Descripción: dada una lista de tipo T, añade un elemento a la lista y devuelve la lista actualizada.
• Ejemplo:

  AddItemToList(Of String)(stringList, "AddMe")
  

Función: actualizar el elemento de la lista en el índice

• Función: List<T> UpdateListItemAtIndex<T>(List<T> list, int index, T value)
• Descripción: dada una lista de tipo T, actualiza el elemento en el índice especificado y devuelve la lista actualizada.
• Ejemplo:

  UpdateListItemAtIndex(Of String)(stringList, MainPage.EditGrid.RowIndex,"UpdateValue")
  

Función: eliminar elemento de la lista

• Función: List<T> DeleteItemFromList<T>(List<T> list, int index)
• Descripción: dada una lista de tipo T, elimina el elemento en el índice especificado y devuelve la lista actualizada.
• Ejemplo:

  DeleteItemFromList(Of String)(stringList, MainPage.EditGrid.RowIndex)
  

Función: Obtener

Esta función la utiliza el Generador de consultas. Consulta La función Obtener para obtener más detalles sobre esta función y cómo utilizarla en la práctica.

Importante:

La función Fetch() es asíncrona y no admite el encadenamiento.

Para mostrar un registro de entidad en un control, vincula el origen de datos de control a la entidad utilizando el Generador de consultas. Consulta Uso de las funciones Fetch para ver un ejemplo práctico.

• Función: ListSource<T> Fetch<T>(FilterGroup group = null, PaginationProps paginationProps = null, SortOption[] sortOptions = null, string[] selectedFields = null, ExpansionFieldOption[] expansionFieldOptions = null )
• Descripción: devuelve todos los registros de un objeto de entidad, según los parámetros mencionados.
• Ejemplo:

  Fetch(of AlexEntity)(createFilterGroup(Nothing, New FilterGroup(){createFilterGroup(New QueryFilter(){addFilter(MainPage.EditGrid.SearchColumn, "contains", MainPage.EditGrid.SearchTerm)}, Nothing, 0)}, 0), New PaginationProps(MainPage.EditGrid.PageStart, MainPage.EditGrid.PageLimit), New SortOption(){addSortOption(MainPage.EditGrid.SortColumn, Not(Not(MainPage.EditGrid.isDescending)))}, Nothing, New ExpansionFieldOption(){addExpansionFieldOption("CreatedBy", New String(){"Id","Name"}), addExpansionFieldOption("UpdatedBy", New String(){"Id","Name"})})
  

Función: Obtener uno

Esta función la utiliza el creador de consultas y no debe confundirse con la función Obtener. Consulta La función Obtener para obtener más información sobre las diferencias entre estas dos funciones y cómo utilizarlas en la práctica.

Importante:

La función FetchOne() es asíncrona y no admite el encadenamiento.

Para mostrar registros de entidad en un control, utiliza una variable de aplicación y la regla Establecer valor . Consulta Uso de las funciones Fetch para ver un ejemplo práctico.

• Función: T FetchOne<T>(FilterGroup group = null, PaginationProps paginationProps = null, SortOption[] sortOptions = null, string[] selectedFields = null, ExpansionFieldOption[] expansionFieldOptions = null)
• Descripción: devuelve un único registro de un objeto de entidad, según los parámetros mencionados.
• Ejemplo:

  FetchOne(of Employee)(
          createFilterGroup(new QueryFilter(){addFilter(
              MainPage.EditGrid.SearchColumn,"contains",MainPage.EditGrid.SearchTerm)}),
              new PaginationProps(MainPage.EditGrid.PageStart, MainPage.EditGrid.PageLimit),
              new SortOption(){
                  addSortOption(
                      MainPage.EditGrid.SortColumn,MainPage.EditGrid.isDescending)
                  }
  )
  

Función: Crear grupo de filtros

Esta función la utiliza el Generador de consultas.

• Función: FilterGroup createFilterGroup(QueryFilter[] queryFilters, FilterGroup[] groups = null, int isAnd = 0)
• Descripción: dada una matriz de filtros de consulta y grupos de filtros, genera un grupo de filtros.
• Ejemplo:

  createFilterGroup(Nothing, New FilterGroup(){createFilterGroup(New QueryFilter(){addFilter(MainPage.EditGrid.SearchColumn, "contains", MainPage.EditGrid.SearchTerm)}, Nothing, 0)}, 0)
  

Función: añadir filtro

Esta función la utiliza el Generador de consultas.

• Función: QueryFilter addFilter(string columnName, string colOperator, string value)
• Descripción: dado un nombre de columna, un operador y un valor, genera un filtro de consulta.
• Ejemplo:

  addFilter(MainPage.EditGrid.SearchColumn, "contains", MainPage.EditGrid.SearchTerm)
  

Función: añadir opción de ordenación

Esta función la utiliza el Generador de consultas.

• Función: SortOption addSortOption(string columnName, bool isDescending = false)
• Descripción: dado un nombre de columna y un valor de clasificación, genera y ordena un filtro de consulta.
• Ejemplo:

  addSortOption(MainPage.EditGrid.SortColumn, Not(Not(MainPage.EditGrid.isDescending)))}
  

Función: obtener el conjunto de opciones

Importante:

• La función GetChoiceSet() es asíncrona y no admite el encadenamiento.
• La entidad que aloja el conjunto de opciones debe añadirse a tu aplicación.

• Función: ListSource<ChoiceSet> GetChoiceSet(string choiceSetName)
• Descripción: dado el nombre de un conjunto de opciones de Data Service, devuelve todos los valores del conjunto de opciones.
• Ejemplo:

  GetChoiceSet("Gender")
  

Función: obtener el valor del conjunto de opciones

Importante:

• La función GetChoiceSet() es asíncrona y no admite el encadenamiento.
• La entidad que aloja el conjunto de opciones debe añadirse a tu aplicación.

• Función: string GetChoiceSetValue(string choiceSetName, int numberId)
• Descripción: dado el nombre de un conjunto de opciones de Data Service y el índice de una opción de conjunto de opciones, devuelve la opción especificada.
• Ejemplo:

  GetChoiceSetValue("Gender", 0)
  

Función: crear tabla de datos

• Función: DataTable BuildDataTable(DataTable dt, DataColumn[] columns, List<Object> rowData, bool clear=false)
• Descripción: carga una tabla de datos con columnas y filas en la regla Establecer valor y devuelve la tabla de datos actualizada.

Si el parámetro clear es verdadero, borra el contenido de las columnas y las filas de la tabla de datos.

• Ejemplo:

  BuildDataTable(
      New DataTable("TestDT"), 
      New DataColumn(){ New DataColumn("Name"), New DataColumn("Age")},
      New List(Of Object) From { 
          AddDataRow(New Object(){"Baishali", "30"}), 
          AddDataRow(New Object(){"Viswa", "33"}) 
      },
      True
  )
  

Función: añadir fila

• Función: AddRow(DataRow row)
• Descripción: método de extensión de TablaDeDatos que añade la fila especificada a una tabla de datos y devuelve la instancia actualizada.
• Ejemplo:

  dt.AddRow(row)
  

Función: Eliminar fila

• Función: DeleteRowAt(int index)
• Descripción: método de extensión de TablaDeDatos que elimina la fila en el índice especificado en una tabla de datos y devuelve la instancia actualizada.
• Ejemplo:

  dt.DeleteRowAt(2)
  

Función: Actualizar fila en

• Función: UpdateRowAt(int index, DataRow row)
• Descripción: método de extensión TablaDeDatos que actualiza la fila en el índice especificado con los nuevos datos de la fila y devuelve la tabla de datos actualizada.
• Ejemplo:

  dt.UpdateRowAt(2, row)
  

Función: Actualizar celda en (utilizando el índice de columna)

• Función: UpdateCellAt(int rowIndex, int columnIndex, object value)
• Descripción: método de extensión de TablaDeDatos que actualiza la celda de la tabla de datos en el índice de fila y el índice de columna especificados.
• Ejemplo:

  dt.UpdateCellAt(0, 2, "Hi")
  

Función: actualizar la celda en (usando el nombre de la columna)

• Función: UpdateCellAt(int rowIndex, string columnName, object value)
• Descripción: método de extensión de TablaDeDatos que actualiza la celda de la tabla de datos en el índice de fila y el nombre de columna especificados.
• Ejemplo:

  dt.UpdateCellAt(0, "Greetings", "Hi")