SPFileCollection.Add method (String, Byte[])

Artigo
05/12/2015

Cria um arquivo na coleção usando a URL especificada e uma matriz de bytes que contém o arquivo.

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

Syntax

'Declaração
Public Function Add ( _
    urlOfFile As String, _
    file As Byte() _
) As SPFile
'Uso
Dim instance As SPFileCollection
Dim urlOfFile As String
Dim file As Byte()
Dim returnValue As SPFile

returnValue = instance.Add(urlOfFile, _
    file)

public SPFile Add(
    string urlOfFile,
    byte[] file
)

Parâmetros

urlOfFile
Type: System.String

A URL do site relativo do arquivo.

file
Type: []

Uma matriz de bytes que contém o arquivo.

Valor retornado

Type: Microsoft.SharePoint.SPFile
O arquivo adicionado mais recentemente.

Examples

O exemplo de código a seguir usa o método Add para copiar um arquivo de uma biblioteca de documentos para a pasta Documentos compartilhados de cada subsite em um site da Web especificado. Se um arquivo com o mesmo nome já existir, o método Add lança uma exceção.

Dim SiteCollection As New SPSite("http://MySiteCollection")
Try
    Dim webSite As SPWeb = siteCollection.AllWebs("MyWebSite")
    Dim destSites As SPWebCollection = webSite.Webs

    Dim srcFile As SPFile = webSite.GetFile("MyDocLib/MyFile")

    Dim destSite As SPWeb
    For Each destSite In  destSites
        Dim destFolder As SPFolder = destSite.GetFolder("Shared Documents")
        Dim destFiles As SPFileCollection = destFolder.Files

        Dim destURL As String = destFolder.Url + "/" + srcFile.Name
        Dim binFile As Byte() = srcFile.OpenBinary()

        destFiles.Add(destURL, binFile)
    Next destSite
Finally
    SiteCollection.Dispose()
End Try

using (SPSite oSiteCollection = new SPSite("https://localhost"))
{
    using(SPWeb oWebsite = oSiteCollection.AllWebs["MyWebSite"])
    {
        SPWebCollection collWebsites = oWebsite.Webs;
        SPFile oFile = oWebsite.GetFile("MyDocLib/MyFile");
        foreach (SPWeb oWebsiteNext in collWebsites)
        {
            SPFolder oFolder = oWebsiteNext.GetFolder("Shared Documents");
            SPFileCollection collFiles = oFolder.Files;

            string strDestUrl = oFolder.Url + "/" + oFile.Name;
            byte[] binFile = oFile.OpenBinary();
            collFiles.Add(strDestUrl, binFile);

            oWebsiteNext.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.

Ver também

Referência

SPFileCollection class

SPFileCollection members

Add overload

Microsoft.SharePoint namespace

Compartilhar via