SPFileCollection.Add method (String, Stream, Hashtable, SPUser, SPUser, DateTime, DateTime, String, Boolean, Boolean)

根據指定的 URL、 上包含的檔案，包含檔案的中繼資料的Hashtable物件的Stream物件、 SPUser物件代表的使用者建立及上次修改檔案，以及DateTime值將用以指定時一樣，集合中建立的檔案。

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

Syntax

'宣告
Public Function Add ( _
    urlOfFile As String, _
    file As Stream, _
    properties As Hashtable, _
    createdBy As SPUser, _
    modifiedBy As SPUser, _
    timeCreated As DateTime, _
    timeLastModified As DateTime, _
    checkInComment As String, _
    overwrite As Boolean, _
    requireWebFilePermissions As Boolean _
) As SPFile
'用途
Dim instance As SPFileCollection
Dim urlOfFile As String
Dim file As Stream
Dim properties As Hashtable
Dim createdBy As SPUser
Dim modifiedBy As SPUser
Dim timeCreated As DateTime
Dim timeLastModified As DateTime
Dim checkInComment As String
Dim overwrite As Boolean
Dim requireWebFilePermissions As Boolean
Dim returnValue As SPFile

returnValue = instance.Add(urlOfFile, _
    file, properties, createdBy, modifiedBy, _
    timeCreated, timeLastModified, checkInComment, _
    overwrite, requireWebFilePermissions)

public SPFile Add(
    string urlOfFile,
    Stream file,
    Hashtable properties,
    SPUser createdBy,
    SPUser modifiedBy,
    DateTime timeCreated,
    DateTime timeLastModified,
    string checkInComment,
    bool overwrite,
    bool requireWebFilePermissions
)

參數

• urlOfFile
  Type: System.String

  String ，指定檔案的 URL。

• file
  Type: System.IO.Stream

  Stream物件，包含檔案。

• properties
  Type: System.Collections.Hashtable

  Hashtable物件，包含檔案的中繼資料。

• createdBy
  Type: Microsoft.SharePoint.SPUser

  SPUser物件，表示建立檔案的使用者。

• modifiedBy
  Type: Microsoft.SharePoint.SPUser

  SPUser物件，表示上次修改檔案的使用者。

• timeCreated
  Type: System.DateTime

  指定檔案建立時的DateTime值。

• timeLastModified
  Type: System.DateTime

  指定上次修改檔案的DateTime值。

• checkInComment
  Type: System.String

  包含在簽入註解集合中建立檔案時要使用String 。這個方法會使用遷移語意，而且一定會建立在已簽入的狀態。

• overwrite
  Type: System.Boolean

  若要覆寫相同的名稱，檔案的true否則， false。

• requireWebFilePermissions
  Type: System.Boolean

  true來指示新增 Web 檔案需要 [新增及自訂網頁的權限 ；否則， false。預設值為true。

傳回值

Type: Microsoft.SharePoint.SPFile
SPFile 物件，表示該檔案。

備註

只有overwrite參數是true，則這個方法會覆寫相同名稱的任何檔案。

請參閱

參照

SPFileCollection class

SPFileCollection members

Add overload

Microsoft.SharePoint namespace