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
leafName
Type : System.StringLe nom du fichier à ajouter.
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.