Compartilhar via


ODATADetailLevel.SelectClause Propriedade

Definição

Obtém ou define a cláusula de seleção OData. Usado para recuperar apenas propriedades específicas em vez de todas as propriedades de objeto.

public string SelectClause { get; set; }
member this.SelectClause : string with get, set
Public Property SelectClause As String

Valor da propriedade

Comentários

Essa é uma cadeia de caracteres de expressão OData $select opcional (consulte a especificação OData). Se você fornecer um SelectClause, somente as propriedades listadas nessa cláusula serão preenchidas; outras propriedades têm seus valores padrão (normalmente nulos). Por exemplo, se você executar uma ListPools(DetailLevel, IEnumerable<BatchClientBehavior>) operação com um SelectClause de id,displayName, cada CloudPool uma terá suas Id propriedades e DisplayName preenchidas, mas outras propriedades como State não serão recuperadas e, portanto, terão seus valores padrão (normalmente nulos).

Se, quando uma entidade foi recuperada (por meio de uma Lista, Obter ou Atualizar), você especifique uma SelectClause que não incluiu a propriedade ou as propriedades que identificam exclusivamente o objeto (geralmente a propriedade Id, mas para Certificate as propriedades Thumbprint e ThumbprintAlgorithm, todos os métodos que acessam o serviço do Lote para recuperar dados ou executar operações falharão. Isso inclui a maioria dos métodos no objeto, incluindo Refresh(DetailLevel, IEnumerable<BatchClientBehavior>) e RefreshAsync(DetailLevel, IEnumerable<BatchClientBehavior>, CancellationToken). Você ainda pode acessar propriedades (embora somente as propriedades incluídas no SelectClause sejam preenchidas).

As seleções devem ser especificadas usando nomes de atributo da API REST, não nomes de propriedade do .NET.

O padrão não é uma expressão select, o que significa que todas as propriedades são retornadas.

Aplica-se a