SPAttachmentCollection.AddNow-Methode

Artikel
05/06/2015

Die Anlage, die durch die angegebene Datei Namen und Byte-Array auf das Listenelement dargestellt wird, ohne dass ein Update auf dem übergeordneten Element hinzufügt.

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

Syntax

'Declaration
Public Function AddNow ( _
    leafName As String, _
    data As Byte() _
) As String
'Usage
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
)

Parameter

leafName
Typ: System.String

Eine Zeichenfolge, die den Namen der Datei anfügen angibt.

data
Typ: []

Ein Byte-Array, das die Datei als Anlage enthält.

Rückgabewert

Typ: System.String
Eine Zeichenfolge, die die URL der Anlage enthält.

Hinweise

Wenn Sie über die AddNow -Methode eine Anlage hinzufügen, erfordert die Änderung wird sofort wirksam in der Datenbank und keine Aktualisieren des Listenelements, um die Version zu aktualisieren. Jedoch die Anlage ist nicht sofort auf der aktuellen Anlage-Auflistungsobjekt hinzugefügt, und Sie müssen die Attachments -Eigenschaft des Listenelements, das die aktualisierte Anlagenauflistung abzurufen aufrufen.

Beispiele

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

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

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

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

Freigeben über