SPBackupRestoreObject-Klasse
Enthält Hilfsfunktionen für Sicherungs-und Wiederherstellungsvorgänge und fungiert als Container für ein SPBackupRestoreInformation -Objekt und seine korrelierte IBackupRestore -Objekt.
Vererbungshierarchie
System.Object
Microsoft.SharePoint.Administration.Backup.SPBackupRestoreObject
Namespace: Microsoft.SharePoint.Administration.Backup
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaration
<SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel := True)> _
<SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel := True)> _
Public NotInheritable Class SPBackupRestoreObject
'Usage
Dim instance As SPBackupRestoreObject
[SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel = true)]
[SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel = true)]
public sealed class SPBackupRestoreObject
Hinweise
Da es eine IBackupRestore -Eigenschaft, die ein IBackupRestore -Objekt zurückgibt verfügt, kann ein SPBackupRestoreObject -Objekt betrachtet werden als Darstellung einer Inhaltskomponente eines Typs, die gesichert oder wiederhergestellt werden kann.
SPBackupRestoreObject -Objekte können geschachtelt werden. Weitere Informationen finden Sie unter den Eigenschaften Parent und Children . In der Regel wird eine Struktur von SPBackupRestoreObject -Objekten eine Struktur von Content-Komponenten, beispielsweise Farm, Webdienst, Webanwendung und Inhaltsdatenbank spiegeln. Die Reparent -Methode jedoch ermöglicht Ihnen das Erstellen von Strukturen für Sicherungs- und Wiederherstellungsvorgänge, die nicht genau einem beliebigen Teil des Struktur der Komponenten Ihrer Bereitstellung zu spiegeln.
Diese Klasse verfügt über keinen öffentlichen Konstruktor. Rufen Sie einen Verweis auf ein Objekt SPBackupRestoreObject mit einer Methode, die Objekte dieser Klasse zurückgegeben; beispielsweise GetRootoder eine Indexerstellung einen Verweis auf einen bestimmten Member eines SPBackupRestoreObjectCollection -Objekts verwenden.
Diese Klasse enthält mehrere Konstanten, die zum Extrahieren von Informationen aus dem Objekt in der Information -Eigenschaft verwendet werden.
Ein Objekt SPBackupRestoreObject weiterhin als <SPBackupObject> Element in einer spbackup.xml oder einer sprestore.xml , die in einem Unterordner des Speicherorts für die Sicherung in der Location -Eigenschaft des Objekts in der Information -Eigenschaft identifizierte gespeichert wird.
Beispiele
Die folgende Abbildung zeigt der SPBackupRestoreObject -Klasse, dass einzelne Komponenten werden im oberen Bereich die Struktur von Komponenten, die verarbeitet werden durch eine Sicherung oder Wiederherstellung identifiziert, die in einer Methode, mit die sichergestellt wird, dass ein Benutzer der Namen der Komponente eindeutig übermittelten verwendet wird. Das vollständige Beispiel und eine ausführliche Erläuterung des es finden Sie unter 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
Es folgt ein Beispiel für ein <SPBackupObject> -Element in einer sprestore.xml -Datei. Die Komponente, dargestellt durch das Element ist eine Webanwendung mit dem Namen "SharePoint - 80" SharePoint Foundation .
<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>
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.