Generar las clases cliente del servicio de datos (WCF Data Services)

Un servicio de datos que implementa Open Data Protocol (OData) puede devolver un documento de metadatos del servicio que describe el modelo de datos expuesto por la fuente de OData. Para obtener más información, vea OData: documento de metadatos del servicio. Puede usar el cuadro de diálogo Agregar referencia de servicio de Visual Studio para agregar una referencia a un servicio basado en OData. Cuando se usa esta herramienta para agregar una referencia a los metadatos que se devuelven en una fuente de OData en un proyecto de cliente, realiza las acciones siguientes:

• Solicita el documento de metadatos del servicio al servicio de datos e interpreta los metadatos devueltos.

  Nota

  Los metadatos devueltos se almacenan en el proyecto de cliente como un archivo .edmx.Este archivo .edmx no se puede abrir utilizando el diseñador de Entity Data Model ya que no tiene el mismo formato que un archivo .edmx utilizado por Entity Framework.Puede ver este archivo de metadatos utilizando el editor XML o cualquier editor de texto.Para obtener más información, vea la especificación [MC-EDMX]: Entity Data Model for Data Services Packaging Format.

• Genera una representación del servicio como una clase de contenedor de entidades que hereda de DataServiceContext. Esta clase de contenedor de entidades generada es similar al contenedor de entidades generado por las herramientas de Entity Data Model. Para obtener más información, vea Object Services Overview (Entity Framework).

• Genera clases de datos para los tipos de modelo de entidad que detecta en los metadatos del servicio.

• Agrega al proyecto una referencia al ensamblado Microsoft.Data.Services.Client.dll.

  Nota

  Cuando se instale Servicios de datos de Microsoft WCF 5.0, la herramienta Agregar referencia de servicio agregará automáticamente una referencia a esta nueva versión de la biblioteca cliente en lugar de agregar una referencia a la versión System.Data.Services.Client.dll incluida en .NET Framework.Si por alguna razón necesita usar la versión anterior del cliente Servicios de datos de Microsoft WCF, debe agregar manualmente una referencia a la versión de .NET Framework de esta biblioteca.Para obtener más información, vea Cómo: Generar manualmente clases del servicio de datos del cliente (WCF Data Services).

Para obtener más información, vea Cómo: Agregar una referencia a un servicio de datos (WCF Data Services).

Las clases del servicio de datos del cliente también se pueden generar usando la herramienta DataSvcUtil.exe en el símbolo del sistema. Para obtener más información, vea Cómo: Generar manualmente clases del servicio de datos del cliente (WCF Data Services).

Asignación de tipos de datos del cliente

Cuando se usa el cuadro de diálogo Agregar referencia de servicio en Visual Studio o la herramienta DataSvcUtil.exe para generar clases de datos del cliente que se basan en una fuente de OData, los tipos de datos de .NET Framework se asignan a los tipos primitivos del modelo de datos de la siguiente forma:

Para obtener más información, vea OData: tipos de datos primitivos.

Vea también

Conceptos

Tutorial rápido (WCF Data Services)

Otros recursos

Cliente de datos (WCF Data Services)