del método Identifier.MergeXml

Lee la definición de Identifier desde el recurso especificado XML para el tipo de contenido externo especificado y, a continuación, combina sus propiedades, los nombres localizados y entradas de control de acceso con el existente Identifier en el almacén de metadatos.

Espacio de nombres:  Microsoft.SharePoint.BusinessData.Administration.Client
Ensamblado:  Microsoft.SharePoint.BusinessData.Administration.Client (en Microsoft.SharePoint.BusinessData.Administration.Client.dll)

Sintaxis

'Declaración
Public Shared Function MergeXml ( _
    xml As String, _
    <OutAttribute> ByRef errors As String(), _
    packageContents As PackageContents, _
    entity As Entity, _
    settingId As String _
) As Identifier
'Uso
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
)

Parámetros

• xml
  Tipo: System.String

  Una cadena que contiene los metadatos XML.

• errors
  Tipo: []

  Una lista de errores no críticos al combinar datos o leer XML.

• packageContents
  Tipo: Microsoft.SharePoint.BusinessData.Administration.Client.Parser.PackageContents

  Opciones que especifican los elementos que desea leer.

• entity
  Tipo: Microsoft.SharePoint.BusinessData.Administration.Client.Entity

  El principal tipo de contenido externo que la Identifier se define en.

• settingId
  Tipo: System.String

  El identificador de una partición de las propiedades para el almacén de metadatos, los nombres localizados y entradas de control de acceso en; una referencia null (Nothing en Visual Basic) indica la configuración predeterminada.

Valor devuelto

Tipo: Microsoft.SharePoint.BusinessData.Administration.Client.Identifier
El objeto combinadas Identifier .

Excepciones

Excepción	Condición
ArgumentNullException	El parámetro entity o la xml es una referencia null (Nothing en Visual Basic).
ArgumentException	El parámetro packageContents tiene el valor de PackageContents.Model configurado.
MetadataObjectNotFoundException	La Identifier no existe en el tipo de contenido externo especificado.

Comentarios

Este método le permite especificar qué recursos que se encuentran en la cadena XML de metadatos determinado se agregarán al almacén de metadatos a través del parámetro packageContents .

Si el valor de PackageContents.Properties especificado en el parámetro packageContents , BDC creará todas las propiedades en el XML especificado en el valor especificado. Si existe una propiedad con el mismo nombre, se reemplazará por la nueva propiedad. Combinar propiedades requiere permisos "Editar" en el valor especificado.

Si el valor de PackageContents.LocalizedNames especificado en el parámetro packageContents , BDC creará todos los nombres localizados en el XML especificado en el valor especificado. Si existe un nombre con el mismo LCID localizado, se reemplazará por el nuevo nombre localizado. Combinar los nombres localizados requiere permisos "Editar" en el valor especificado.

Si se especifica el valor de PackageContents.Permissions en la packageContents, BDC reemplazará permisos existentes con los nuevos permisos en el XML determinado. Combinación de permisos requiere el permiso de "SetPermissions" en el valor especificado.

Vea también

Referencia

clase Identifier

Miembros Identifier

Espacio de nombres Microsoft.SharePoint.BusinessData.Administration.Client