SPFileCollection.Add 方法 (String, Byte[], Boolean)

使用指定的 URL、 一个字节数组,包含一个文件,文件的内容和一个布尔值,指定是否覆盖任何文件具有相同的名称在集合中创建的文件。

命名空间:  Microsoft.SharePoint
程序集:  Microsoft.SharePoint(位于 Microsoft.SharePoint.dll 中)

语法

声明
Public Function Add ( _
    urlOfFile As String, _
    file As Byte(), _
    overwrite As Boolean _
) As SPFile
用法
Dim instance As SPFileCollection
Dim urlOfFile As String
Dim file As Byte()
Dim overwrite As Boolean
Dim returnValue As SPFile

returnValue = instance.Add(urlOfFile, _
    file, overwrite)
public SPFile Add(
    string urlOfFile,
    byte[] file,
    bool overwrite
)

参数

  • urlOfFile
    类型:System.String

    文件相对于网站的 URL。

  • file
    类型:[]

    一个字节数组,包含的文件。

  • overwrite
    类型:System.Boolean

    true 覆盖的文件相同的名称 ;否则为 false。

返回值

类型:Microsoft.SharePoint.SPFile
新添加的文件。

示例

下面的代码示例循环访问该集合的一个站点的文档库中的文件,如果文件的签入注释"完成",将该文件复制到指定的文件夹。

Dim SiteCollection As New SPSite("http://MySiteCollection")
Try
    Dim srcFolder As SPFolder = siteCollection.AllWebs("MySourceWebSite").GetFolder("MySourceLib")

    Dim destFiles As SPFileCollection = siteCollection.AllWebs("MyDestWebSite").GetFolder("MyDestFolder").Files

    Dim srcFile As SPFile
    For Each srcFile In  srcFolder.Files
        If srcFile.CheckInComment = "Finished" Then
            Dim destURL As String = destFiles.Folder.Url + "/" + srcFile.Name
            Dim binFile As Byte() = srcFile.OpenBinary()

            destFiles.Add(destURL, binFile, True)
        End If
    Next srcFile
Finally
    SiteCollection.Dispose()
End Try
using (SPSite oSiteCollection = new SPSite("https://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);
        }
    }
}

备注

某些对象实现IDisposable接口,并必须避免后不再需要保留这些对象在内存中。好的编码做法有关的信息,请参阅Disposing Objects

另请参阅

引用

SPFileCollection 类

SPFileCollection 成员

Add 重载

Microsoft.SharePoint 命名空间