Поделиться через

Элемент MethodInstance в элементе MethodInstances (схема BDCMetadata)

  • Статья

Дата последнего изменения: 16 апреля 2010 г.

Применимо к: SharePoint Server 2010

Задает объект MethodInstance.

Пространство имен: https://schemas.microsoft.com/windows/2007/BusinessDataCatalog

Схема: BDCMetadata

Следующие два случая в модели BDC приводят к возникновению InvalidOperationException во время выполнения:

  • Два экземпляра метода SpecificFinder, возвращающие одинаковые наборы полей.

  • Два экземпляра метода SpecificFinder, имеющие одинаковое число полей, совпадающее с числом полей другого экземпляра метода, такого как Finder.

<MethodInstance Type = "String" Default = "Boolean" ReturnParameterName = "String" ReturnTypeDescriptorName = "String" ReturnTypeDescriptorLevel = "Integer" Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </MethodInstance>

Атрибуты и элементы

В следующих разделах приводится описание атрибутов, дочерних и родительских элементов.

Атрибуты

Атрибут

Описание

Тип

Обязательный атрибут.

Указывает тип MethodInstance.

В следующей таблице приведен список возможных значений этого атрибута.

Значение

Описание

Finder

Тип MethodInstance, который можно вызывать для возврата коллекции из нуля или нескольких экземпляров EntityInstances конкретной сущности Entity. Входные параметры для метода Finder определяются в дескрипторах FilterDescriptors, которые находятся в методе Method, содержащем Finder.

SpecificFinder

Тип MethodInstance, который можно вызывать для возврата конкретного экземпляра EntityInstance конкретной сущности Entity по его идентификатору EntityInstanceId. Входные параметры для метода SpecificFinder определяются и упорядочиваются в коллекции Identifiers, которая связана с сущностью Entity.

GenericInvoker

Тип MethodInstance, который можно вызывать для выполнения конкретной задачи во внешней системе. Входные и выходные параметры для метода GenericInvoker задаются конкретно для метода Method.

IdEnumerator

Тип MethodInstance, который может быть вызван для возврата значений Field, представляющих идентификацию EntityInstances определенной Entity. Входные данные IdEnumerator определяются FilterDescriptors, содержащимся в методе, который содержит IdEnumerator для получения списка идентификаторов, являющихся уникальными ключами для каждой сущности, в которой требуется возможность поиска. Этот экземпляр метода обеспечивает возможность поиска внешних данных в Microsoft SharePoint Server 2010.

ChangedIdEnumerator

Тип MethodInstance, который можно вызывать для извлечения идентификаторов EntityInstanceIds экземпляров EntityInstances, которые были изменены во внешней системе по истечении заданного времени.

DeletedIdEnumerator

Тип MethodInstance, который можно вызывать для извлечения идентификаторов EntityInstanceIds экземпляров EntityInstances, которые были удалены из внешней системы по истечении заданного времени.

Scalar

MethodInstance, возвращающий одно значение, который можно вызывать во внешней системе. Например, скалярный экземпляр метода можно использовать для получения данных о всех продажах на определенную дату из внешней системы. Коллекция Entities может быть пустой или содержать несколько скалярных экземпляров метода.

AccessChecker

Тип MethodInstance, который можно вызывать для извлечения разрешений, имеющихся у вызывающего участника безопасности для каждой коллекции экземпляров EntityInstances, определенных в заданной коллекции EntityInstanceIds.

Creator

Тип MethodInstance, который можно вызывать для создания экземпляра EntityInstance. Набор полей, необходимых для создания EntityInstance, называется представлением средства создания.

Deleter

Тип MethodInstance, который можно вызывать для удаления экземпляра EntityInstance с указанным идентификатором EntityInstanceId.

Updater

Тип MethodInstance, который можно вызывать для обновления экземпляра EntityInstance с указанным идентификатором EntityInstanceId. Набор полей, необходимых для обновления EntityInstance, называется представлением средства обновления. Набор полей, значения которых следует передавать до их изменения, называется представлением средства подготовки к обновлению.

StreamAccessor

Метод MethodInstance, который можно вызывать для извлечения поля экземпляра EntityInstance в виде байтового потока данных.

BinarySecurityDescriptorAccessor

Тип MethodInstance, который можно вызывать для извлечения последовательности байтов из внешней системы. Байтовая последовательность из конкретной системы описывает набор участников безопасности и связанные разрешения, имеющиеся у каждого участника безопасности для экземпляра EntityInstance с указанным идентификатором EntityInstanceId.

BulkSpecificFinder

Тип MethodInstance, который можно вызывать для возврата набора определенных экземпляров EntityInstances сущности Entity по набору соответствующих идентификаторов EntityInstanceIds.

BulkIdEnumerator

Тип MethodInstance, который можно вызывать для извлечения минимальных сведений о внешних элементах, соответствующих заданным удостоверениям. Этот экземпляр метода может использоваться для оптимизации синхронизации данных в кэше. Этот метод должен возвращать только удостоверения и сведения о версии для внешних элементов, соответствующих заданным удостоверениям Identities, которые вызывающее приложение может сравнивать с локальной версией для определения наличия изменений. В этом случае вызывающее приложение может запрашивать измененные внешние элементы с целью обновления данных в кэше.

Default

Необязательный атрибут.

Указывает, используется ли MethodInstance по умолчанию из всех MethodInstances такого типа во вмещающем внешнем типе контента (Entity).

Значение по умолчанию: false

Тип атрибута: Boolean

ReturnParameterName

Необязательный атрибут.

Имя Parameter, содержащего ReturnTypeDescriptor для MethodInstance. Атрибут Direction для Parameter должен быть атрибутом ParameterDirection со значением Out, InOut или Return.

Этот атрибут должен быть задан для всех типов MethodInstances, кроме GenericInvoker, Creator, Deleter и Updater.

Тип атрибута: String

ReturnTypeDescriptorLevel

Необязательный атрибут.

Этот метод устарел. Используйте вместо него ReturnTypeDescriptorPath.

Тип атрибута: Integer

ReturnTypeDescriptorPath

Необязательный атрибут.

Путь с точками к TypeDescriptor сопоставления.

Тип атрибута: String

Имя

Обязательный атрибут.

Указывает имя MethodInstance.

Тип атрибута: String

DefaultDisplayName

Необязательный атрибут.

Указывает отображаемое имя по умолчанию для MethodInstance.

Тип атрибута: String

IsCached

Необязательный атрибут.

Указывает, часто ли используется этот экземпляр MethodInstance.

Значение по умолчанию: true

Тип атрибута: Boolean

Дочерние элементы

Элемент

Описание

Элемент LocalizedDisplayNames в MetadataObject (схема BDCMetadata)

Локализованные отображаемые имена MethodInstance.

Элемент Properties в элементе MetadataObject (схема BDCMetadata)

Свойства MethodInstance.

Элемент AccessControlList (схема BDCMetadata)

Списки управления доступом (ACL) для MethodInstance.

Родительские элементы

Элемент

Описание

Элементы "экземпляры метода" в методе (схема BDCMetadata)

Элемент MethodInstances, содержащий этот MethodInstance.