// ...
/// <summary>
/// Construye un nuevo objeto de la clase <code>ORMSelectParamsClass</code>,
/// que desciende de <code>ObjectClass</code>,
/// y ejecuta el inicializador virtual, por-de-facto.
/// Para ejecutar otro inicializador,
/// se tiene que realizar estas operaciones como pasos separados.
/// </summary>
/// <returns>Nuevo objeto</returns>
public static new ORMSelectParamsClass Factory()
{
ORMSelectParamsClass Result = new ORMSelectParamsClass();
Result.Create();
return Result;
}
/// <summary>
/// Regresa una lista de registros, como pares llave-valor,
/// de una sola tabla, que cumplan,
/// con la lista de predicados proporcionada,
/// excluyendo explicitamente registro "defacto".
/// En caso de no encontrar registro alguno,
/// regresa la lista solo con el registro "de facto", si lo hay,
/// aunque no cumpla con el criterio de busqueda,
/// o lista vacia en caso contrario.
/// </summary>
/// <param name="AParameters">Parametros para la consulta</param>
/// <returns>Lista de Registros Resultante</returns>
public virtual List<Dictionary<string, Object>> WhereORDefault(ORMSelectParamsClass AParameters)
{
List<Dictionary<string, Object>> Result = new List<Dictionary<string, Object>>();
if (this.IsReady())
{
this.DoNothing();
} // if (CanContinue)
return Result;
}
/// <summary>
/// Desecha objeto de la clase <code>ORMSelectParamsClass</code>,
/// que desciende de <code>ObjectClass</code>,
/// ejecutando el metodo finalizador, por-de-facto.
/// Para ejecutar otro finalizador,
/// se tiene que realizar estas operaciones como pasos separados.
/// </summary>
/// <param name="AObject">Objeto que se desechara de memoria</param>
public static void Disposer(ref ORMSelectParamsClass AObject)
{
if (AObject != null)
{
AObject.Destroy();
AObject = null;
} // if (AObject != null)
}
/// <summary>
/// Realiza una consulta de una sola tabla,
/// y regresa solo la columna indicada.
/// No realiza ninguna ordenacion.
/// En caso de encontrar registros que cumplan el criterio
/// de busqueda, los regresa, con excepcion del registro "de facto".
/// En caso de no encontrar registro alguno,
/// regresa la lista, solo con el registro "de facto",
/// si lo hay, o lista vacia en caso contrario.
/// </summary>
/// <param name="AParameters">Parametros para la Consulta</param>
/// <returns>Lista de registros resultante</returns>
public virtual List<Object> SingleColumnORDefault(ORMSelectParamsClass AParameters)
{
List<Object> Result = new List<Object>();
this.DoNothing();
return Result;
}
/// <summary>
/// Realiza una consulta de una sola tabla,
/// y regresa solamente dos columnas,
/// la columna de la llave primaria, y cualquier otra columna.
/// No realiza ninguna ordenacion.
/// En caso de encontrar registros que cumplan el criterio
/// de busqueda, los regresa, con excepcion del registro "de facto".
/// En caso de no encontrar registro alguno,
/// regresa la lista, solo con el registro "de facto",
/// si lo hay, o lista vacia en caso contrario.
/// </summary>
/// <param name="AParameters">Parametros para la Consulta</param>
/// <returns>Lista de Registros con par de campos llave-valor</returns>
public virtual Dictionary<Object, Object> SingleKeyValueORDefault(ORMSelectParamsClass AParameters)
{
Dictionary<Object, Object> Result = new Dictionary<Object, Object>();
this.DoNothing();
return Result;
}
/// <summary>
/// Realiza una consulta en una sola tabla,
/// regresando todas las columnas.
/// No realiza ninguna ordenacion.
/// Regresa el primer registro que aplique para el criterio de busqueda,
/// excluyendo explicitamente registro "defacto".
/// En caso de no encontrar registro alguno,
/// regresa solo el registro "de facto", si lo hay,
/// aunque no cumpla con el criterio de busqueda,
/// o lista vacia en caso contrario.
/// </summary>
/// <param name="ATableID">Identificador de la tabla</param>
/// <param name="FilterClass">Lista de Condiciones o Predicados</param>
/// <returns>Registro encontrado como lista llave-valor,
/// <code>null</code>, en caso contrario</returns>
public virtual Dictionary<string, Object> FirstORDefault(ORMSelectParamsClass AParameters)
{
Dictionary<string, Object> Result = new Dictionary<string, Object>();
if (this.IsReady())
{
this.DoNothing();
} // if (this.IsReady())
return Result;
}
/// <summary>
/// Realiza una consulta de una sola tabla,
/// regresando todas las columnas.
/// No realiza ninguna ordenacion.
/// Regresa todos los registros que apliquen para el criterio de busqueda,
/// incluyendo registro "defacto", si coincide con el criterio,
/// o excluyendolo, en caso contrario.
/// En caso de no encontrar algun registro,
/// regresa la lista vacia.
/// </summary>
/// <returns>Lista de registros resultante</returns>
public virtual List<Dictionary<string, Object>> Select(ORMSelectParamsClass AParameters)
{
List<Dictionary<string, Object>> Result = new List<Dictionary<string, object>>();
if (this.IsReady())
{
this.DoNothing();
} // if (this.IsReady())
return Result;
}
public override List<Dictionary<string, Object>> Where(ORMSelectParamsClass AParameters)
{
List<Dictionary<string, Object>> Result = new List<Dictionary<string, Object>>();
if (this.IsReady())
{
// obtener referencia a tabla, directamente
String ATableID = AParameters.TableName;
KeyValueTableClass thisTable = (KeyValueTableClass)TableByID(ATableID);
if (thisTable != null)
{
// tabla encontrada: regresar registros
Result = thisTable.Where(AParameters.Filters);
}
else
{
// no se encontro: regresar lista vacia
Result = new List<Dictionary<string, Object>>();
}
} // if (this.IsReady())
return Result;
}
public override List<Dictionary<string, Object>> Select(ORMSelectParamsClass AParameters)
{
List<Dictionary<string, Object>> Result = null;
if (this.IsReady())
{
if (!IsConnected())
{
// regresar lista vacia
Result = new List<Dictionary<string, Object>>();
}
else
{
Result = this.Database.Select(AParameters);
}
} // if (this.IsReady())
return Result;
}
public override List<Object> SingleColumn(ORMSelectParamsClass AParameters)
{
List<Object> Result = null;
if (this.IsReady())
{
string ATableID = AParameters.TableName;
// obtener referencia a tabla, directamente
KeyValueTableClass thisTable = (KeyValueTableClass)TableByID(ATableID);
if (thisTable != null)
{
// tabla encontrada: regresar registros
Result = thisTable.SelectSingle(AParameters);
}
else
{
// no se encontro: regresar lista vacia
Result = new List<Object>();
}
} // if (this.IsReady())
return Result;
}
// ...
public virtual List<Object> SelectSingle(ORMSelectParamsClass AParameters)
{
List<Object> Result = new List<Object>();
if (this.IsReady())
{
string AColumnID = AParameters.FieldName;
foreach (Dictionary<string, Object> EachRow in this.F_Rows)
{
foreach (KeyValuePair<string, Object> EachFieldValue in EachRow)
{
if (EachFieldValue.Key.Equals(AColumnID))
{
// add a copy of each value to the new row
Result.Add(EachFieldValue.Value);
break;
} // if
} // foreach
} // foreach
} // if (this.IsReady())
return Result;
}
public virtual List<Object> SelectKeyValue(ORMSelectParamsClass AParameters)
{
List<Object> Result = new List<Object>();
if (this.IsReady())
{
this.DoNothing();
} // if (this.IsReady())
return Result;
}
public override List<Dictionary<string, Object>> Where(ORMSelectParamsClass AParameters)
{
List<Dictionary<string, Object>> Result = new List<Dictionary<string, Object>>();
if (this.IsReady())
{
this.DoNothing();
} // if (this.IsReady())
return Result;
}
public override List<Object> SingleColumn(ORMSelectParamsClass AParameters)
{
List<Object> Result = null;
if (this.IsReady())
{
if (!IsConnected())
{
// regresar lista vacia
Result = new List<Object>();
}
else
{
Result = this.Database.SingleColumn(AParameters);
}
} // if (this.IsReady())
return Result;
}
