Метод Entity.MergeXml

Статья
03/09/2015

Считывает определение внешнего типа контента из указанного ресурса XML для указанного внешней системы, а затем объединяет его свойства, локализованные имена и записи управления доступом с существующего внешнего типа контента в хранилище метаданных.

Пространство имен: Microsoft.SharePoint.BusinessData.Administration
Сборка: Microsoft.SharePoint (в Microsoft.SharePoint.dll)

Синтаксис

'Декларация
Public Shared Function MergeXml ( _
    xml As String, _
    <OutAttribute> ByRef errors As String(), _
    packageContents As PackageContents, _
    lobSystem As LobSystem, _
    settingId As String _
) As Entity
'Применение
Dim xml As String
Dim errors As String()
Dim packageContents As PackageContents
Dim lobSystem As LobSystem
Dim settingId As String
Dim returnValue As Entity

returnValue = Entity.MergeXml(xml, _
    errors, packageContents, lobSystem, _
    settingId)

public static Entity MergeXml(
    string xml,
    out string[] errors,
    PackageContents packageContents,
    LobSystem lobSystem,
    string settingId
)

Параметры

xml
Тип: System.String

Строка, содержащая метаданные XML.

errors
Тип: []

Список некритических ошибок, возникающих при объединении данных или чтения XML.

packageContents
Тип: Microsoft.SharePoint.BusinessData.Parser.PackageContents

Параметры, определяющие, какие элементы для чтения.

lobSystem
Тип: Microsoft.SharePoint.BusinessData.Administration.LobSystem

Внешняя система содержит внешний тип контента для слияния.

settingId
Тип: System.String

Идентификатор секции в хранилище метаданных, который используется для хранения свойства, локализованные имена и записи управления доступом пустая ссылка (Nothing в Visual Basic) указывает параметры по умолчанию.

Возвращаемое значение

Тип: Microsoft.SharePoint.BusinessData.Administration.Entity
Объединенные внешнего типа контента.

Исключения

Исключение	Условие
ArgumentNullException	Параметр lobSystem или xml — пустая ссылка (Nothing в Visual Basic).
ArgumentException	Параметр packageContents имеет значение PackageContents.Model .
MetadataObjectNotFoundException	Внешний тип контента во внешней системе указанный не существует.

Замечания

Этот метод позволяет указать, какие ресурсы, присутствующие в заданных метаданных XML-строки должны быть добавлены в хранилище метаданных через параметр packageContents .

Если значение PackageContents.Properties , указанное в параметре packageContents , BDC создаст все свойства заданного XML в указанный параметр. Если свойство с таким именем существует, он будет заменен новое свойство. Объединение свойств требует разрешения «Правка» в указанный параметр.

Если указано значение PackageContents.LocalizedNames в параметре packageContents , BDC создаст все локализованные имена в заданный XML-данные в указанный параметр. Если локализованное имя с тем же кодом LCID, он будут заменены новым локализованное имя. Объединение локализованные имена требует разрешения «Правка» в указанный параметр.

Если указано значение PackageContents.Permissions в packageContents, BDC заменит существующие разрешения новых разрешений в заданный XML. Объединение разрешения необходимо разрешение «SetPermissions» в указанный параметр.

См. также

Справочные материалы

Entity класс

Элементы Entity

Пространство имен Microsoft.SharePoint.BusinessData.Administration

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