Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here.

SPFileCollection.Add Method (String, Byte[], Boolean)

Windows SharePoint Services 3

Creates a file in the collection based on the specified URL and on a byte array that contains a file, overwriting any file of the same name only if overwrite is true.

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

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


Type: System.String
A string that specifies the URL for the file.
Type: []
A byte array containing the file.
Type: System.Boolean
true to overwrite a file of the same name; otherwise, false.

Return Value

Type: Microsoft.SharePoint.SPFile
An SPFile object that represents the file.

The following code example iterates through the collection of files in a document library of a site and, if the check-in comment for a file is "Finished", copies the file to a specified folder.

using (SPSite oSiteCollection = new SPSite("http://localhost"))
    SPFolder oFolder = oSiteCollection.AllWebs["SourceWebSite"].GetFolder("MySourceLib");
    SPFileCollection collFiles = 
    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);

Certain objects implement the IDisposable interface, and you must avoid retaining these objects in memory after they are no longer needed. For information about good coding practices, see Best Practices: Using Disposable Windows SharePoint Services Objects.

Community Additions

© 2015 Microsoft