Identifier.MergeXml - Méthode

Article
03/06/2015

Lit la définition de Identifier à partir de la ressource spécifiée XML pour le type de contenu externe spécifié, puis fusionne ses propriétés, les noms localisés et les entrées de contrôle d'accès avec la existant Identifier 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, _
    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 erreurs non critiques qui s'est produite lors de la fusion des données ou de lire les données XML.

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

Options de spécifier les éléments à lire.

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

Le parent type de contenu externe défini dans le Identifier .

settingId
Type : System.String

L'identificateur d'une partition dans le magasin pour stocker les propriétés des métadonnées, les 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.Identifier
L'objet fusionnée 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 a la valeur PackageContents.Model définie.
MetadataObjectNotFoundException	Le 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 de PackageContents.Properties est spécifiée dans le paramètre packageContents , BDC créera toutes les propriétés dans le fichier XML spécifié dans le paramètre spécifié. Si une propriété portant le même nom existe, il sera remplacé par la nouvelle propriété. Fusion des propriétés requiert des autorisations de « Modifier » dans le paramètre spécifié.

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

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

Voir aussi

Référence

Identifier classe

Identifier - Membres

Microsoft.SharePoint.BusinessData.Administration - Espace de noms

Partager via