Share via


SPAttachmentCollection.Add - Méthode

Ajoute la pièce jointe qui est représentée par le tableau d'octets et de nom de fichier spécifié pour l'élément de liste.

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

Syntaxe

'Déclaration
Public Sub Add ( _
    leafName As String, _
    data As Byte() _
)
'Utilisation
Dim instance As SPAttachmentCollection
Dim leafName As String
Dim data As Byte()

instance.Add(leafName, data)
public void Add(
    string leafName,
    byte[] data
)

Paramètres

  • data
    Type : []

    Tableau d'octets qui contient la pièce jointe.

Exceptions

Exception Condition
ArgumentNullException

data est null .

SPException

Le nom de fichier existe déjà dans la collection.

Remarques

Ajout d'une pièce jointe avec cette méthode requiert que vous mettez à jour l'élément de liste à l'aide de la méthode Update .

Exemples

L'exemple de code suivant montre comment ajouter une pièce jointe à un élément dans la liste Annonces.

Étant donné que la méthode Add nécessite que vous passiez le fichier au format binaire sous la forme d'un paramètre, l'exemple utilise la méthode OpenBinary de la classe SPFile pour ouvrir chaque fichier dans le dossier au format binaire.

Dim site As SPSite = SPContext.Current.Site
Dim srcSite As SPWeb = site.AllWebs("Site_Name")
Dim file As SPFile = srcSite.Folders("Folder_Name").Files("File_Name")
Dim list As SPList = srcSite.Lists("Announcements")

Dim listItem As SPListItem = list.Items(5)
Dim attachments As SPAttachmentCollection = listItem.Attachments

Dim fileName As String = file.Name
Dim binFile As Byte() = file.OpenBinary()

attachments.Add(fileName, binFile)

listItem.Update()
SPSite oSiteCollection = SPContext.Current.Site;
using(SPWeb oWebsite = oSiteCollection.AllWebs["Site_Name"])
{
    SPFile oFile = 
        oWebsite.Folders["Folder_Name"].Files["File_Name"];

    SPList oList = oWebsite.Lists["Announcements"];
    SPListItem oListItem = oList.Items[5];

    SPAttachmentCollection collAttachments = oListItem.Attachments;

    string strFileName = oFile.Name;

    byte[] binFile = oFile.OpenBinary();
    collAttachments.Add(strFileName, binFile);
    oListItem.Update();
}

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

SPAttachmentCollection classe

SPAttachmentCollection - Membres

Microsoft.SharePoint - Espace de noms