Метод ActionParameter.MergeXml

Статья
03/09/2015

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

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

Синтаксис

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

returnValue = ActionParameter.MergeXml(xml, _
    errors, packageContents, action, _
    settingId)

public static ActionParameter MergeXml(
    string xml,
    out string[] errors,
    PackageContents packageContents,
    Action action,
    string settingId
)

Параметры

xml
Тип: System.String

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

errors
Тип: []

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

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

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

action
Тип: Microsoft.SharePoint.BusinessData.Administration.Action

Родительский Action , определенный в этом ActionParameter .

settingId
Тип: System.String

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

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

Тип: Microsoft.SharePoint.BusinessData.Administration.ActionParameter
Объединенные ActionParameter.

Исключения

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

Замечания

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

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

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

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

См. также

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

ActionParameter класс

Элементы ActionParameter

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

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