SPBackupRestoreObject - Classe
Fournit des fonctions d'assistance pour les opérations de sauvegarde et de restauration et agit comme un conteneur pour un objet SPBackupRestoreInformation et son objet en corrélation IBackupRestore .
Hiérarchie d’héritage
System.Object
Microsoft.SharePoint.Administration.Backup.SPBackupRestoreObject
Espace de noms : Microsoft.SharePoint.Administration.Backup
Assembly : Microsoft.SharePoint (dans Microsoft.SharePoint.dll)
Syntaxe
'Déclaration
<SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel := True)> _
<SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel := True)> _
Public NotInheritable Class SPBackupRestoreObject
'Utilisation
Dim instance As SPBackupRestoreObject
[SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel = true)]
[SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel = true)]
public sealed class SPBackupRestoreObject
Remarques
Dans la mesure où il possède une propriété IBackupRestore qui renvoie un objet IBackupRestore , un objet SPBackupRestoreObject peut considérer comme représentant un composant de contenu d'un type qui peut être sauvegardé ou restauré.
SPBackupRestoreObject les objets peuvent être imbriqués. Pour plus d'informations, consultez les propriétés Parent et Children . En règle générale, une arborescence d'objets SPBackupRestoreObject sera mise en miroir une arborescence des composants contenus, tels que la batterie de serveurs, service Web, application Web et base de données de contenu. Toutefois, la méthode Reparent vous permet de créer des arborescences pour la sauvegarde et les opérations de restauration qui pas exactement de mise en miroir n'importe quelle partie de l'arborescence de votre déploiement de composants.
Cette classe n'a aucun constructeur public. Obtenir une référence à un objet SPBackupRestoreObject avec une méthode qui retourne les objets de cette classe. par exemple GetRoot, ou utiliser un indexeur pour obtenir une référence à un membre particulier d'un objet SPBackupRestoreObjectCollection .
Cette classe possède plusieurs constantes qui sont utilisées pour extraire des informations à partir de l'objet dans la propriété Information .
Un objet SPBackupRestoreObject persiste sous la forme d'un élément <SPBackupObject> dans un spbackup.xml ou un sprestore.xml qui est enregistré dans un sous-dossier de l'emplacement de sauvegarde identifié dans la propriété Location de l'objet dans la propriété Information .
Exemples
Voici la classe SPBackupRestoreObject qui est utilisée dans une méthode qui permet de garantir que le nom du composant soumis par un utilisateur unique identifie un seul composant à la partie supérieure de l'arborescence des composants qui seront traités par une sauvegarde ou une restauration. Pour l'exemple complet et une description détaillée de ce dernier, consultez How to: Programmatically Back Up Content.
private static SPBackupRestoreObject EnsureUniqueValidComponentName(SPBackupRestoreSettings settings, ref Guid operationGUID)
{
SPBackupRestoreObjectCollection list = SPBackupRestoreConsole.FindItems(operationGUID, settings.IndividualItem);
SPBackupRestoreObject component = null;
if (list.Count <= 0)
{
Console.WriteLine("There is no component with that name. Run again with a new name.");
Console.WriteLine("Press Enter to continue.");
Console.ReadLine();
}
else if (list.Count > 1) // The component name specified is ambiguous. Prompt user to be more specific.
{
Console.WriteLine("More than one component matches the name you entered.");
Console.WriteLine("Run again with one of the following:");
for (int i = 0; i < list.Count; i++)
{
Console.WriteLine("\t{0}", list[i].ToString());
}
Console.WriteLine("Press Enter to continue.");
Console.ReadLine();
}
else
{
component = list[0];
}
return component;
}// end EnsureUniqueValidComponentName
Private Shared Function EnsureUniqueValidComponentName(ByVal settings As SPBackupRestoreSettings, ByRef operationGUID As Guid) As SPBackupRestoreObject
Dim list As SPBackupRestoreObjectCollection = SPBackupRestoreConsole.FindItems(operationGUID, settings.IndividualItem)
Dim component As SPBackupRestoreObject = Nothing
If list.Count <= 0 Then
Console.WriteLine("There is no component with that name. Run again with a new name.")
Console.WriteLine("Press Enter to continue.")
Console.ReadLine()
ElseIf list.Count > 1 Then ' The component name specified is ambiguous. Prompt user to be more specific.
Console.WriteLine("More than one component matches the name you entered.")
Console.WriteLine("Run again with one of the following:")
For i As Integer = 0 To list.Count - 1
Console.WriteLine(vbTab & "{0}", list(i).ToString())
Next i
Console.WriteLine("Press Enter to continue.")
Console.ReadLine()
Else
component = list(0)
End If
Return component
End Function ' end EnsureUniqueValidComponentName
Voici un exemple d'un élément <SPBackupObject> dans un fichier sprestore.xml . Le composant représenté par l'élément est un SharePoint Foundation application Web nommée « SharePoint - 80 ».
<SPBackupObject Name="SharePoint - 80">
<SPBackupRestoreClass>Microsoft.SharePoint.Administration.SPWebApplication, Microsoft.SharePoint, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c</SPBackupRestoreClass>
<SPBackupSelectable>True</SPBackupSelectable>
<SPRestoreSelectable>True</SPRestoreSelectable>
<SPName>SharePoint - 80</SPName>
<SPId>6abb0dec-eeab-42d2-8996-af63b8a3ef60</SPId>
<SPCanBackup>True</SPCanBackup>
<SPCanRestore>True</SPCanRestore>
<SPCurrentProgress>100</SPCurrentProgress>
<SPLastUpdate>04/27/2009 12:34:56</SPLastUpdate>
<SPCurrentPhase>Done</SPCurrentPhase>
<SPParameters>
<SPParameter Key="6abb0dec-eeab-42d2-8996-af63b8a3ef60STATE.xml"><![CDATA[00000003.bak]]></SPParameter>
<SPParameter Key="ApplicationPoolId"><![CDATA[SharePoint Content Application Pool]]></SPParameter>
<SPParameter Key="Features.xml"><![CDATA[0000001B.bak]]></SPParameter>
<SPParameter Key="IdentityType"><![CDATA[SpecificUser]]></SPParameter>
<SPParameter Key="OutboundMailServer"><![CDATA[smtp.example.com]]></SPParameter>
<SPParameter Key="SPDescription"><![CDATA[Content and configuration data for this Web application.]]></SPParameter>
<SPParameter Key="SPName" InputDescription="New web application name:"><![CDATA[SharePoint - 80]]></SPParameter>
<SPParameter Key="SPServer" InputDescription="New web application URL:" ForceLtr="true"><![CDATA[http://sharepoint.example.com/]]></SPParameter>
<SPParameter Key="SPUserName"><![CDATA[DOMAIN\username]]></SPParameter>
<SPParameter Key="WebApplicationId"><![CDATA[67bf6cdb-8fc9-457f-9764-6a8bbf07769e]]></SPParameter>
</SPParameters>
</SPBackupObject>
Cohérence de thread
Tous les membres statique (Partagé dans Visual Basic)s publics de ce type sont thread-safe. Cela n’est pas garanti pour les membres d’instance.