Partager via


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

Crée un fichier dans la collection à l'aide de l'URL spécifiée et un tableau d'octets qui contient le fichier.

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

Syntaxe

'Déclaration
Public Function Add ( _
    urlOfFile As String, _
    file As Byte() _
) As SPFile
'Utilisation
Dim instance As SPFileCollection
Dim urlOfFile As String
Dim file As Byte()
Dim returnValue As SPFile

returnValue = instance.Add(urlOfFile, _
    file)
public SPFile Add(
    string urlOfFile,
    byte[] file
)

Paramètres

  • urlOfFile
    Type : System.String

    L'URL relative au site du fichier.

  • file
    Type : []

    Un tableau d'octets qui contient le fichier.

Valeur renvoyée

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

Exemples

L'exemple de code suivant utilise la méthode Add pour copier un fichier à partir d'une bibliothèque de documents dans le dossier Documents partagés de chaque sous-site sous un site Web spécifié. Si un fichier du même nom existe déjà, la méthode Add lève une exception.

Dim SiteCollection As New SPSite("http://MySiteCollection")
Try
    Dim webSite As SPWeb = siteCollection.AllWebs("MyWebSite")
    Dim destSites As SPWebCollection = webSite.Webs

    Dim srcFile As SPFile = webSite.GetFile("MyDocLib/MyFile")

    Dim destSite As SPWeb
    For Each destSite In  destSites
        Dim destFolder As SPFolder = destSite.GetFolder("Shared Documents")
        Dim destFiles As SPFileCollection = destFolder.Files

        Dim destURL As String = destFolder.Url + "/" + srcFile.Name
        Dim binFile As Byte() = srcFile.OpenBinary()

        destFiles.Add(destURL, binFile)
    Next destSite
Finally
    SiteCollection.Dispose()
End Try
using (SPSite oSiteCollection = new SPSite("https://localhost"))
{
    using(SPWeb oWebsite = oSiteCollection.AllWebs["MyWebSite"])
    {
        SPWebCollection collWebsites = oWebsite.Webs;
        SPFile oFile = oWebsite.GetFile("MyDocLib/MyFile");
        foreach (SPWeb oWebsiteNext in collWebsites)
        {
            SPFolder oFolder = oWebsiteNext.GetFolder("Shared Documents");
            SPFileCollection collFiles = oFolder.Files;

            string strDestUrl = oFolder.Url + "/" + oFile.Name;
            byte[] binFile = oFile.OpenBinary();
            collFiles.Add(strDestUrl, binFile);

            oWebsiteNext.Dispose();
        }
    }
}

Notes

Certains objets implémentent l'interface IDisposable , et vous devez éviter de conserver ces objets dans la mémoire après que qu'ils ne sont plus nécessaires. Pour plus d'informations sur les bonnes pratiques de codage, consultez Disposing Objects.

Voir aussi

Référence

SPFileCollection classe

SPFileCollection - Membres

Add - Surcharge

Microsoft.SharePoint - Espace de noms