Freigeben über


SPAttachmentCollection.Add-Methode

Fügt die Anlage, die durch die angegebene Datei Namen und Byte-Array, das Listenelement dargestellt wird.

Namespace:  Microsoft.SharePoint
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'Declaration
Public Sub Add ( _
    leafName As String, _
    data As Byte() _
)
'Usage
Dim instance As SPAttachmentCollection
Dim leafName As String
Dim data As Byte()

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

Parameter

  • data
    Typ: []

    Ein Bytearray, die die Anlage enthält.

Ausnahmen

Ausnahme Bedingung
ArgumentNullException

data ist Null .

SPException

Der Dateiname ist bereits in der Auflistung vorhanden.

Hinweise

Hinzufügen einen neuen Anhang mit dieser Methode erfordert, dass Sie das Listenelement mit der Update -Methode zum Aktualisieren.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Dateianlage für ein Element in der Liste mit Ankündigungen hinzu.

Da die Add -Methode erfordert, dass Sie die Datei im Binärformat als Parameter übergeben, verwendet das Beispiel die OpenBinary -Methode der SPFile -Klasse zum Öffnen von jeder Datei in den Ordner im Binärformat.

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

Hinweis

Bestimmte Objekte, die IDisposable -Schnittstelle implementieren, und müssen Sie vermeiden, diese Objekte im Arbeitsspeicher beibehalten, wenn sie nicht mehr benötigt werden. Informationen zu bewährten Codierung finden Sie unter Disposing Objects.

Siehe auch

Referenz

SPAttachmentCollection Klasse

SPAttachmentCollection-Member

Microsoft.SharePoint-Namespace