Opciones de consulta del sistema de servicios de datos de ADO.NET

  • Artículo

Las opciones de consulta del sistema URI representan directivas que usan los servicios de datos de ADO.NET para controlar la respuesta a una solicitud. Las siguientes tablas resumen las opciones admitidas por los servicios de datos de ADO.NET.

Resumen de las opciones de consulta del sistema admitidas

Las tablas siguientes muestran y describen las opciones de consulta utilizadas por los URI de los servicios de datos de ADO.NET. Estas opciones se pueden anexar a las consultas para limitar u ordenar los resultados.

Opción Descripción

$expand

Se usa para solicitar que los conjuntos a los que hace referencia el conjunto de destino se devuelvan en línea en vez de como contenido aplazado.

$filter

Devuelve sólo los elementos del conjunto de destino que satisfacen el predicado especificado.

$orderby

Ordena el conjunto de entidades de destino en orden ascendente o descendente.

$skip

Busca n elementos en el destino y, a continuación, devuelve n+1 elementos al final del conjunto.

$top

Devuelve los n elementos superiores desde el conjunto de destino.

Si se incluye una opción de consulta con un URI en un recurso que no admita la operación, se devuelve un código de respuesta 400 Solicitud incorrecta.

Orden de la aplicación de opciones de consulta

Cuando un servicio de datos ADO.NET aplica la orden de consulta, lo hace en el orden especificado por la siguiente lista. Si falta cualquiera de las opciones, se omite el paso correspondiente.

$filter. De esta forma, se restringe el conjunto de elementos devueltos.

$orderby. De esta forma, se establece el orden de los elementos devueltos.

$skip. De esta forma, se omiten muchos elementos

$top. De esta forma, se restringe el número de elementos devueltos.

$expand. De esta forma, se devuelve el contenido relacionado con los elementos base devueltos.

http://www.example.com/service.svc/Orders?$orderby=ID&$top=10&$skip=10 de URI indica que los pedidos devueltos serán los número 11 a 21 de la lista de pedidos ordenada por sus valores de propiedad de id.

Opciones de consulta del sistema admitidas por URI

Las tablas siguientes enumeran las opciones de consulta admitidas o no por cada tipo de sintaxis de URI. A cada ejemplo de sintaxis le sigue una tabla que muestra las opciones admitidas de esa sintaxis.

URI: serviceName/<EntitySet>
Opción Admitida Notas

$expand

Sí

Devuelve un conjunto de entidades.

$filter

Sí

Devuelve un conjunto de entidades.

$orderby

Sí

Devuelve un conjunto de entidades.

$skip

Sí

Devuelve un conjunto de entidades.

$top

Sí

Devuelve un conjunto de entidades.

 
URI: serviceName/<ResourceSet>(KeyPredicate)
Opción Admitida Notas

$expand

Sí

Devuelve los recursos identificados por las condiciones especificadas, normalmente se trata de los datos de la relación con el conjunto de recursos base.

$filter

Sí

Devuelve los recursos si la condición del filtro es true; de lo contrario, se devolverá una respuesta 404 Recurso no encontrado.

$orderby

No

$skip

No

$top

No

 

URI: serviceName/<ResourceSet>(KeyPredicate)/<ResourceComplexType>
Opción Admitida Notas

$expand

Sí

Los tipos complejos siempre se expanden aunque no esté presente $expand en el URI.

$filter

Sí

Devuelve una instancia de tipo complejo si la condición del filtro es true; de lo contrario, se devolverá una respuesta 404 Recurso no encontrado.

$orderby

No

$skip

No

$top

No

 

URI: serviceName/<ResourceSet>(KeyPredicate)/<ResourceComplexType>/<ResourceProperty>
Opción Admitida Notas

$expand

Sí

Los tipos complejos siempre se expanden aunque no esté presente $expand en el URI. La propiedad del recurso no tiene propiedades propias que se puedan expandir si no es un tipo complejo.

$filter

No

$orderby

No

$skip

No

$top

No

 

URI: serviceName/<ResourceSet>(KeyPredicate)/<ResourceProperty>
Opción Admitida Notas

$expand

Sí

Los tipos complejos siempre se expanden aunque no esté presente $expand en el URI. La propiedad del recurso no tiene propiedades propias que se puedan expandir si no es un tipo complejo.

$filter

No

$orderby

No

$skip

No

$top

No

 

URI: serviceName/<Resource Set>(KeyPredicate)/<ResourceNavigationProperty>

Si la propiedad de navegación del ejemplo anterior representa una relación uno a uno o varios a uno, las opciones de consulta se describen en la siguiente tabla:

Opción Admitida Notas

$expand

Sí

Devuelve una instancia de tipo de entidad.

$filter

Sí

Devuelve una instancia de tipo de entidad.

$orderby

No

$skip

No

$top

No

Si la propiedad de navegación representa una relación uno a varios o varios a varios, las opciones de consulta se describen en la siguiente tabla:

Opción Admitida Notas

$expand

Sí

Devuelve un conjunto de entidades

$filter

Sí

Devuelve un conjunto de entidades

$orderby

Sí

Devuelve un conjunto de entidades

$skip

Sí

Devuelve un conjunto de entidades

$top

Sí

Devuelve un conjunto de entidades

Vea también

Conceptos

Opciones de consulta de los servicios de datos de ADO.NET
Parámetros de operación de servicio (marco de trabajo de los servicios de datos de ADO.NET)