This documentation is archived and is not being maintained.

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.