Метод Identifier.MergeXml

Статья
03/09/2015

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

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

Синтаксис

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

returnValue = Identifier.MergeXml(xml, _
    errors, packageContents, entity, _
    settingId)

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

Параметры

xml
Тип: System.String

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

errors
Тип: []

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

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

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

entity
Тип: Microsoft.SharePoint.BusinessData.Administration.Entity

Родительский внешний тип контента, определенный в Identifier .

settingId
Тип: System.String

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

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

Тип: Microsoft.SharePoint.BusinessData.Administration.Identifier
Объединенные Identifier объект.

Исключения

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

Замечания

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

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

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

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

См. также

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

Identifier класс

Элементы Identifier

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

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