SPFileCollection.Add Method (String, Byte , Hashtable, SPUser, SPUser, DateTime, DateTime, Boolean)
Creates a file in the collection using the specified URL, a byte array that contains the contents of a file, a hash table that contains metadata for the file, user objects that represent the users who created and last modified the file, DateTime values that specify when they did so, 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)
Available in Sandboxed Solutions: Yes
Available in SharePoint Online
Syntax
'Declaration
Public Function Add ( _
urlOfFile As String, _
file As Byte(), _
properties As Hashtable, _
createdBy As SPUser, _
modifiedBy As SPUser, _
timeCreated As DateTime, _
timeLastModified As DateTime, _
overwrite As Boolean _
) As SPFile
'Usage
Dim instance As SPFileCollection
Dim urlOfFile As String
Dim file As Byte()
Dim properties As Hashtable
Dim createdBy As SPUser
Dim modifiedBy As SPUser
Dim timeCreated As DateTime
Dim timeLastModified As DateTime
Dim overwrite As Boolean
Dim returnValue As SPFile
returnValue = instance.Add(urlOfFile, _
file, properties, createdBy, modifiedBy, _
timeCreated, timeLastModified, overwrite)
public SPFile Add(
string urlOfFile,
byte[] file,
Hashtable properties,
SPUser createdBy,
SPUser modifiedBy,
DateTime timeCreated,
DateTime timeLastModified,
bool overwrite
)
Parameters
urlOfFile
Type: System.StringThe site-relative URL of the file.
file
Type: []A byte array that contains the file.
properties
Type: System.Collections.HashtableA hash table that contains metadata for the file.
createdBy
Type: Microsoft.SharePoint.SPUserThe user who created the file.
modifiedBy
Type: Microsoft.SharePoint.SPUserThe user who last modified the file.
timeCreated
Type: System.DateTimeThe date and time when the file was created.
timeLastModified
Type: System.DateTimeThe date and time when the file was last modified.
overwrite
Type: System.Booleantrue to overwrite a file of the same name; otherwise, false.
Return Value
Type: Microsoft.SharePoint.SPFile
The newly added file.