Identifier.MergeXml - Méthode

Article
05/05/2016

Lit la définition Identifier à partir de la ressource spécifiée XML pour le type de contenu externe spécifié et fusionne ses propriétés, les noms localisés et les entrées de contrôle d'accès avec la Identifier 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, _
    entity As Entity, _
    settingId As String _
) As Identifier
'Utilisation
Dim xml As String
Dim errors As String()
Dim packageContents As PackageContents
Dim entity As Entity
Dim settingId As String
Dim returnValue As Identifier

returnValue = Identifier.MergeXml(xml, _
    errors, packageContents, entity, _
    settingId)

public static Identifier MergeXml(
    string xml,
    out string[] errors,
    PackageContents packageContents,
    Entity entity,
    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.

entity
Type : Microsoft.SharePoint.BusinessData.Administration.Client.Entity

Parent type de contenu externe défini dans la Identifier .

settingId
Type : System.String

L'identificateur d'une partition dans les propriétés pour un magasin de métadonnées, des noms localisés et 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.Identifier
L'objet fusionnées Identifier .

Exceptions

Exception	Condition
ArgumentNullException	Le paramètre entity 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	La Identifier n'existe pas dans le type de contenu 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

Identifier classe

Identifier - Membres

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

Partager via