SPFileCollection.Add - Méthode (String, Byte[], Boolean)

Crée un fichier dans la collection à l'aide de l'URL spécifiée, un tableau d'octets qui contient le contenu d'un fichier et une valeur booléenne qui spécifie si pour remplacer tout fichier portant le même nom.

Espace de noms :  Microsoft.SharePoint
Assembly :  Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

Syntaxe

'Déclaration
Public Function Add ( _
    urlOfFile As String, _
    file As Byte(), _
    overwrite As Boolean _
) As SPFile
'Utilisation
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
)

Paramètres

• urlOfFile
  Type : System.String

  L'URL relative au site du fichier.

• file
  Type : []

  Un tableau d'octets qui contient le fichier.

• overwrite
  Type : System.Boolean

  true pour remplacer un fichier portant le même nom ; dans le cas contraire, false.

Valeur renvoyée

Type : Microsoft.SharePoint.SPFile
Le fichier nouvellement ajouté.

Exemples

L'exemple de code suivant parcourt la collection de fichiers dans une bibliothèque de documents d'un site et, si le commentaire de l'archivage d'un fichier est « terminé », copie le fichier dans un dossier spécifié.

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);
        }
    }
}

Voir aussi

Référence

SPFileCollection classe

SPFileCollection - Membres

Add - Surcharge

Microsoft.SharePoint - Espace de noms