Entity.MergeXml - Méthode

Article
05/05/2016

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

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

Syntaxe

'Déclaration
Public Shared Function MergeXml ( _
    xml As String, _
    <OutAttribute> ByRef errors As String(), _
    packageContents As PackageContents, _
    lobSystem As LobSystem, _
    settingId As String _
) As Entity
'Utilisation
Dim xml As String
Dim errors As String()
Dim packageContents As PackageContents
Dim lobSystem As LobSystem
Dim settingId As String
Dim returnValue As Entity

returnValue = Entity.MergeXml(xml, _
    errors, packageContents, lobSystem, _
    settingId)

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

Paramètres

xml
Type : System.String

Chaîne contenant les métadonnées XML.

errors
Type : []

Une liste des messages d'erreur non critiques qui s'est produite lors de la fusion des données ou en train de lire le fichier XML.

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

Options qui spécifient les éléments à lire.

lobSystem
Type : Microsoft.SharePoint.BusinessData.Administration.Client.LobSystem

Le système externe qui contient le type de contenu externe à fusionner.

settingId
Type : System.String

L'identificateur d'une partition dans le magasin de métadonnées qui est utilisé pour stocker des propriétés, localisées noms et les entrées de contrôle d'accès une référence Null (Rien dans Visual Basic) indique les paramètres par défaut.

Valeur renvoyée

Type : Microsoft.SharePoint.BusinessData.Administration.Client.Entity
Type de contenu externe fusionné.

Exceptions

Exception	Condition
ArgumentNullException	Le paramètre lobSystem ou le xml est une référence Null (Rien dans Visual Basic).
ArgumentException	Le paramètre packageContents est défini pour la valeur PackageContents.Model .
MetadataObjectNotFoundException	Type de contenu externe n'existe pas dans le système externe spécifié.

Remarques

Cette méthode vous permet de spécifier les ressources qui sont présents dans la chaîne XML de métadonnées donnée doivent être ajoutés au magasin de métadonnées via le paramètre packageContents .

Si la valeur PackageContents.Properties est spécifiée dans le paramètre packageContents , BDC créera toutes les propriétés dans le code XML donné 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 de propriétés nécessite des autorisations « Modifier » dans le paramètre spécifié.

Si valeur PackageContents.LocalizedNames est spécifiée dans le paramètre packageContents , BDC créera tous les noms localisés dans l'élément XML donné 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 « Modifier » dans le paramètre spécifié.

Si la valeur PackageContents.Permissions est spécifié dans le packageContents, BDC remplacer les autorisations existantes par les nouvelles autorisations dans le code XML donné. La fusion des autorisations nécessite l'autorisation « SetPermissions » dans le paramètre spécifié.

Voir aussi

Référence

Entity classe

Entity - Membres

Microsoft.SharePoint.BusinessData.Administration.Client - Espace de noms

Partager via