MSDN Library
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original

Clase DataServiceContext

DataServiceContext representa el contexto en tiempo de ejecución del servicio de datos.

System.Object
  System.Data.Services.Client.DataServiceContext

Espacio de nombres:  System.Data.Services.Client
Ensamblado:  Microsoft.Data.Services.Client (en Microsoft.Data.Services.Client.dll)

public class DataServiceContext

El tipo DataServiceContext expone los siguientes miembros.

  NombreDescripción
Método públicoDataServiceContext()Inicializa una nueva instancia de la clase DataServiceContext.
Método públicoDataServiceContext(Uri)Inicializa una nueva instancia de la clase DataServiceContext con la serviceRoot especificada.
Método públicoDataServiceContext(Uri, DataServiceProtocolVersion)Inicializa un nueva instancia de la clase DataServiceContext con la serviceRoot especificada y destinada a la maxProtocolVersion específica.
Arriba

  NombreDescripción
Propiedad públicaAddAndUpdateResponsePreferenceObtiene o establece si el cliente solicita que el servicio de datos devuelva datos de entidad en el mensaje de respuesta a una solicitud de cambio.
Propiedad públicaApplyingChangesObtiene un valor que indica si DataServiceContext está aplicando actualmente los cambios a los objetos de los que se realiza un seguimiento.
Propiedad públicaBaseUriObtiene el URI absoluto que identifica la raíz del servicio de datos de destino.
Propiedad públicaCredentialsObtiene o establece la información de autenticación usada por cada consulta creada mediante el objeto DataServiceContext.
Propiedad públicaDataNamespaceObtiene o establece el espacio de nombres XML de los elementos de datos, no de los elementos de metadatos, de una carga de Atom.
Propiedad públicaEntitiesObtiene una lista de todos los recursos cuyo seguimiento realiza actualmente DataServiceContext.
Propiedad públicaHttpStackObtiene un valor que indica el tipo de implementación HTTP que se va a usar al obtener acceso al servicio de datos.Compatible solo con el cliente de WCF Data Services 5.0 para Silverlight.
Propiedad públicaIgnoreMissingPropertiesObtiene o establece si las propiedades leídas del tipo deben asignarse a propiedades del tipo del lado cliente.
Propiedad públicaIgnoreResourceNotFoundExceptionObtiene o establece si se produce una excepción cuando el servicio de datos devuelve un error 404 (recurso no encontrado).
Propiedad públicaLinksObtiene la colección de todas las asociaciones o vínculos cuyo seguimiento realiza actualmente el objeto DataServiceContext.
Propiedad públicaMaxProtocolVersionObtiene la versión máxima de Open Data Protocol (OData) que el cliente puede usar.
Propiedad públicaMergeOptionObtiene o establece la opción de sincronización para recibir entidades de un servicio de datos.
Propiedad públicaResolveEntitySetObtiene o establece el método delegado que se usa para resolver el URI de conjunto de entidades cuando el valor no se puede determinar a partir de un URI de vínculo de edición o de vínculo a sí mismo.
Propiedad públicaResolveNameObtiene o establece una función para invalidar la estrategia de resolución de tipos predeterminada usada por la biblioteca cliente al enviar entidades a un servicio de datos.
Propiedad públicaResolveTypeObtiene o establece una función que se usa para invalidar la opción de resolución de tipos predeterminada usada por la biblioteca cliente cuando se reciben entidades de un servicio de datos.
Propiedad públicaSaveChangesDefaultOptionsObtiene o establece los valores SaveChangesOptions usados por el método SaveChanges.
Propiedad públicaTimeoutObtiene o establece la opción de tiempo de espera (en segundos) que se usa para la solicitud HTTP subyacente al servicio de datos.
Propiedad públicaTypeSchemeObtiene o establece el URI usado para indicar qué tipo de esquema usa el servicio.
Propiedad públicaUseDefaultCredentialsObtiene o establece si se usan las credenciales predeterminadas para autenticar solicitudes al servicio de datos. Compatible solo con el cliente de WCF Data Services 5.0 para Silverlight.
Propiedad públicaUsePostTunnelingObtiene o establece un valor booleano que indica si se debe usar la tunelización POST.
Arriba

  NombreDescripción
Método públicoAddLinkAgrega el vínculo especificado al conjunto de objetos cuyo seguimiento realiza DataServiceContext.
Método públicoAddObjectAgrega el objeto especificado al conjunto de objetos cuyo seguimiento realiza DataServiceContext.
Método públicoAddRelatedObjectAgrega un objeto relacionado al contexto y crea el vínculo que define la relación entre los dos objetos en una única solicitud.
Método públicoAttachLinkNotifica a DataServiceContext que empiece a realizar el seguimiento del vínculo especificado que define una relación entre los objetos de entidad.
Método públicoAttachTo(String, Object)Notifica a DataServiceContext que empiece a realizar el seguimiento del recurso especificado y proporciona la ubicación del recurso dentro del conjunto de recursos especificado.
Método públicoAttachTo(String, Object, String)Notifica a DataServiceContext que empiece a realizar el seguimiento del recurso especificado y proporciona la ubicación del recurso en el conjunto de recursos especificado.
Método públicoBeginExecute(Uri, AsyncCallback, Object, String, OperationParameter[])Envía de forma asincrónica una solicitud al servicio de datos para ejecutar un URI concreto.
Método públicoBeginExecute<TElement>(Uri, AsyncCallback, Object)Envía de forma asincrónica la solicitud para que esta llamada no bloquee el procesamiento mientras se esperan los resultados del servicio.
Método públicoBeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object)Envía de forma asincrónica una solicitud al servicio de datos para recuperar la página siguiente de datos en un resultado de consulta paginado.
Método públicoBeginExecute<TElement>(Uri, AsyncCallback, Object, String, Boolean, OperationParameter[])Envía de forma asincrónica una solicitud al servicio de datos para ejecutar un URI concreto.
Método públicoBeginExecuteBatchEnvía de forma asincrónica un grupo de consultas como un lote al servicio de datos.
Método públicoBeginGetReadStream(Object, DataServiceRequestArgs, AsyncCallback, Object)Obtiene de forma asincrónica el flujo de datos binarios que pertenece a la entidad especificada, usando los encabezados de mensaje especificados.
Método públicoBeginGetReadStream(Object, String, DataServiceRequestArgs, AsyncCallback, Object)Obtiene de forma asincrónica un flujo de datos binarios con nombre que pertenece a la entidad especificada, usando los encabezados de mensaje especificados.
Método públicoBeginLoadProperty(Object, String, AsyncCallback, Object)Carga de forma asincrónica el valor de la propiedad especificada del servicio de datos.
Método públicoBeginLoadProperty(Object, String, DataServiceQueryContinuation, AsyncCallback, Object)Carga de forma asincrónica la página siguiente de entidades relacionadas del servicio de datos usando el objeto de continuación de consulta proporcionado.
Método públicoBeginLoadProperty(Object, String, Uri, AsyncCallback, Object)Carga de forma asincrónica una página de entidades relacionadas del servicio de datos usando el URI de vínculo siguiente proporcionado.
Método públicoBeginSaveChanges(AsyncCallback, Object)Envía de forma asincrónica los cambios pendientes al servicio de datos recopilados por DataServiceContext desde la última vez que se guardaron los cambios.
Método públicoBeginSaveChanges(SaveChangesOptions, AsyncCallback, Object)Envía de forma asincrónica los cambios pendientes al servicio de datos recopilados por DataServiceContext desde la última vez que se guardaron los cambios.
Método públicoCancelRequestIntenta cancelar la operación asociada al objeto IAsyncResult proporcionado.
Método públicoCreateQuery<T>Crea una consulta de servicio de datos para los datos de un tipo genérico especificado.
Método públicoDeleteLinkCambia el estado del vínculo a eliminado en la lista de vínculos cuyo seguimiento realiza DataServiceContext.
Método públicoDeleteObjectCambia el estado del objeto especificado que se va a eliminar en DataServiceContext.
Método públicoDetachQuita la entidad de la lista de entidades de las que DataServiceContext está realizando un seguimiento.
Método públicoDetachLinkQuita el vínculo especificado de la lista de vínculos cuyo seguimiento realiza DataServiceContext.
Método públicoEndExecute(IAsyncResult)Se le llama para completar BeginExecute.
Método públicoEndExecute<TElement>(IAsyncResult)Se le llama para completar BeginExecute.
Método públicoEndExecuteBatchSe le llama para completar BeginExecuteBatch.
Método públicoEndGetReadStreamSe le llama para completar la operación asincrónica de recuperar un flujo de datos binarios.
Método públicoEndLoadPropertySe le llama para completar la operación BeginLoadProperty.
Método públicoEndSaveChangesSe le llama para completar la operación BeginSaveChanges.
Método públicoEquals (Se hereda de Object.)
Método públicoExecute(Uri, String, OperationParameter[])Envía una solicitud al servicio de datos para ejecutar un URI específico usando un método HTTP determinado.No compatible con el cliente de WCF Data Services 5.0 para Silverlight.
Método públicoExecute<TElement>(Uri)Envía una solicitud al servicio de datos para ejecutar un URI concreto.No compatible con el cliente de WCF Data Services 5.0 para Silverlight.
Método públicoExecute<T>(DataServiceQueryContinuation<T>)Envía una solicitud al servicio de datos para recuperar la página siguiente de datos en un resultado de consulta paginado.No compatible con el cliente de WCF Data Services 5.0 para Silverlight.
Método públicoExecute<TElement>(Uri, String, Boolean, OperationParameter[])Envía una solicitud al servicio de datos para ejecutar un URI específico usando un método HTTP determinado.No compatible con el cliente de WCF Data Services 5.0 para Silverlight.
Método públicoExecuteBatchEnvía de forma sincrónica un grupo de consultas como un lote al servicio de datos.No compatible con el cliente de WCF Data Services 5.0 para Silverlight.
Método protegidoFinalize (Se hereda de Object.)
Método públicoGetEntityDescriptorObtiene el EntityDescriptor del objeto de entidad proporcionado.
Método públicoGetHashCode (Se hereda de Object.)
Método públicoGetLinkDescriptorObtiene el LinkDescriptor de un vínculo concreto que define la relación entre dos entidades.
Método públicoGetMetadataUriObtiene un URI de la ubicación de los metadatos .edmx.
Método públicoGetReadStream(Object)Obtiene el flujo de datos binarios que pertenece a la entidad especificada.No compatible con el cliente de WCF Data Services 5.0 para Silverlight.
Método públicoGetReadStream(Object, DataServiceRequestArgs)Obtiene el flujo de datos binarios de la entidad especificada usando los encabezados de mensaje especificados.No compatible con el cliente de WCF Data Services 5.0 para Silverlight.
Método públicoGetReadStream(Object, String)Obtiene el flujo de datos binarios que pertenece a la entidad especificada, usando el encabezado de mensaje Content-Type especificado.No compatible con el cliente de WCF Data Services 5.0 para Silverlight.
Método públicoGetReadStream(Object, String, DataServiceRequestArgs)Obtiene un flujo de datos binarios con nombre que pertenece a la entidad especificada, usando el encabezado de mensaje Content-Type especificado.No compatible con el cliente de WCF Data Services 5.0 para Silverlight.
Método públicoGetReadStreamUri(Object)Obtiene el URI que se emplea para devolver un flujo de datos binarios.
Método públicoGetReadStreamUri(Object, String)Obtiene el URI que se usa para devolver un flujo de datos binarios con nombre.
Método públicoGetType (Se hereda de Object.)
Método públicoLoadProperty(Object, String)Carga el contenido aplazado de una propiedad especificada desde el servicio de datos.No compatible con el cliente de WCF Data Services 5.0 para Silverlight.
Método públicoLoadProperty(Object, String, DataServiceQueryContinuation)Carga la página siguiente de entidades relacionadas del servicio de datos usando el objeto de continuación de consulta proporcionado.No compatible con el cliente de WCF Data Services 5.0 para Silverlight.
Método públicoLoadProperty(Object, String, Uri)Carga una página de entidades relacionadas usando el URI de vínculo siguiente proporcionado.No compatible con el cliente de WCF Data Services 5.0 para Silverlight.
Método públicoLoadProperty<T>(Object, String, DataServiceQueryContinuation<T>)Carga la página siguiente de entidades relacionadas del servicio de datos usando el objeto de continuación de consulta genérico proporcionado.No compatible con el cliente de WCF Data Services 5.0 para Silverlight.
Método protegidoMemberwiseClone (Se hereda de Object.)
Método públicoSaveChanges()Guarda los cambios de los que DataServiceContext realiza un seguimiento.No compatible con el cliente de WCF Data Services 5.0 para Silverlight.
Método públicoSaveChanges(SaveChangesOptions)Guarda los cambios de los que DataServiceContext realiza un seguimiento.No compatible con el cliente de WCF Data Services 5.0 para Silverlight.
Método públicoSetLinkNotifica a DataServiceContext que existe un nuevo vínculo entre los objetos especificados y que la propiedad especificada por el parámetro sourceProperty representa el vínculo.
Método públicoSetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)Establece un flujo de datos binarios para la entidad especificada, con los encabezados especificados en el mensaje de solicitud.
Método públicoSetSaveStream(Object, Stream, Boolean, String, String)Establece un flujo de datos binarios que pertenece a la entidad especificada, con los encabezados Content-Type y Slug especificados en el mensaje de solicitud.
Método públicoSetSaveStream(Object, String, Stream, Boolean, DataServiceRequestArgs)Establece un flujo de datos binarios con nombre que pertenece a la entidad especificada, con los encabezados especificados en el mensaje de solicitud.
Método públicoSetSaveStream(Object, String, Stream, Boolean, String)Establece un flujo de datos binarios para la entidad especificada.
Método públicoToString (Se hereda de Object.)
Método públicoTryGetEntity<TEntity>Prueba la recuperación de una entidad de la que DataServiceContext realiza un seguimiento por referencia al URI de la entidad.
Método públicoTryGetUriRecupera el URI canónico asociado a la entidad especificada, si está disponible.
Método públicoUpdateObjectCambia el estado del objeto especificado en DataServiceContext a Modified.
Arriba

  NombreDescripción
Evento públicoReadingEntitySe produce una vez leídos completamente los datos de la entidad en el objeto de entidad.
Evento públicoSendingRequestSe produce cuando se ha creado una nueva HttpWebRequest.
Evento públicoSendingRequest2Se produce cuando se ha creado una nueva HttpWebRequest.
Evento públicoWritingEntitySe produce una vez serializada totalmente una entidad en XML en un mensaje de solicitud.
Arriba

Servicios de datos de Microsoft WCF son sin estado, pero DataServiceContext no lo es. El estado del cliente se mantiene entre las interacciones para admitir características como la administración de actualizaciones. Esta clase, y la clase DataServiceQuery que representa una solicitud HTTP determinada a un servicio de datos, son las dos clases principales de la biblioteca cliente.

En el ejemplo siguiente se muestra cómo usar el DataServiceContext generado por la herramienta Agregar referencia de servicio para ejecutar implícitamente en el servicio de datos de Northwind una consulta que devuelve todos los clientes. El contexto determina automáticamente el URI del conjunto de entidades Customers solicitado. La consulta se ejecuta implícitamente cuando se produce la enumeración. El servicio de datos Northwind se crea cuando se completa el tutorial rápido de Servicios de datos de Microsoft WCF.

// Create the DataServiceContext using the service URI.
NorthwindEntities context = new NorthwindEntities(svcUri);

// Define a new query for Customers.
DataServiceQuery<Customer> query = context.Customers;

try
{
    // Enumerate over the query result, which is executed implicitly.
    foreach (Customer customer in query)
    {
        Console.WriteLine("Customer Name: {0}", customer.CompanyName);
    }
}
catch (DataServiceQueryException ex)
{
    throw new ApplicationException(
        "An error occurred during query execution.", ex);
}


Cualquier miembro público static (Shared en Visual Basic) de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Adiciones de comunidad

Mostrar:
© 2016 Microsoft