del método SPBackupRestoreConsole.FindItems

Obtiene los componentes especificados SharePoint Foundation de la operación de restauración o copia de seguridad especificada.

Espacio de nombres:  Microsoft.SharePoint.Administration.Backup
Ensamblado:  Microsoft.SharePoint (en Microsoft.SharePoint.dll)

Sintaxis

'Declaración
Public Shared Function FindItems ( _
    id As Guid, _
    item As String _
) As SPBackupRestoreObjectCollection
'Uso
Dim id As Guid
Dim item As String
Dim returnValue As SPBackupRestoreObjectCollection

returnValue = SPBackupRestoreConsole.FindItems(id, _
    item)

public static SPBackupRestoreObjectCollection FindItems(
    Guid id,
    string item
)

Parámetros

• id
  Tipo: System.Guid

  El identificador de Guid de la SPBackupRestoreConsoleObject que representa la operación de copia de seguridad o restauración.

• item
  Tipo: System.String

  El nombre de un componente que puede copia de seguridad o restauración o parte de un nombre que coincida con varios componentes.

Valor devuelto

Tipo: Microsoft.SharePoint.Administration.Backup.SPBackupRestoreObjectCollection
SPBackupRestoreObjectCollection que representa todos los SPBackupRestoreObject cuyos nombres coinciden item.

Ejemplos

A continuación se muestra la clase SPBackupRestoreObjectCollection que se usa en un método que se asegurará de que el nombre del componente enviado por un usuario de forma única identifica un componente único para que sea la parte superior del árbol de componentes que se procesarán mediante una copia de seguridad o la operación de restauración. Para obtener una explicación detallada de la misma y el ejemplo completo, vea 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

El ejemplo siguiente muestra cómo usar este método en una aplicación de consola que muestra todos los componentes de la granja de servidores en una vista de árbol.

static void Main(string[] args)
{
    SPBackupSettings settings = (SPBackupSettings)SPBackupRestoreSettings.GetBackupSettings(@"\\server\Backups", "full");
    Guid backup = SPBackupRestoreConsole.CreateBackupRestore(settings);

    SPBackupRestoreObjectCollection list = SPBackupRestoreConsole.FindItems(backup, "Farm");

    DisplayThisAndChildrensNames(list[0],0);

    foreach (SPBackupRestoreObject oBURO in list)
    {
        Console.WriteLine("Name: " + oBURO.DisplayName);
        foreach (SPBackupRestoreObject oBUROchild in oBURO.Children)
        {
            Console.WriteLine("Name: " + oBUROchild.DisplayName);
        }
    }

private static void DisplayThisAndChildrensNames(SPBackupRestoreObject component, Int32 depth)
{
    Int32 currentDepth = 0;
    while (currentDepth < depth)
    {
        Console.Write("\t");
        currentDepth++;
    }
    Console.Write("Name: " + component.DisplayName +"\n");

    foreach (SPBackupRestoreObject oChild in component.Children)
    {
        DisplayThisAndChildrensNames(oChild, depth+1);
    }
}

Shared Sub Main(ByVal args() As String)
    Dim settings As SPBackupSettings = CType(SPBackupRestoreSettings.GetBackupSettings("\\server\Backups", "full"), SPBackupSettings)
    Dim backup As Guid = SPBackupRestoreConsole.CreateBackupRestore(settings)

    Dim list As SPBackupRestoreObjectCollection = SPBackupRestoreConsole.FindItems(backup, "Farm")

    DisplayThisAndChildrensNames(list(0),0)

    For Each oBURO As SPBackupRestoreObject In list
        Console.WriteLine("Name: " & oBURO.DisplayName)
        For Each oBUROchild As SPBackupRestoreObject In oBURO.Children
            Console.WriteLine("Name: " & oBUROchild.DisplayName)
        Next oBUROchild
    Next oBURO
End Sub
Private Shared Sub DisplayThisAndChildrensNames(ByVal component As SPBackupRestoreObject, ByVal depth As Int32)
    Dim currentDepth As Int32 = 0
    Do While currentDepth < depth
        Console.Write(vbTab)
        currentDepth += 1
    Loop
    Console.Write("Name: " & component.DisplayName & vbLf)

    For Each oChild As SPBackupRestoreObject In component.Children
        DisplayThisAndChildrensNames(oChild, depth+1)
    Next oChild
End Sub

Vea también

Referencia

clase SPBackupRestoreConsole

Miembros SPBackupRestoreConsole

Espacio de nombres Microsoft.SharePoint.Administration.Backup