SPFileCollection.Item property (String)

從集合中取得具有指定 URL 的檔案物件。在 [Microsoft 視覺化 C#，這個屬性會是SPFileCollection類別的索引子。

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

Syntax

'宣告
Public ReadOnly Default Property Item ( _
    urlOfFile As String _
) As SPFile
    Get
'用途
Dim instance As SPFileCollection
Dim urlOfFile As String
Dim value As SPFile

value = instance(urlOfFile)

public SPFile this[
    string urlOfFile
] { get; }

參數

• urlOfFile
  Type: System.String

  檔案的站台相對 URL。

Property value

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

Examples

下列程式碼範例會使用索引子，傳回指定的檔案物件並顯示檔案的標題，當上次修改檔案，以及修改檔案的使用者名稱。

這個範例要求using指示詞 (在 Visual Basic 的Imports ) 的Microsoft.SharePoint和Microsoft.SharePoint.Utilities命名空間。

該範例也假設包含一個標籤控制項的.aspx 網頁的存在。

Dim webSite As SPWeb = SPContext.Current.Web
Try
    Dim srcFile As SPFile = webSite.GetFolder("MyDocLib").Files("MyFile")

    Label1.Text = SPEncode.HtmlEncode(srcFile.Title) + " :: " + srcFile.TimeLastModified + " :: " + srcFile.ModifiedBy.Name
Finally
    webSite.Dispose()
End Try

SPWeb oWebsite = SPContext.Current.Web;
SPFile oFile = oWebsite.GetFolder("MyDocLib").Files["MyFile"];

Label1.Text = SPEncode.HtmlEncode(oFile.Title) + " :: " + 
    oFile.TimeLastModified + " :: " + oFile.ModifiedBy.Name;

下一步的程式碼範例會使用索引子，將檔案從一個網站中的文件庫複製到另一個網站中的文件庫。

Dim siteCollection As New SPSite("http://MySiteCollection")
Try
    Dim destFiles As SPFileCollection = siteCollection.AllWebs("DestinWebSite").GetFolder("DestinDocLib").Files
    Dim srcFile As SPFile = siteCollection.AllWebs("SourceWebSite").GetFolder("SourceDocLib").Files("MyFile")

    Dim copyFile As Byte() = srcFile.OpenBinary()
        destFiles.Add(srcFile.Title, copyFile)
Finally
    srcSiteCollection.Dispose()
End Try

using (SPSite oSiteCollection = new SPSite("https://localhost"))
{
    SPFileCollection collFiles = oSiteCollection.AllWebs["DestWebSite"].GetFolder("DestDocLib").Files;
    SPFile oFile = siteCollection.AllWebs["SourceWebSite"].GetFolder("SourceDocLib").Files["MyFile"];
    byte[] binCopyFile = oFile.OpenBinary();
    collFiles.Add(oFile.Title, strCopyFile);
}

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

請參閱

參照

SPFileCollection class

SPFileCollection members

Item overload

Microsoft.SharePoint namespace