(String, Byte[], Boolean) del método SPFileCollection.Add

Crea un archivo de la colección utilizando la dirección URL especificada, una matriz de bytes que contiene el contenido de un archivo y un valor booleano que especifica si desea para sobrescribir cualquier archivo que tiene el mismo nombre.

Espacio de nombres:  Microsoft.SharePoint
Ensamblado:  Microsoft.SharePoint (en Microsoft.SharePoint.dll)

Sintaxis

'Declaración
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
  Tipo: System.String

  Dirección URL relativa del sitio del archivo.

• file
  Tipo: []

  Una matriz de bytes que contiene el archivo.

• overwrite
  Tipo: System.Boolean

  true para sobrescribir un archivo del mismo nombre; en caso contrario, false.

Valor devuelto

Tipo: Microsoft.SharePoint.SPFile
El archivo recién agregado.

Ejemplos

En el ejemplo de código siguiente se recorre en iteración la colección de archivos en una biblioteca de documentos de un sitio y, si el comentario de un archivo está "acabado", copia el archivo en una carpeta 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);
        }
    }
}

Nota

Algunos objetos que implementan la interfaz de IDisposable y se debe evitar mantener estos objetos en la memoria cuando ya no son necesarios. Para obtener información sobre buenas prácticas de codificación, vea Disposing Objects.

Vea también

Referencia

clase SPFileCollection

Miembros SPFileCollection

Sobrecarga Add

Espacio de nombres Microsoft.SharePoint