SPAttachmentCollection.AddNow - Méthode

Article
05/12/2015

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 sans nécessiter une mise à jour à l'élément parent.

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

Syntaxe

'Déclaration
Public Function AddNow ( _
    leafName As String, _
    data As Byte() _
) As String
'Utilisation
Dim instance As SPAttachmentCollection
Dim leafName As String
Dim data As Byte()
Dim returnValue As String

returnValue = instance.AddNow(leafName, _
    data)

public string AddNow(
    string leafName,
    byte[] data
)

Paramètres

leafName
Type : System.String

Chaîne qui spécifie le nom du fichier à joindre.

data
Type : []

Un tableau d'octets qui contient le fichier à joindre.

Valeur renvoyée

Type : System.String
Chaîne qui contient l'URL de la pièce jointe.

Remarques

Si vous ajoutez une pièce jointe par le biais de la méthode AddNow , la modification prend immédiatement effet dans la base de données et ne nécessite pas de mise à jour de l'élément de liste afin d'actualiser les informations de version. Toutefois, la pièce jointe n'est pas immédiatement ajoutée à la collection d'objets pièce jointe en cours, et vous devez appeler la propriété Attachments de l'élément de liste pour obtenir la collection de pièces jointes mises à jour.

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 AddNow 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.

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"];
    SPListItemCollection collItem = oList.Items;
    SPListItem oListItem = collItem[5];

    SPAttachmentCollection collAttachments = 
         oListItem.Attachments;

    string strFileName = oFile.Name;

    byte[] binFile = oFile.OpenBinary();

    collAttachments.AddNow(strFileName, binFile);
}

Dim oSiteCollection As SPSite = SPContext.Current.Site
Using oWebsite As SPWeb = oSiteCollection.AllWebs("Site_Name")
    Dim oFile As SPFile = oWebsite.Folders("Folder_Name").Files("File_Name")

    Dim oList As SPList = oWebsite.Lists("Announcements")
    Dim collItem As SPListItemCollection = oList.Items
    Dim oListItem As SPListItem = collItem(5)

    Dim collAttachments As SPAttachmentCollection = oListItem.Attachments

    Dim strFileName As String = oFile.Name

    Dim binFile() As Byte = oFile.OpenBinary()

    collAttachments.AddNow(strFileName, binFile)
End Using

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

Partager via