Partager via


LobSystem.MergeXml - Méthode (String, String[], PackageContents, AdministrationMetadataCatalog, String)

Lit la définition de système externe à partir de la ressource spécifiée XML pour le magasin de métadonnées spécifiée et fusionne ensuite ses propriétés, les noms localisés et les entrées de contrôle d'accès avec le système externe existant dans le magasin de métadonnées.

Espace de noms :  Microsoft.SharePoint.BusinessData.Administration
Assembly :  Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

Syntaxe

'Déclaration
Public Shared Function MergeXml ( _
    xml As String, _
    <OutAttribute> ByRef errors As String(), _
    packageContents As PackageContents, _
    metadataCatalog As AdministrationMetadataCatalog, _
    settingId As String _
) As LobSystem
'Utilisation
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
)

Paramètres

  • errors
    Type : []

    Lorsque cette méthode retourne une valeur, contient une liste des erreurs non critiques qui s'est produite lors de la fusion des données ou lire les données XML. Ce paramètre est passé sans être initialisé.

  • settingId
    Type : System.String

    L'identificateur (ID) d'une partition dans le magasin de métadonnées dans lequel stocker les propriétés, les noms localisés et entrées de contrôle d'accès ; null indique les paramètres par défaut.

Valeur renvoyée

Type : Microsoft.SharePoint.BusinessData.Administration.LobSystem
Le système externe fusionné.

Exceptions

Exception Condition
ArgumentNullException

xml ou metadataCatalog est null .

ArgumentException

La valeur du paramètre packageContents est PackageContents.Model.

MetadataObjectNotFoundException

Le système externe n'existe pas dans le magasin de métadonnées spécifiée.

Remarques

Le paramètre packageContents permet de spécifier ce qui est des ressources dans le paramètre xml à ajouter au magasin de métadonnées.

Si packageContents est PackageContents.Properties, BDC crée les propriétés xml dans le paramètre spécifié. Si une propriété portant le même nom existe, il est remplacé par la nouvelle propriété. Fusion des propriétés requiert des autorisations de « Modifier » dans le paramètre spécifié.

Si packageContents est PackageContents.LocalizedNames, BDC crée tous les noms localisés dans xml dans le paramètre spécifié. Si un nom localisé avec le même LCID existe, il est remplacé par le nouveau nom localisé. Fusion des noms localisés nécessite des autorisations de « Modifier » dans le paramètre spécifié.

Si packageContents est PackageContents.Permissions, BDC remplace les autorisations existantes par les nouvelles autorisations dans xml. Fusion des autorisations nécessite l'autorisation de « SetPermissions » dans le paramètre spécifié.

Voir aussi

Référence

LobSystem classe

LobSystem - Membres

MergeXml - Surcharge

Microsoft.SharePoint.BusinessData.Administration - Espace de noms