SPFileCollection.Add method (String, Byte[], Boolean)

Artigo
05/12/2015

Cria um arquivo na coleção usando a URL especificada, uma matriz de bytes que contém o conteúdo de um arquivo e um valor booleano que especifica se a substituição de qualquer arquivo que tem o mesmo nome.

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

Syntax

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

returnValue = instance.Add(urlOfFile, _
    file, overwrite)

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

Parâmetros

urlOfFile
Type: System.String

A URL do site relativo do arquivo.

file
Type: []

Uma matriz de bytes que contém o arquivo.

overwrite
Type: System.Boolean

true para sobrescrever um arquivo com o mesmo nome; Caso contrário, false.

Valor retornado

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

Examples

O exemplo de código a seguir itera através da coleção de arquivos em uma biblioteca de documentos de um site e, se o comentário de check-in de um arquivo for "concluído", copia o arquivo para uma pasta especificada.

Dim SiteCollection As New SPSite("http://MySiteCollection")
Try
    Dim srcFolder As SPFolder = siteCollection.AllWebs("MySourceWebSite").GetFolder("MySourceLib")

    Dim destFiles As SPFileCollection = siteCollection.AllWebs("MyDestWebSite").GetFolder("MyDestFolder").Files

    Dim srcFile As SPFile
    For Each srcFile In  srcFolder.Files
        If srcFile.CheckInComment = "Finished" Then
            Dim destURL As String = destFiles.Folder.Url + "/" + srcFile.Name
            Dim binFile As Byte() = srcFile.OpenBinary()

            destFiles.Add(destURL, binFile, True)
        End If
    Next srcFile
Finally
    SiteCollection.Dispose()
End Try

using (SPSite oSiteCollection = new SPSite("https://localhost"))
{
    SPFolder oFolder = oSiteCollection.AllWebs["SourceWebSite"].GetFolder("MySourceLib");
    SPFileCollection collFiles = 
oSiteCollection.AllWebs["DestWebSite"].GetFolder("DestFolder").Files;
    foreach (SPFile oFile in collFiles.Files)
    {
        if (oFile.CheckInComment == "Finished")
        {
            string strDestUrl = collFiles.Folder.Url + 
                "/" + oFile.Name;
            byte[] binFile = oFile.OpenBinary();
            collFiles.Add(strDestUrl, binFile, true);
        }
    }
}

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