SPBackupRestoreObject class
Fornece funções auxiliares para operações de backup e restauração e atua como um contêiner para um objeto de SPBackupRestoreInformation e seu objeto correlacionados IBackupRestore .
Inheritance hierarchy
System.Object
Microsoft.SharePoint.Administration.Backup.SPBackupRestoreObject
Namespace: Microsoft.SharePoint.Administration.Backup
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaração
<SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel := True)> _
<SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel := True)> _
Public NotInheritable Class SPBackupRestoreObject
'Uso
Dim instance As SPBackupRestoreObject
[SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel = true)]
[SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel = true)]
public sealed class SPBackupRestoreObject
Comentários
Porque ele tem uma propriedade IBackupRestore que retorna um objeto IBackupRestore , um objeto SPBackupRestoreObject pode ser considerado como representando um componente de conteúdo de um tipo que pode ser copiado ou restaurado.
SPBackupRestoreObject objetos podem ser aninhados. Para obter mais informações, consulte as propriedades Parent e Children . Normalmente, uma árvore de objetos do SPBackupRestoreObject irá espelhar uma árvore de componentes de conteúdo, como farm, serviço da Web, aplicativo da Web e banco de dados de conteúdo. No entanto, o método Reparent permite que você crie árvores para backup e restauração das operações que não exatamente espelham a qualquer parte da árvore da implantação dos componentes.
Essa classe não tem nenhum construtor público. Obtenha uma referência para um objeto SPBackupRestoreObject com um método que retorna objetos desta classe; Por exemplo GetRootou use um indexador para obter uma referência a um membro específico de um objeto SPBackupRestoreObjectCollection .
Essa classe tem várias constantes que são usadas para extrair informações do objeto na propriedade Information .
Persiste um objeto SPBackupRestoreObject como um elemento de <SPBackupObject> em um spbackup.xml ou um sprestore.xml que são salvas em uma subpasta do local de backup identificado na propriedade Location do objeto na propriedade Information .
Examples
O seguinte mostra a classe SPBackupRestoreObject sendo usado em um método que assegura que o nome do componente enviado por um usuário exclusivamente identifica um único componente para ser a parte superior da árvore de componentes que serão processados por um backup ou restaurar a operação. Para o exemplo completo e uma discussão detalhada sobre ele, consulte 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
O seguinte é um exemplo de um elemento <SPBackupObject> em um arquivo de sprestore.xml . O componente representado pelo elemento é um SharePoint Foundation aplicativo da Web chamado "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>
Thread safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.