Partager via


SPImportSettings.RetainObjectIdentity - Propriété

Obtient ou définit une valeur qui indique si l'identificateur GUID sont conservés lorsque le contenu est importé dans l'emplacement de destination.

Espace de noms :  Microsoft.SharePoint.Deployment
Assembly :  Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

Syntaxe

'Déclaration
Public Property RetainObjectIdentity As Boolean
    Get
    Set
'Utilisation
Dim instance As SPImportSettings
Dim value As Boolean

value = instance.RetainObjectIdentity

instance.RetainObjectIdentity = value
public bool RetainObjectIdentity { get; set; }

Valeur de propriété

Type : System.Boolean
true pour conserver les GUID ; dans le cas contraire, false. La valeur par défaut est false.

Remarques

Cette propriété doit être utilisée avec précaution, bases de données n'autorisent pas les doublons de GUID. Il est couramment utilisé lorsque vous avez deux sites Web qui sont des images miroir de l'autre, ou dans un scénario de publication pour indiquer si un fichier sur un seul ordinateur est le même fichier sur un autre ordinateur. En fait, RetainObjectIdentity est l'épine de migration sélective, étant donné que le concept de base est l'importation des versions mises à jour des fichiers existants. La seule façon de la destination sait qu'un élément est qu'une version mise à jour d'un élément existant consiste à comparer l'identité de l'objet à l'aide du GUID de l'objet.

La valeur de la propriété RetainObjectIdentity est ignorée lors de la migration des sites Web dans la même application SharePoint Web.

Cette valeur doit être définie à true pour prendre en charge la suppression de champs (champs supprimés à l'emplacement de l'exportation depuis la dernière exportation sont supprimés à l'emplacement d'importation) pour les opérations incrémentielles (ExportMethod doit aussi avoir une valeur de ExportChanges.)

Cette fonctionnalité est uniquement disponible dans le modèle d'objet et ne peut pas être accomplie à l'aide de stsadm ou le service web Sites .

Étant donné que les bases de données n'acceptent pas les GUID en double, restez vigilent si vous utilisez cette propriété. Elle n'est utile que dans les scénarios de migration sélective. De plus, pour prendre en charge la suppression de champ (c'est-à-dire la suppression des versions précédentes des éléments au niveau de la source de l'exportation lorsqu'ils sont mis à jour et la suppression du même fichier au niveau de la destination de l'importation), cette valeur doit être définie à true. Notez également que pour prendre en charge les migrations sélectives, vous devez définir la propriété ExportMethod avec la valeur de champ ExportChanges.

Voir aussi

Référence

SPImportSettings classe

SPImportSettings - Membres

Microsoft.SharePoint.Deployment - Espace de noms