SPFileCollection.Add-Methode (String, Byte[], Boolean)

Artikel
05/06/2015

Erstellt eine Datei in der Auflistung mit der angegebenen URL und ein Bytearray, das den Inhalt einer Datei enthält einen booleschen Wert, der angibt, ob alle Dateien überschrieben, die den gleichen Namen hat.

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

Syntax

'Declaration
Public Function Add ( _
    urlOfFile As String, _
    file As Byte(), _
    overwrite As Boolean _
) As SPFile
'Usage
Dim instance As SPFileCollection
Dim urlOfFile As String
Dim file As Byte()
Dim overwrite As Boolean
Dim returnValue As SPFile

returnValue = instance.Add(urlOfFile, _
    file, overwrite)

public SPFile Add(
    string urlOfFile,
    byte[] file,
    bool overwrite
)

Parameter

urlOfFile
Typ: System.String

Die Site-relativen URL der Datei.

file
Typ: []

Ein Bytearray, das die Datei enthält.

overwrite
Typ: System.Boolean

true eine Datei mit demselben Namen überschreiben; andernfalls false.

Rückgabewert

Typ: Microsoft.SharePoint.SPFile
Die neu hinzugefügte Datei.

Beispiele

Im folgenden Codebeispiel führt eine Iteration durch die Auflistung der Dateien in einer Dokumentbibliothek einer Website und wenn der Eincheckkommentar für eine Datei "beendet" ist, kopiert die Datei in einen bestimmten Ordner.

Dim SiteCollection As New SPSite("http://MySiteCollection")
Try
    Dim srcFolder As SPFolder = siteCollection.AllWebs("MySourceWebSite").GetFolder("MySourceLib")

    Dim destFiles As SPFileCollection = siteCollection.AllWebs("MyDestWebSite").GetFolder("MyDestFolder").Files

    Dim srcFile As SPFile
    For Each srcFile In  srcFolder.Files
        If srcFile.CheckInComment = "Finished" Then
            Dim destURL As String = destFiles.Folder.Url + "/" + srcFile.Name
            Dim binFile As Byte() = srcFile.OpenBinary()

            destFiles.Add(destURL, binFile, True)
        End If
    Next srcFile
Finally
    SiteCollection.Dispose()
End Try

using (SPSite oSiteCollection = new SPSite("https://localhost"))
{
    SPFolder oFolder = oSiteCollection.AllWebs["SourceWebSite"].GetFolder("MySourceLib");
    SPFileCollection collFiles = 
oSiteCollection.AllWebs["DestWebSite"].GetFolder("DestFolder").Files;
    foreach (SPFile oFile in collFiles.Files)
    {
        if (oFile.CheckInComment == "Finished")
        {
            string strDestUrl = collFiles.Folder.Url + 
                "/" + oFile.Name;
            byte[] binFile = oFile.OpenBinary();
            collFiles.Add(strDestUrl, binFile, true);
        }
    }
}

Hinweis

Bestimmte Objekte, die IDisposable -Schnittstelle implementieren, und müssen Sie vermeiden, diese Objekte im Arbeitsspeicher beibehalten, nachdem sie nicht mehr benötigt werden. Informationen zu bewährten Programmierpraktiken finden Sie unter Disposing Objects.

Siehe auch

Referenz

SPFileCollection Klasse

SPFileCollection-Member

Add-Überladung

Microsoft.SharePoint-Namespace

Freigeben über