Partager via


ActionParameter.MergeXml - Méthode

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

returnValue = ActionParameter.MergeXml(xml, _
    errors, packageContents, action, _
    settingId)
public static ActionParameter MergeXml(
    string xml,
    out string[] errors,
    PackageContents packageContents,
    Action action,
    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.

  • 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.ActionParameter
La fusionnées ActionParameter.

Exceptions

Exception Condition
ArgumentNullException

Le paramètre xml ou action 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 ActionParameter n'existe pas dans le Actionspé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

ActionParameter classe

ActionParameter - Membres

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