Freigeben über


IBackupRestore.DiskSizeRequired-Eigenschaft

Ruft den Speicherplatz in Bytes, die zum Speichern von einer Sicherungs des durch das IBackupRestore -Objekt dargestellten Inhalts erforderlich ist.

Namespace:  Microsoft.SharePoint.Administration.Backup
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'Declaration
ReadOnly Property DiskSizeRequired As ULong
    Get
'Usage
Dim instance As IBackupRestore
Dim value As ULong

value = instance.DiskSizeRequired
ulong DiskSizeRequired { get; }

Eigenschaftswert

Typ: System.UInt64
Eine UInt64 , die die Größe in Bytes darstellt, die auf dem Speichergerät zum Speichern der Daten erforderlich ist.

Hinweise

Die DiskSizeRequired -Eigenschaft wird von der DiskSizeRequired() -Methode zur Laufzeit gelesen. Die zweite Methode fügt auf den Wert 1 KB zurückgegeben und anschließend der Werte von allen DiskSizeRequired -Eigenschaft der einzelnen untergeordneten IBackupRestore Objekte hinzugefügt.

Hinweise für Implementierer

Ihre get Accessor sollte abrufen und Summieren der Größe der Datenbanken und Dateien und die Größe der alle BLOBs, die größer als 1 KB sind. Wenn alle diese zusammen weniger als 1 KB insgesamt, sollte der get Accessor 0 zurück.

Führen Sie nicht den Umfang der alle untergeordneten Objekte, die sich selbst IBackupRestore Objekte sind. Die Größe der untergeordneten Objekte IBackupRestore wird von der DiskSizeRequired() -Methode die Gesamtgröße der zur Laufzeit hinzugefügt. Die Größe der untergeordneten Elemente werden zu Summe hinzugefügt zwei Mal ein, wenn sie auch vom get -Accessor von ihrem übergeordneten Element hinzugefügt wurden.

Die meisten IBackupRestore Klassen mit untergeordneten IBackupRestore Klassen sind nur Container, und die DiskSizeRequired -Eigenschaft des solche Klassen gibt 0 zurück. SPFarm.DiskSizeRequired lautet beispielsweise immer 0.

Beispiele

Im folgenden Beispiel wird die Größe aller Dateien in einem Array von FileInfo -Objekten aufgerufen FrontEndFiles ist selbst aus einer Auflistung von Pfaden aufgerufen FrontEndFilePaths , die deklariert wird aufgefüllt summiert an anderer Stelle als privates Feld in der Klasse.

Hinweis

Speichern die Auflistung von Zeichenfolgen, anstatt die Auflistung der Objekte FileInfo ist selbst vorteilhaft, wenn die-Klasse abgeleitet, direkt ist oder indirekt von der SPPersistedObject -Klasse. Letztere Klasse kann beibehalten von String Mitglieder (und Auflistungen), aber es kann nicht beibehalten werden Elemente des FileInfo -Objekts.

public UInt64 DiskSizeRequired
{
    get
    {
        UInt64 total = 0;
        List<FileInfo> FrontEndFiles = new List<FileInfo>(NUMBER_OF_FILES_TO_BACK_UP);
        
        foreach (String path in FrontEndFilePaths)
        {
            FileInfo file = new FileInfo(path);
            FrontEndFiles.Add(file);
        }
        
        foreach (FileInfo file in FrontEndFiles)
        {
            total = total + (UInt64)file.Length;
        }
        
        return total;
    }
}
Public ReadOnly Property DiskSizeRequired() As UInt64
    Get
        Dim total As UInt64 = 0
        Dim FrontEndFiles As New List(Of FileInfo)(NUMBER_OF_FILES_TO_BACK_UP)

        For Each path As String In FrontEndFilePaths
            Dim file As New FileInfo(path)
            FrontEndFiles.Add(file)
        Next path

        For Each file As FileInfo In FrontEndFiles
            total = total + CULng(file.Length)
        Next file

        Return total
    End Get
End Property

Siehe auch

Referenz

IBackupRestore Schnittstelle

IBackupRestore-Member

Microsoft.SharePoint.Administration.Backup-Namespace