SPFile.CopyTo method (String, Boolean)

Artigo
05/12/2015

Copia o arquivo para o URL de destino e, opcionalmente, substituir um arquivo existente com o mesmo nome.

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

Syntax

'Declaração
Public Sub CopyTo ( _
    strNewUrl As String, _
    bOverWrite As Boolean _
)
'Uso
Dim instance As SPFile
Dim strNewUrl As String
Dim bOverWrite As Boolean

instance.CopyTo(strNewUrl, bOverWrite)

public void CopyTo(
    string strNewUrl,
    bool bOverWrite
)

Parâmetros

strNewUrl
Type: System.String

A URL de destino do novo arquivo.

bOverWrite
Type: System.Boolean

true para substituir um arquivo existente de mesmo nome; Caso contrário, false.

Exceptions

Exception	Condition
SPException	Ocorreu um erro ao copiar o arquivo.

Comentários

O método CopyTo copia os arquivos para outro local no mesmo site. Para copiar arquivos para um local em outro site, use um dos métodos Add da classe SPFileCollection .

Este método retornará um erro se bOverWrite for definido como false e um arquivo com o mesmo nome já existe no novo local.

Examples

O exemplo de código a seguir copia todos os arquivos na biblioteca Documentos compartilhados para outra pasta no mesmo local, substituindo qualquer arquivo com o mesmo nome.

Dim site As SPSite = SPContext.Current.Site
Dim web As SPWeb = site.AllWebs("Site_Name/Subsite_Name")
Dim files As SPFileCollection = web.GetFolder("Shared Documents").Files
Dim intIndex As Integer

For intIndex = 0 To files.Count - 1

    files(intIndex).CopyTo("Destination_DocLib/" & 
        files(intIndex).Name, True)

Next intIndex

SPSite oSiteCollection = SPContext.Current.Site;
using(SPWeb oWebsite = oSite.AllWebs["Site_Name/Subsite_Name"])
{
    SPFileCollection collFiles = oWebsite.GetFolder("Shared 
        Documents").Files;

    for (int intIndex=0; intIndex<collFiles.Count; intIndex++)
    {
        collFiles[intIndex].CopyTo("Destination_DocLib/" + 
            collFiles[intIndex].Name, 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

SPFile class

SPFile members

CopyTo overload

Microsoft.SharePoint namespace

Compartilhar via