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


Метод Parameter.MergeXml

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

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

Синтаксис

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

returnValue = Parameter.MergeXml(xml, _
    errors, packageContents, method, _
    settingId)
public static Parameter MergeXml(
    string xml,
    out string[] errors,
    PackageContents packageContents,
    Method method,
    string settingId
)

Параметры

  • xml
    Тип: System.String

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

  • errors
    Тип: []

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

  • settingId
    Тип: System.String

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

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

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

Исключения

Исключение Условие
ArgumentNullException

Параметр method или xml — пустая ссылка (Nothing в Visual Basic).

ArgumentException

Параметр packageContents имеет значение PackageContents.Model .

MetadataObjectNotFoundException

Parameter не существует в указанном методе.

Замечания

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

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

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

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

См. также

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

Parameter класс

Элементы Parameter

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