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

Creates a file in the collection using the specified URL, a byte array that contains the contents of a file, and a Boolean value that specifies whether to overwrite any file that has the same name.

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

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

Parameters

urlOfFile
Type: System.String

The site-relative URL of the file.

file
Type: []

A byte array that contains the file.

overwrite
Type: System.Boolean

true to overwrite a file of the same name; otherwise, false.

Return value

Type: Microsoft.SharePoint.SPFile
The newly added 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 = 
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);
        }
    }
}
NoteNote

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 Disposing Objects.

Show: