Экспорт (0) Печать
Развернуть все
Данная статья переведена автоматически. Наведите указатель мыши на предложения статьи, чтобы просмотреть исходный текст. Дополнительные сведения.
Перевод
Текст оригинала

DataServiceContext - класс

Класс DataServiceContext представляет контекст среды выполнения службы данных.

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

Пространство имен:  System.Data.Services.Client
Сборка:  System.Data.Services.Client (в System.Data.Services.Client.dll)

public class DataServiceContext

Тип DataServiceContext предоставляет следующие члены.

  ИмяОписание
Открытый методDataServiceContextВыполняет инициализацию нового экземпляра класса DataServiceContext с заданным объектом serviceRoot.
В начало страницы

  ИмяОписание
Открытое свойствоApplyingChangesПолучает значение, которое указывает, применяет ли контекст DataServiceContext изменения к отслеживаемым объектам.
Открытое свойствоBaseUriВозвращает абсолютный универсальный код ресурса (URI), идентифицирующий корень целевой службы данных.
Открытое свойствоCredentialsПолучает или задает сведения о проверке подлинности, которые используются для каждого запроса, созданного посредством объекта DataServiceContext.
Открытое свойствоDataNamespaceВозвращает или задает пространство имен XML для элементов данных (но не элементов метаданных) полезной нагрузки Atom.
Открытое свойствоEntitiesВозвращает список ресурсов, отслеживаемых в данный момент объектом DataServiceContext.
Открытое свойствоIgnoreMissingPropertiesВозвращает или задает значение, указывающее, следует ли сопоставить прочитанные из типа свойства свойствам типа клиентской стороны.
Открытое свойствоIgnoreResourceNotFoundExceptionПолучает или задает возникновение или невозникновение исключения при возвращении службой данных ошибки 404 ("ресурс не найден").
Открытое свойствоLinksПолучает коллекцию всех ассоциаций или ссылок, отслеживаемых в данный момент объектом DataServiceContext.
Открытое свойствоMergeOptionВозвращает или задает параметр синхронизации для получения сущностей от службы данных.
Открытое свойствоResolveNameПолучает или задает функцию, применяемую для замены стратегии выбора типов, которая используется по умолчанию клиентской библиотекой при отправке сущностей службе данных.
Открытое свойствоResolveTypeПолучает или задает функцию, применяемую для замены параметра выбора типов, который используется по умолчанию клиентской библиотекой при получении сущностей от службы данных.
Открытое свойствоSaveChangesDefaultOptionsПолучает или задает значения SaveChangesOptions, используемые методом SaveChanges.
Открытое свойствоTimeoutПолучает или задает параметр времени ожидания, используемый при отправке базового HTTP-запроса службе данных.
Открытое свойствоTypeSchemeВозвращает или задает URI, используемый для указания типа схемы, используемой службой.
Открытое свойствоUsePostTunnelingВозвращает или задает логическое значение, которое указывает, следует ли использовать POST-туннелирование.
В начало страницы

  ИмяОписание
Открытый методAddLinkДобавляет заданную ссылку в набор объектов, отслеживаемых объектом DataServiceContext.
Открытый методAddObjectДобавляет заданный объект в набор объектов, отслеживаемых объектом DataServiceContext.
Открытый методAddRelatedObjectДобавляет связанный объект в контекст и создает ссылку, определяющую отношение между двумя объектами в рамках одного запроса.
Открытый методAttachLinkУведомляет DataServiceContext о необходимости начать отслеживание заданной ссылки, определяющей отношение между объектами сущности.
Открытый методAttachTo(String, Object)Уведомляет DataServiceContext о необходимости начать отслеживание заданного ресурса и указывает расположение ресурса в заданном наборе ресурсов.
Открытый методAttachTo(String, Object, String)Уведомляет объект DataServiceContext о необходимости начать отслеживание заданного ресурса и указывает местоположение ресурса в заданном наборе ресурсов.
Открытый методBeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object)Асинхронно отправляет службе данных запрос об извлечении следующей страницы данных в результатах запроса с постраничным выводом.
Открытый методBeginExecute<TElement>(Uri, AsyncCallback, Object)Асинхронно направляет запрос, чтобы этот вызов не блокировал обработку на время ожидания результатов от службы.
Открытый методBeginExecuteBatchАсинхронно передает группу запросов в виде пакета службе данных.
Открытый методBeginGetReadStreamВыполняет асинхронное возвращение двоичных данных свойств для указанной сущности в виде потока данных (включая заголовки заданного сообщения).
Открытый методBeginLoadProperty(Object, String, AsyncCallback, Object)Выполняет асинхронную загрузку значения заданного свойства из службы данных.
Открытый методBeginLoadProperty(Object, String, DataServiceQueryContinuation, AsyncCallback, Object)Выполняет асинхронную загрузку следующей страницы связанных сущностей из службы данных посредством предоставленного объекта продолжения запроса.
Открытый методBeginLoadProperty(Object, String, Uri, AsyncCallback, Object)Выполняет асинхронную загрузку страницы связанных сущностей из службы данных посредством предоставленного универсального кода ресурса следующей ссылки.
Открытый методBeginSaveChanges(AsyncCallback, Object)Асинхронно передает в службу данных ожидающие изменения, собранные контекстом DataServiceContext с момента последнего сохранения изменений.
Открытый методBeginSaveChanges(SaveChangesOptions, AsyncCallback, Object)Асинхронно передает в службу данных ожидающие изменения, собранные контекстом DataServiceContext с момента последнего сохранения изменений.
Открытый методCancelRequestПытается отменить операцию, связанную с предоставленным объектом IAsyncResult.
Открытый методCreateQuery<T>Создает запрос к службе данных на получение данных определенного универсального типа.
Открытый методDeleteLinkИзменяет состояние ссылки на удаленное в списке ссылок, отслеживаемых объектом DataServiceContext.
Открытый методDeleteObjectИзменяет состояние заданного объекта на удаленное в DataServiceContext.
Открытый методDetachУдаляет сущность из списка сущностей, отслеживаемых объектом DataServiceContext.
Открытый методDetachLinkУдаляет заданную ссылку из списка ссылок, отслеживаемых объектом DataServiceContext.
Открытый методEndExecute<TElement>Вызывается для завершения метода BeginExecute.
Открытый методEndExecuteBatchВызывается для завершения вызова метода BeginExecuteBatch.
Открытый методEndGetReadStreamВызывается для завершения асинхронной операции извлечения двоичного свойства в виде потока.
Открытый методEndLoadPropertyВызывается для завершения операции BeginLoadProperty.
Открытый методEndSaveChangesВызывается для завершения операции BeginSaveChanges.
Открытый методEquals(Object)Определяет, равен ли заданный объект текущему объекту. (Унаследовано от Object.)
Открытый методExecute<T>(DataServiceQueryContinuation<T>)Отправляет службе данных запрос об извлечении следующей страницы данных в результатах запроса с постраничным выводом.
Открытый методExecute<TElement>(Uri)Отправляет службе данных запрос о выполнении заданного URI.
Открытый методExecuteBatchПередает группу запросов в виде пакета службе данных.
Защищенный методFinalize Позволяет объекту попытаться освободить ресурсы и выполнить другие операции очистки, перед тем как объект будет утилизирован в процессе сборки мусора. (Унаследовано от Object.)
Открытый методGetEntityDescriptorПолучает объект EntityDescriptor для предоставленного объекта сущности.
Открытый методGetHashCode Играет роль хэш-функции для определённого типа.
(Унаследовано от Object.)
Открытый методGetLinkDescriptorПолучает дескриптор LinkDescriptor для заданной ссылки, определяющей отношение между двумя сущностями.
Открытый методGetMetadataUriВозвращает универсальный код ресурса (URI) местоположения EDMX-файла метаданных.
Открытый методGetReadStream(Object)Получает двоичные данные свойств для указанной сущности в виде потока данных.
Открытый методGetReadStream(Object, DataServiceRequestArgs)Получает двоичные данные свойств для указанной сущности в виде потока данных (включая заголовки заданного сообщения).
Открытый методGetReadStream(Object, String)Получает двоичные данные свойств для указанной сущности в виде потока данных (включая заголовок заданного сообщения Accept).
Открытый методGetReadStreamUriПолучает универсальный код ресурса, используемый для возвращения двоичных данных свойств в виде потока данных.
Открытый методGetTypeВозвращает объект Type для текущего экземпляра. (Унаследовано от Object.)
Открытый методLoadProperty(Object, String)Загружает отложенное содержимое для заданного свойства из службы данных.
Открытый методLoadProperty(Object, String, DataServiceQueryContinuation)Выполняет загрузку следующей страницы связанных сущностей из службы данных посредством предоставленного объекта продолжения запроса.
Открытый методLoadProperty(Object, String, Uri)Загружает страницу связанных сущностей посредством предоставленного универсального кода ресурса следующей ссылки.
Открытый методLoadProperty<T>(Object, String, DataServiceQueryContinuation<T>)Выполняет загрузку следующей страницы связанных сущностей из службы данных посредством предоставленного универсального объекта продолжения запроса.
Защищенный методMemberwiseClone Создает неполную копию текущего объекта Object. (Унаследовано от Object.)
Открытый методSaveChanges()Сохраняет изменения, отслеживаемые объектом DataServiceContext, в хранилище.
Открытый методSaveChanges(SaveChangesOptions)Сохраняет изменения, отслеживаемые объектом DataServiceContext, в хранилище.
Открытый методSetLinkУведомляет DataServiceContext о существовании новой ссылки между заданными объектами, представленной свойством, заданным параметром sourceProperty.
Открытый методSetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)Назначает новый поток данных двоичным свойством какой-либо сущности с учетом параметров, указанных в сообщении запроса.
Открытый методSetSaveStream(Object, Stream, Boolean, String, String)Назначает новый поток данных двоичным свойством какой-либо сущности. Указанные заголовки Content-Type и Slug включены в сообщение запроса.
Открытый методToStringВозвращает строку, представляющую текущий объект. (Унаследовано от Object.)
Открытый методTryGetEntity<TEntity>Тестовое извлечение сущности, отслеживаемой объектом DataServiceContext, по ссылке на универсальный код ресурса (URI) этой сущности.
Открытый методTryGetUriИзвлекает канонический URI, связанный с заданной сущностью, если таковой имеется.
Открытый методUpdateObjectИзменяет состояние заданного объекта в DataServiceContext на Modified.
В начало страницы

  ИмяОписание
Открытое событиеReadingEntityВозникает после окончательной передачи данных сущности объекту сущности.
Открытое событиеSendingRequestВозникает при создании нового объекта HttpWebRequest.
Открытое событиеWritingEntityВозникает после полной сериализации сущности в XML в составе сообщения запроса.
В начало страницы

У Службы данных WCF нет состояний, а у DataServiceContext есть. Состояние на клиенте сохраняется между двумя взаимодействиями для поддержки таких функций, как управление обновлениями. Данный класс и класс DataServiceQuery, представляющие определенный HTTP-запрос к службе данных, являются двумя важнейшими классами в клиентской библиотеке.

В следующем примере демонстрируется использование DataServiceContext, созданного инструментом «Добавить ссылку на службу» для неявного выполнения запроса в отношении службы данных «Борей», будут возвращены все клиенты. Универсальный код ресурса (URI) запрашиваемого набора сущностей Customers определяется автоматически контекстом. Запрос выполняется неявно при перечислении. Служба данных Northwind создается при выполнении краткого руководства по Службы данных 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);
}


.NET Framework

Поддерживается в версиях: 4.5.2, 4.5.1, 4.5, 4, 3.5 с пакетом обновления 1 (SP1)

.NET Framework (клиентский профиль)

Поддерживается в версиях: 4, 3.5 с пакетом обновления 1 (SP1)

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista с пакетом обновления 2 (SP2), Windows Server 2008 (роль основных серверных компонентов не поддерживается), Windows Server 2008 R2 (роль основных серверных компонентов поддерживается в пакете обновления 1 (SP1) или выше; системы на базе Itanium не поддерживаются)

.NET Framework поддерживает не все версии каждой платформы. Поддерживаемые версии перечислены в разделе Требования к системе для .NET Framework.

Любые открытые члены этого типа, объявленные как static (Shared в Visual Basic), являются потокобезопасными. Потокобезопасность членов экземпляров не гарантируется.

Добавления сообщества

ДОБАВИТЬ
Показ:
© 2014 Microsoft