SPFile.CopyTo method (String)

Artigo
05/12/2015

Copia o arquivo para o URL de destino, mas não substitui 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 _
)
'Uso
Dim instance As SPFile
Dim strNewUrl As String

instance.CopyTo(strNewUrl)

public void CopyTo(
    string strNewUrl
)

Parâmetros

strNewUrl
Type: System.String

A URL de destino.

Exceptions

Exception	Condition
SPException	Ocorreu um erro ao copiar o arquivo.

Comentários

O método CopyTo copia os arquivos para outro local dentro do 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 já existir um arquivo com o mesmo nome no novo local. Para copiar um arquivo e substituir um arquivo existente, ligue para CopyTo(String, Boolean) com strNewUrl e true.

Examples

O exemplo de código a seguir copia arquivos de uma biblioteca de documentos em outro, se os arquivos são verificados para a biblioteca original com o comentário "Complete".

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

For intIndex = 0 To files.Count - 1

    If files(intIndex).CheckInComment = "Complete" Then
        files(intIndex).CopyTo("Destination_DocLibrary/" & 
        files(intIndex).Name)
    End If

Next intIndex

SPSite oSiteCollection = SPContext.Current.Site;
using(SPWeb oWebsite = oSiteCollection.AllWebs["Site_Name"])
{
    SPFileCollection collFiles =   
        oWebsite.GetFolder("Source_DocLibrary").Files;

    for (int intIndex=0; i<collFiles.Count; intIndex++)
    {
        if (collFiles[intIndex].CheckInComment == "Complete")
        {
            colFiles[intIndex].CopyTo("Destination_DocLibrary/" + 
                colFiles[intIndex].Name);
        }
    }
}

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