Compartilhar via


SPFileCollection.Item property (String)

Obtém o objeto de arquivo com o URL especificado da coleção. No Microsoft Visual C#, esta propriedade é um indexador para a classe SPFileCollection .

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

Syntax

'Declaração
Public ReadOnly Default Property Item ( _
    urlOfFile As String _
) As SPFile
    Get
'Uso
Dim instance As SPFileCollection
Dim urlOfFile As String
Dim value As SPFile

value = instance(urlOfFile)
public SPFile this[
    string urlOfFile
] { get; }

Parâmetros

  • urlOfFile
    Type: System.String

    A URL do site relativo do arquivo.

Property value

Type: Microsoft.SharePoint.SPFile
Um objeto SPFile que representa o arquivo.

Examples

O exemplo de código a seguir usa o indexador para retornar um objeto de arquivo especificado e exibe o título do arquivo, quando o arquivo foi modificado pela última vez e o nome do usuário que modificou o arquivo.

Este exemplo requer diretivas de using (Imports no Visual Basic) para os namespaces Microsoft.SharePoint e Microsoft.SharePoint.Utilities .

O exemplo também pressupõe a existência de uma página. aspx que contém um controle label.

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;

O exemplo de código a seguir usa o indexador para copiar um arquivo de uma biblioteca de documentos em um site para uma biblioteca de documentos em outro site.

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);
}

Dica

Determinados objetos implementam a interface IDisposable , e você deve evitar reter esses objetos na memória depois que eles não são mais necessários. Para obter informações sobre boas práticas de codificação, consulte Disposing Objects.

Ver também

Referência

SPFileCollection class

SPFileCollection members

Item overload

Microsoft.SharePoint namespace