Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

SPBackupRestoreInformation.GenerateFileMapping - Méthode

Génère un nom unique pour le fichier de sauvegarde qui contient le fichier source spécifié.

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

public string GenerateFileMapping(
	string name
)

Paramètres

name
Type : System.String

Le nom du fichier source.

Valeur renvoyée

Type : System.String
String qui représente le nom du fichier de sauvegarde contenant la sauvegarde copie de name.

Cette méthode est utile si une opération de sauvegarde contient plusieurs fichiers portant le même nom. Pour vous assurer que chacune séparément la sauvegarde au lieu d'écraser mutuellement, cette méthode peut être utilisée pour générer un nom unique pour chacune. Elle est généralement appelée dans les implémentations de OnBackup(). Voir l'exemple ci-dessous.

Le format de la valeur de retour est .bak hex, où hex est un nombre hexadécimal à huit chiffres ; par exemple, "00000001.bak" ou 0000000A.bak".

Le paramètre name devient également une clé dans un magasin de paires clé-valeur, et la chaîne renvoyée par GenerateFileMapping devient la valeur de la clé. Cette paire est stockée dans le fichier spbackup.xml dans le dossier Location .

RemarqueRemarque

Bien que GenerateFileMapping et ReverseFileMapping renvoient exactement la même valeur en réponse à la même entrée, ils effectuent différentes choses en interne. GenerateFileMapping crée le nom de fichier unique et écrit la mappées paire de noms de fichiers dans le fichier spbackup.xml . ReverseFileMapping lit le mappage dans le fichier.

L'exemple suivant montre la méthode GenerateFileMapping utilisée dans une implémentation de OnBackup(). Pour obtenir l'exemple complet, consultez How to: Create a Content Class That Can Be Backed Up and Restored.

public Boolean OnBackup(Object sender, SPBackupInformation args)
{
    if (args == null)
    {
    throw new ArgumentNullException("args");
    }

    Boolean successSignal = true;

    foreach (String path in FrontEndFilePaths)
    {
        FileInfo file = new FileInfo(path);
        try
        {
            String mappedFileName = args.GenerateFileMapping(file.Name);
            file.CopyTo(args.Location + @"\" + mappedFileName, true);
            args.Log(SPBackupRestoreLogSeverity.Verbose, "Backed up " + file.Name + " (in " + mappedFileName + ")");
        }
        catch (Exception e)
        {
            args.Log(SPBackupRestoreLogSeverity.Verbose, file.Name + " not backed up: " + e.Message);
            successSignal = false;
        }
    }

    args.CurrentProgress = 50;
    return successSignal;
}
Afficher: