TableClient.Query Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| Query<T>(String, Nullable<Int32>, IEnumerable<String>, CancellationToken) |
Consulta entidades na tabela. |
| Query<T>(Expression<Func<T,Boolean>>, Nullable<Int32>, IEnumerable<String>, CancellationToken) |
Consulta entidades na tabela. |
Query<T>(String, Nullable<Int32>, IEnumerable<String>, CancellationToken)
- Origem:
- TableClient.cs
Consulta entidades na tabela.
public virtual Azure.Pageable<T> Query<T> (string filter = default, int? maxPerPage = default, System.Collections.Generic.IEnumerable<string> select = default, System.Threading.CancellationToken cancellationToken = default) where T : class, Azure.Data.Tables.ITableEntity;abstract member Query : string * Nullable<int> * seq<string> * System.Threading.CancellationToken -> Azure.Pageable<'T (requires 'T : null and 'T :> Azure.Data.Tables.ITableEntity)> (requires 'T : null and 'T :> Azure.Data.Tables.ITableEntity)
override this.Query : string * Nullable<int> * seq<string> * System.Threading.CancellationToken -> Azure.Pageable<'T (requires 'T : null and 'T :> Azure.Data.Tables.ITableEntity)> (requires 'T : null and 'T :> Azure.Data.Tables.ITableEntity)Public Overridable Function Query(Of T As {Class, ITableEntity}) (Optional filter As String = Nothing, Optional maxPerPage As Nullable(Of Integer) = Nothing, Optional select As IEnumerable(Of String) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Pageable(Of T)Parâmetros de tipo
- T
Um tipo de modelo personalizado que implementa ITableEntity ou uma instância do TableEntity.
Parâmetros
- filter
- String
Retorna apenas entidades que atendem ao filtro OData especificado.
Por exemplo, o filtro a seguir filtraria entidades com uma PartitionKey de 'foo': "PartitionKey eq 'foo'".
O número máximo de entidades que serão retornadas por página. Se não for especificado, o valor padrão será 1000 para contas de armazenamento e não será limitado para a API de tabela do Cosmos DB. Observação: esse valor não limitará o número total de resultados se o resultado for totalmente enumerado.
- select
- IEnumerable<String>
Um IEnumerable<T> de nomes de propriedade de entidade que seleciona qual conjunto de propriedades de entidade retornar no conjunto de resultados.
Por exemplo, o seguinte valor retornaria apenas as propriedades PartitionKey e RowKey: new[] { "PartitionKey, RowKey"}.
- cancellationToken
- CancellationToken
Um CancellationToken que controla o tempo de vida da solicitação.
Retornos
Um Pageable<T> que contém uma coleção de modelos de entidade serializados como o tipo T.
Exceções
O servidor retornou um erro. Consulte Message para obter detalhes retornados do servidor.
Aplica-se a
Query<T>(Expression<Func<T,Boolean>>, Nullable<Int32>, IEnumerable<String>, CancellationToken)
- Origem:
- TableClient.cs
Consulta entidades na tabela.
public virtual Azure.Pageable<T> Query<T> (System.Linq.Expressions.Expression<Func<T,bool>> filter, int? maxPerPage = default, System.Collections.Generic.IEnumerable<string> select = default, System.Threading.CancellationToken cancellationToken = default) where T : class, Azure.Data.Tables.ITableEntity;abstract member Query : System.Linq.Expressions.Expression<Func<'T, bool>> * Nullable<int> * seq<string> * System.Threading.CancellationToken -> Azure.Pageable<'T (requires 'T : null and 'T :> Azure.Data.Tables.ITableEntity)> (requires 'T : null and 'T :> Azure.Data.Tables.ITableEntity)
override this.Query : System.Linq.Expressions.Expression<Func<'T, bool>> * Nullable<int> * seq<string> * System.Threading.CancellationToken -> Azure.Pageable<'T (requires 'T : null and 'T :> Azure.Data.Tables.ITableEntity)> (requires 'T : null and 'T :> Azure.Data.Tables.ITableEntity)Public Overridable Function Query(Of T As {Class, ITableEntity}) (filter As Expression(Of Func(Of T, Boolean)), Optional maxPerPage As Nullable(Of Integer) = Nothing, Optional select As IEnumerable(Of String) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Pageable(Of T)Parâmetros de tipo
- T
Um tipo de modelo personalizado que implementa ITableEntity ou uma instância do TableEntity.
Parâmetros
- filter
- Expression<Func<T,Boolean>>
Retorna apenas entidades que atendem à expressão de filtro especificada.
Por exemplo, a expressão a seguir filtraria entidades com uma PartitionKey de 'foo': e => e.PartitionKey == "foo".
O número máximo de entidades que serão retornadas por página. Se não for especificado, o valor padrão será 1000 para contas de armazenamento e não será limitado para a API de tabela do Cosmos DB. Observação: esse valor não limitará o número total de resultados se o resultado for totalmente enumerado.
- select
- IEnumerable<String>
Um IEnumerable<T> de nomes de propriedade de entidade que seleciona qual conjunto de propriedades de entidade retornar no conjunto de resultados.
Por exemplo, o seguinte valor retornaria apenas as propriedades PartitionKey e RowKey: new[] { "PartitionKey, RowKey"}.
- cancellationToken
- CancellationToken
Um CancellationToken que controla o tempo de vida da solicitação.
Retornos
Um Pageable<T> que contém uma coleção de modelos de entidade serializados como o tipo T.
Exceções
O servidor retornou um erro. Consulte Message para obter detalhes retornados do servidor.
Aplica-se a
Azure SDK for .NET