SPFile class

發行項
05/05/2015

表示可以是Web Parts pageSharePoint 網站中的檔案、文件庫中的項目或資料夾中的檔案。

Inheritance hierarchy

System.Object
Microsoft.SharePoint.SPFile

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

Syntax

'宣告
Public Class SPFile
'用途
Dim instance As SPFile

public class SPFile

備註

使用SPWeb類別的GetFile或GetFileAsString方法來傳回單一檔案的物件。否則，請使用SPWeb或SPFolder類別的Files屬性來傳回SPFileCollection物件，表示網站或資料夾的檔案集合。若要從集合傳回單一檔案中使用索引子。例如，如果集合指派給一個名為collFiles變數中，使用在 C# 的collFiles[index]或 Visual Basic，其中index是索引數字的集合，包括副檔名或網站的位置相對，網站集合的相對或絕對 URL 的檔案名稱中的檔案中的collFiles(index) 。

Examples

本範例會加入另一個站台及子網站的「共用文件文件庫從文件庫的一個站台的檔案。

如需範例，示範如何以程式設計方式將本機檔案上載至 SharePoint 網站上的資料夾，請參閱How to: Upload a File to a SharePoint Site from a Local Folder。

Dim siteCollection As SPSite = SPContext.Current.Site
Dim srcSite As SPWeb = siteCollection.AllWebs("Source_Site_Name")
Dim destSites As SPWebCollection = 
    siteCollection.AllWebs("Destination_Site_Name").Webs

Dim srcFile As SPFile = 
    srcSite.GetFile("Source_Folder_Name/Source_File")
Dim fileName As String = srcFile.Name
Dim binFile As Byte() = srcFile.OpenBinary()

Dim destSite As SPWeb

For Each destSite In  destSites

    If destSite.GetFolder("Shared Documents").Exists Then

        Dim destFolder As SPFolder = 
            destSite.GetFolder("Shared Documents")

        destFolder.Files.Add(fileName, binFile, True)

    End If

Next destSite

SPSite oSiteCollection = SPContext.Current.Site;
SPWeb oWebsiteSrc = oSiteCollection.AllWebs["Source_Site_Name"];
SPWebCollection collWebsites = 
    oSiteCollection.AllWebs["Destination_Site_Name"].Webs;

SPFile oFile = oWebsiteSrc.GetFile("Source_Folder_Name/Source_File");
string strFilename = oFile.Name;
byte[] binFile = oFile.OpenBinary();

foreach (SPWeb oWebsite in collWebsites)
{
    if (oWebsite.GetFolder("Shared Documents").Exists)
    {
        SPFolder oFolder = oWebsite.GetFolder("Shared Documents");
        oFolder.Files.Add(strFilename, binFile, true);
    }
    oWebsite.Dispose(); 
}
oWebsiteSrc.Dispose();

注意事項
某些物件實作IDisposable介面，並且您必須避免之後不再需要保留這些物件在記憶體中。良好的程式碼撰寫方式的相關資訊，請參閱Disposing Objects。