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 una consulta en el servicio de datos Northwind que devuelve todos los clientes. El contexto determina automáticamente el URI del conjunto de entidades solicitado Customers . La consulta se ejecuta implícitamente cuando se produce la enumeración. El servicio de datos Northwind se crea cuando se completa 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 tiene estado, pero DataServiceContext no lo es. El estado del cliente se mantiene entre interacciones con el fin de admitir características como update management. Esta clase y la DataServiceQuery clase que representa una solicitud HTTP determinada a un servicio de datos son las dos clases principales de la biblioteca cliente.

Constructores

Nombre Description
DataServiceContext(Uri)

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

Propiedades

Nombre Description
ApplyingChanges

Obtiene un valor que indica si DataServiceContext está aplicando actualmente cambios a objetos de 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 que usa cada consulta creada mediante el DataServiceContext objeto .
DataNamespace

Obtiene o establece el espacio de nombres XML para los elementos de datos, no los elementos de metadatos, de una carga atom.
Entities

Obtiene una lista de todos los recursos que está realizando el seguimiento de .DataServiceContext
IgnoreMissingProperties

Obtiene o establece si las propiedades leídas del tipo deben asignarse a las 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 que actualmente realiza el seguimiento del DataServiceContext objeto .
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 que usa la biblioteca cliente al recibir entidades de un servicio de datos.
SaveChangesDefaultOptions

Obtiene o establece los SaveChangesOptions valores que usa el SaveChanges() método .
Timeout

Obtiene o establece la opción de tiempo de espera que se usa para la solicitud HTTP subyacente al servicio de datos.
TypeScheme

Obtiene o establece el URI usado para indicar qué esquema de tipo usa el servicio.
UsePostTunneling

Obtiene o establece un valor booleano que indica si se va a usar la tunelización posterior.

Métodos

Nombre Description
AddLink(Object, String, Object)

Agrega el vínculo especificado al conjunto de objetos que está realizando el DataServiceContext seguimiento.
AddObject(String, Object)

Agrega el objeto especificado al conjunto de objetos que realiza el DataServiceContext seguimiento.
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 sola solicitud.
AttachLink(Object, String, Object)

Notifica al objeto para iniciar el DataServiceContext seguimiento del vínculo especificado que define una relación entre objetos de entidad.
AttachTo(String, Object, String)

Notifica DataServiceContext al objeto para iniciar el seguimiento del recurso especificado y proporciona la ubicación del recurso en el conjunto de recursos especificado.
AttachTo(String, Object)

Notifica DataServiceContext a para iniciar el seguimiento del recurso especificado y proporciona la ubicación del recurso dentro del 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 siguiente página 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 espera 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 asincrónicamente los datos de propiedad binaria de la entidad especificada como un flujo de datos junto con los encabezados de mensaje especificados.
BeginLoadProperty(Object, String, AsyncCallback, Object)

Carga de forma asincrónica el valor de la propiedad especificada desde el servicio de datos.
BeginLoadProperty(Object, String, DataServiceQueryContinuation, AsyncCallback, Object)

Carga de forma asincrónica la página siguiente de entidades relacionadas desde el servicio de datos mediante 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 desde el servicio de datos mediante el URI de vínculo siguiente proporcionado.
BeginSaveChanges(AsyncCallback, Object)

Envía de forma asincrónica los cambios pendientes al servicio de datos recopilado por desde DataServiceContext 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 recopilado por desde DataServiceContext la última vez que se guardaron los cambios.
CancelRequest(IAsyncResult)

Intenta cancelar la operación asociada al objeto proporcionado IAsyncResult .
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 a los que realiza el seguimiento .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 que realiza el DataServiceContext seguimiento.
DetachLink(Object, String, Object)

Quita el vínculo especificado de la lista de vínculos a los que realiza el seguimiento .DataServiceContext
EndExecute<TElement>(IAsyncResult)

Se llama para completar .BeginExecute<TElement>(Uri, AsyncCallback, Object)
EndExecuteBatch(IAsyncResult)

Se llama para completar .BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[])
EndGetReadStream(IAsyncResult)

Se llama para completar la operación asincrónica de recuperar una propiedad binaria como una secuencia.
EndLoadProperty(IAsyncResult)

Se llama para completar la BeginLoadProperty(Object, String, AsyncCallback, Object) operación.
EndSaveChanges(IAsyncResult)

Se llama para completar la BeginSaveChanges(AsyncCallback, Object) operación.
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
Execute<T>(DataServiceQueryContinuation<T>)

Envía una solicitud al servicio de datos para recuperar la siguiente página de datos en un resultado de consulta paginada.
Execute<TElement>(Uri)

Envía una solicitud al servicio de datos para ejecutar un URI específico.
ExecuteBatch(DataServiceRequest[])

Envía un grupo de consultas como un lote al servicio de datos.
GetEntityDescriptor(Object)

Obtiene para EntityDescriptor el objeto de entidad proporcionado.
GetHashCode()

Actúa como la función hash predeterminada.

(Heredado de Object)
GetLinkDescriptor(Object, String, Object)

Obtiene para LinkDescriptor un vínculo específico que define la relación entre dos entidades.
GetMetadataUri()

Obtiene un URI de la ubicación de los metadatos .edmx.
GetReadStream(Object, DataServiceRequestArgs)

Obtiene datos de propiedad binaria para la entidad especificada como un flujo de datos junto con los encabezados de mensaje especificados.
GetReadStream(Object, String)

Obtiene los datos de propiedad binaria de la entidad especificada como un flujo de datos, con el encabezado de mensaje Accept especificado.
GetReadStream(Object)

Obtiene datos de propiedad binaria para la entidad especificada como un flujo de datos.
GetReadStreamUri(Object)

Obtiene el URI que se usa para devolver datos de propiedad binaria como un flujo de datos.
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
LoadProperty(Object, String, DataServiceQueryContinuation)

Carga la página siguiente de entidades relacionadas desde el servicio de datos mediante el objeto de continuación de consulta proporcionado.
LoadProperty(Object, String, Uri)

Carga una página de entidades relacionadas mediante el URI de vínculo siguiente proporcionado.
LoadProperty(Object, String)

Carga contenido diferido para una propiedad especificada del servicio de datos.
LoadProperty<T>(Object, String, DataServiceQueryContinuation<T>)

Carga la página siguiente de entidades relacionadas desde el servicio de datos mediante el objeto de continuación de consulta genérico proporcionado.
MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
SaveChanges()

Guarda los cambios que realiza el seguimiento en el DataServiceContext almacenamiento.
SaveChanges(SaveChangesOptions)

Guarda los cambios que realiza el seguimiento en el DataServiceContext almacenamiento.
SetLink(Object, String, Object)

Notifica a DataServiceContext que existe un nuevo vínculo entre los objetos especificados y que el vínculo se representa mediante la propiedad especificada por el sourceProperty parámetro .
SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)

Establece un nuevo flujo de datos como la propiedad binaria de una entidad, con la configuración especificada en el mensaje de solicitud.
SetSaveStream(Object, Stream, Boolean, String, String)

Establece un nuevo flujo de datos como la propiedad binaria de una entidad. Los encabezados Content-Type y Slug especificados se incluyen en el mensaje de solicitud.
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
TryGetEntity<TEntity>(Uri, TEntity)

Pruebe la recuperación de una entidad a la DataServiceContext que realiza el 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

Nombre Description
ReadingEntity

Se produce después de leer completamente los datos de entidad en el objeto de entidad.
SendingRequest

Se produce cuando se ha creado un nuevo HttpWebRequest .
WritingEntity

Se produce después de que una entidad se haya serializado completamente en XML en un mensaje de solicitud.

Se aplica a

Consulte también