DataServiceContext Clase

Definición

Espacio de nombres:

System.Data.Services.Client

Ensamblado:

System.Data.Services.Client.dll

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

public ref class DataServiceContext

public class DataServiceContext

type DataServiceContext = class

Public Class DataServiceContext

Herencia

Object

DataServiceContext

Ejemplos

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 al completar el WCF Data Services .

// 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);
}

' Create the DataServiceContext using the service URI.
Dim context = New NorthwindEntities(svcUri)

' Define a new query for Customers.
Dim query As DataServiceQuery(Of Customer) = context.Customers

Try
    ' Enumerate over the query result, which is executed implicitly.
    For Each customer As Customer In query
        Console.WriteLine("Customer Name: {0}", customer.CompanyName)
    Next
Catch ex As DataServiceQueryException
    Throw New ApplicationException( _
            "An error occurred during query execution.", ex)
End Try

Comentarios

WCF Data Services no tienen 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.

Constructores

DataServiceContext(Uri)

Inicializa una nueva instancia de la clase DataServiceContext con el objeto serviceRoot especificado.

Propiedades

ApplyingChanges	Obtiene un valor que indica si DataServiceContext está aplicando actualmente los cambios a los objetos de los que se realiza un seguimiento.
BaseUri	Obtiene el URI absoluto que identifica la raíz del servicio de datos de destino.
Credentials	Obtiene o establece la información de autenticación usada por cada consulta creada mediante el objeto DataServiceContext.
DataNamespace	Obtiene o establece el espacio de nombres XML de los elementos de datos, no de los elementos de metadatos, de una carga de Atom.
Entities	Obtiene una lista de todos los recursos cuyo seguimiento realiza actualmente DataServiceContext.
IgnoreMissingProperties	Obtiene o establece si las propiedades leídas del tipo deben asignarse a propiedades del tipo del lado cliente.
IgnoreResourceNotFoundException	Obtiene o establece si se produce una excepción cuando el servicio de datos devuelve un error 404 (recurso no encontrado).
Links	Obtiene la colección de todas las asociaciones o vínculos cuyo seguimiento realiza actualmente el objeto DataServiceContext.
MergeOption	Obtiene o establece la opción de sincronización para recibir entidades de un servicio de datos.
ResolveName	Obtiene 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.
ResolveType	Obtiene 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.
SaveChangesDefaultOptions	Obtiene o establece los valores SaveChangesOptions usados por el método SaveChanges().
Timeout	Obtiene o establece la opción de tiempo de espera que se usa en la solicitud HTTP subyacente al servicio de datos.
TypeScheme	Obtiene o establece el URI usado para indicar qué tipo de esquema usa el servicio.
UsePostTunneling	Obtiene o establece un valor booleano que indica si se debe usar la tunelización POST.

Métodos

AddLink(Object, String, Object)	Agrega el vínculo especificado al conjunto de objetos cuyo seguimiento realiza DataServiceContext.
AddObject(String, Object)	Agrega el objeto especificado al conjunto de objetos cuyo seguimiento realiza DataServiceContext.
AddRelatedObject(Object, String, Object)	Agrega un objeto relacionado al contexto y crea el vínculo que define la relación entre los dos objetos en una única solicitud.
AttachLink(Object, String, Object)	Notifica a DataServiceContext que empiece a realizar el seguimiento del vínculo especificado que define una relación entre los objetos de entidad.
AttachTo(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.
AttachTo(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.
BeginExecute<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.
BeginExecute<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.
BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[])	Envía de forma asincrónica un grupo de consultas como un lote al servicio de datos.
BeginGetReadStream(Object, DataServiceRequestArgs, AsyncCallback, Object)	Obtiene de manera asincrónica los datos de propiedad binarios de la entidad especificada como un flujo de datos junto con los encabezados del mensaje especificados.
BeginLoadProperty(Object, String, AsyncCallback, Object)	Carga de forma asincrónica el valor de la propiedad especificada del servicio de datos.
BeginLoadProperty(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.
BeginLoadProperty(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.
BeginSaveChanges(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.
BeginSaveChanges(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.
CancelRequest(IAsyncResult)	Intenta cancelar la operación asociada al objeto IAsyncResult proporcionado.
CreateQuery<T>(String)	Crea una consulta de servicio de datos para los datos de un tipo genérico especificado.
DeleteLink(Object, String, Object)	Cambia el estado del vínculo a eliminado en la lista de vínculos cuyo seguimiento realiza DataServiceContext.
DeleteObject(Object)	Cambia el estado del objeto especificado que se va a eliminar en DataServiceContext.
Detach(Object)	Quita la entidad de la lista de entidades de las que DataServiceContext está realizando un seguimiento.
DetachLink(Object, String, Object)	Quita el vínculo especificado de la lista de vínculos cuyo seguimiento realiza DataServiceContext.
EndExecute<TElement>(IAsyncResult)	Se le llama para completar BeginExecute<TElement>(Uri, AsyncCallback, Object).
EndExecuteBatch(IAsyncResult)	Se le llama para completar BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[]).
EndGetReadStream(IAsyncResult)	Se invoca para completar la operación asincrónica de recuperación de una propiedad binaria en forma de flujo.
EndLoadProperty(IAsyncResult)	Se le llama para completar la operación BeginLoadProperty(Object, String, AsyncCallback, Object).
EndSaveChanges(IAsyncResult)	Se le llama para completar la operación BeginSaveChanges(AsyncCallback, Object).
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
Execute<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.
Execute<TElement>(Uri)	Envía una solicitud al servicio de datos para ejecutar un URI concreto.
ExecuteBatch(DataServiceRequest[])	Envía un grupo de consultas como un lote al servicio de datos.
GetEntityDescriptor(Object)	Obtiene el EntityDescriptor del objeto entidad proporcionado.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetLinkDescriptor(Object, String, Object)	Obtiene el LinkDescriptor de un vínculo concreto que define la relación entre dos entidades.
GetMetadataUri()	Obtiene un URI de la ubicación de los metadatos .edmx.
GetReadStream(Object)	Obtiene los datos de las propiedades binarias de la entidad especificada como un flujo de datos.
GetReadStream(Object, DataServiceRequestArgs)	Obtiene los datos de propiedad binarios de la entidad especificada como un flujo de datos junto con los encabezados del mensaje especificados.
GetReadStream(Object, String)	Obtiene los datos de propiedad binarios de la entidad especificada como un flujo de datos junto con el encabezado del mensaje Accept.
GetReadStreamUri(Object)	Obtiene el identificador URI que se usa para devolver los datos de propiedad binarios en forma de flujo de datos.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
LoadProperty(Object, String)	Carga el contenido aplazado de una propiedad especificada desde el servicio de datos.
LoadProperty(Object, String, DataServiceQueryContinuation)	Carga la página siguiente de entidades relacionadas del servicio de datos usando el objeto de continuación de consulta proporcionado.
LoadProperty(Object, String, Uri)	Carga una página de entidades relacionadas usando el URI de vínculo siguiente proporcionado.
LoadProperty<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.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
SaveChanges()	Guarda los cambios de los que DataServiceContext realiza un seguimiento.
SaveChanges(SaveChangesOptions)	Guarda los cambios de los que DataServiceContext realiza un seguimiento.
SetLink(Object, String, Object)	Notifica 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.
SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)	Establece un nuevo flujo de datos como propiedad binaria de una entidad, con los valores especificados en el mensaje de solicitud.
SetSaveStream(Object, Stream, Boolean, String, String)	Establece un nuevo flujo de datos como propiedad binaria de una entidad. Los encabezados Content-Type y Slug se incluyen en el mensaje de solicitud.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
TryGetEntity<TEntity>(Uri, TEntity)	Prueba la recuperación de una entidad de la que DataServiceContext realiza un seguimiento por referencia al URI de la entidad.
TryGetUri(Object, Uri)	Recupera el URI canónico asociado a la entidad especificada, si está disponible.
UpdateObject(Object)	Cambia el estado del objeto especificado en DataServiceContext a Modified.

Eventos

ReadingEntity	Se produce una vez leídos completamente los datos de la entidad en el objeto entidad.
SendingRequest	Se produce cuando se ha creado una nueva HttpWebRequest.
WritingEntity	Se produce una vez serializada totalmente una entidad en XML en un mensaje de solicitud.

Consulte también

• Trabajar con bibliotecas cliente de .NET Framework (WCF Data Services)