LobSystem.MergeXml Method (String, String , PackageContents, AdministrationMetadataCatalog, String)

Reads the external system definition from the specified XML resource for the specified Metadata Store in the specified partition, and merges its properties, localized names, and access control entries into the current external system in the Metadata Store.

Namespace:  Microsoft.SharePoint.BusinessData.Administration.Client
Assembly:  Microsoft.SharePoint.BusinessData.Administration.Client (in Microsoft.SharePoint.BusinessData.Administration.Client.dll)

Syntax

'Declaration
Public Shared Function MergeXml ( _
    xml As String, _
    <OutAttribute> ByRef errors As String(), _
    packageContents As PackageContents, _
    metadataCatalog As AdministrationMetadataCatalog, _
    settingId As String _
) As LobSystem
'Usage
Dim xml As String
Dim errors As String()
Dim packageContents As PackageContents
Dim metadataCatalog As AdministrationMetadataCatalog
Dim settingId As String
Dim returnValue As LobSystem

returnValue = LobSystem.MergeXml(xml, _
    errors, packageContents, metadataCatalog, _
    settingId)

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

Parameters

• xml
  Type: System.String

  The XML metadata to merge.

• errors
  Type: []

  When this method returns, contains a list of noncritical errors that occurred when merging data or reading the XML. This parameter is passed uninitialized.

• packageContents
  Type: Microsoft.SharePoint.BusinessData.Administration.Client.Parser.PackageContents

  A bitwise combination of the enumeration values that specify which elements to read.

• metadataCatalog
  Type: Microsoft.SharePoint.BusinessData.Administration.Client.AdministrationMetadataCatalog

  The Metadata Store in which the external system is defined.

• settingId
  Type: System.String

  The ID of a partition in the Metadata Store where the properties, localized names, and access control entries are stored; null indicates default settings.

Return Value

Type: Microsoft.SharePoint.BusinessData.Administration.Client.LobSystem
The merged external system.

Exceptions

Exception	Condition
ArgumentNullException	xml or metadataCatalog is null .
ArgumentException	The value of the packageContents parameter is PackageContents.Model.

Remarks

Use the packageContents parameter to specify which of the resources in the xml parameter to add to the Metadata Store.

If packageContents is PackageContents.Properties, BDC creates all the properties in the xml in the specified setting. If a property with the same name exists, it is replaced by the new property. Merging properties requires Edit permissions in the specified setting.

If packageContents is PackageContents.LocalizedNames, BDC creates all the localized names in the xml in the specified setting. If a localized name with the same LCID exists, it is replaced by the new localized name. Merging localized names requires Edit permissions in the specified setting.

If packageContents is PackageContents.Permissions, BDC replaces existing permissions with the new permissions in the xml. Merging permissions requires the SetPermissions permission in the specified setting.

See Also

Reference

LobSystem Class

LobSystem Members

MergeXml Overload

Microsoft.SharePoint.BusinessData.Administration.Client Namespace