Share via


SPFile class

Representa um arquivo em um site do SharePoint que pode ser um Web Parts page, um item em uma biblioteca de documentos ou um arquivo em uma pasta.

Inheritance hierarchy

System.Object
  Microsoft.SharePoint.SPFile

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

Syntax

'Declaração
Public Class SPFile
'Uso
Dim instance As SPFile
public class SPFile

Comentários

Use o método GetFile ou GetFileAsString da classe SPWeb para retornar um objeto de arquivo único. Caso contrário, use a propriedade Files da classe a SPWeb ou SPFolder para retornar um objeto SPFileCollection que representa a coleção de arquivos de um site ou uma pasta. Use um indexador para retornar um único arquivo da coleção. Por exemplo, se a coleção for atribuída a uma variável chamada collFiles, use collFiles[index] em C# ou deindexde collFiles() no Visual Basic, onde index é o número de índice do arquivo na coleção, o nome do arquivo incluindo a extensão, ou um site da Web relativo, URL relativo ou absoluto do conjunto de sites.

Examples

Este exemplo adiciona um arquivo da biblioteca de documentos de um local para a biblioteca de documentos de documentos compartilhados de outro site e seus subsites.

Para obter um exemplo que mostra como carregar um arquivo local para uma pasta em um site do SharePoint por meio de programação, consulte 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();

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.

Thread safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Ver também

Referência

SPFile members

Microsoft.SharePoint namespace