QueryMethods da classe

Fornece métodos que são traduzidos em queries nativas do Realm ao usar o LINQ.

Herança

objeto

Métodos de query

namespace: Realms

Conjunto: Realm.exe

Sintaxe

public static class QueryMethods

Observações

Esses métodos não têm implementação e só podem ser usados em uma query LINQ realizada em um resultado de query do Realm - por exemplo, o IQueryable retornado por All<T>().

Métodos

Contém(cadeia de caracteres?, cadeia de caracteres, StringComparison)

Retorna um valor indicando se uma substring especificada ocorre dentro desta string.

Declaração

public static bool Contains(string? str, string value, StringComparison comparisonType)

Parâmetros

Tipo	Nome	Descrição
string	str	A cadeia original.
string	valor	A string a procurar.
Comparação de strings	comparaçãoType	Um dos valores de enumeração que determina como essa string e valor são comparados.

Devoluções

Tipo	Descrição
bool	true se o parâmetro de valor ocorrer dentro dessa string ou se o valor for a string vazia (""); caso contrário, false.

Exceções

Tipo	Condição
ArgumentNullException	Lançado quando str ou value é null.
ArgumentException	Lançado quando comparisonType não é um valor StringComparison válido.

FullTextSearch(string?, string)

Executa uma pesquisa de texto completo com "termo simples" em uma propriedade de string.

Declaração

public static bool FullTextSearch(string? str, string terms)

Parâmetros

Tipo	Nome	Descrição
string	str	A string para comparar com os termos.
string	termos	Os termos para procurar em str.

Devoluções

Tipo	Descrição
bool	true se a string corresponder aos termos; false caso contrário.

Observações

Quando esse método é usado fora de uma query de Realm, uma NotSupportedException será lançada.

Exemplos

var matches = realm.All<Book>().Where(b => b.Summary.FullTextSearch("fantasy novel"));

GeoWithin(IEmbeddedObject?, GeoShapeBase)

Verifica se geoShape contém o ponto representado por um objeto incorporado.

Declaração

public static bool GeoWithin(IEmbeddedObject? point, GeoShapeBase geoShape)

Parâmetros

Tipo	Nome	Descrição
IEmbeddedObject	Ponto	Um objeto incorporado que tem a forma de um ponto GeoJSON. Deve ter pelo menos dois campos - IList<double> coordinates e string type. A forma do objeto será verificada no tempo de execução.
GeoShapeBase	geoShape	Um dos GeoBox, GeoCircle ou GeoPolygon representando a forma em que point será verificada.

Devoluções

Tipo	Descrição
bool	true se point estiver contido em geoShape; false caso contrário.

Exemplos

Um exemplo de objeto incorporado que pode ser utilizado em query geoespaciais é:

public partial class MyGeoPoint : IEmbeddedObject
{
    [MapTo("coordinates")]
    private IList<double> Coordinates { get; } = null!;

    [MapTo("type")]
    private string Type { get; set; } = "Point";

    public double Latitude => Coordinates.Count > 1 ? Coordinates[1] : throw new Exception($"Invalid coordinate array. Expected at least 2 elements, but got: {Coordinates.Count}");

    public double Longitude => Coordinates.Count > 1 ? Coordinates[0] : throw new Exception($"Invalid coordinate array. Expected at least 2 elements, but got: {Coordinates.Count}");

    public MyGeoPoint(double latitude, double longitude)
    {
        Coordinates.Add(longitude);
        Coordinates.Add(latitude);
    }
}

Observe que, se você estiver usando a sincronização, o nome do Tipo de objeto de Realm deverá corresponder exatamente ao title do objeto incorporado definido no esquema GeoJSON no servidor.

Tipo(string?, string, bool)

Executa uma comparação "tipo" entre a string e o padrão especificados.

Declaração

public static bool Like(string? str, string pattern, bool caseSensitive = true)

Parâmetros

Tipo	Nome	Descrição
string	str	A string para comparar com o padrão.
string	padrão	O padrão para comparar.
bool	sensível a maiúsculas e minúsculas	Se definido para true , executa uma comparação sensível a maiúsculas e minúsculas.

Devoluções

Tipo	Descrição
bool	true se a string corresponder ao padrão, false caso contrário.

Observações

? e são permitidos onde ? corresponde a um único caractere e corresponde a zero ou mais caracteres, de modo que ?bc* corresponda a abcde e bbc, mas não corresponda a bcd.

Esse método de extensão pode ser usado em query LINQ em relação ao IQueryable retornado de All<T>(). Se usado fora de um contexto de query, ele usará um Regex para realizar a comparação usando as mesmas regras.