Compartilhar via


SPAttachmentCollection.Add method

Adiciona o anexo é representado pelo array de byte e de nome de arquivo especificado para o item da lista.

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

Syntax

'Declaração
Public Sub Add ( _
    leafName As String, _
    data As Byte() _
)
'Uso
Dim instance As SPAttachmentCollection
Dim leafName As String
Dim data As Byte()

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

Parâmetros

  • leafName
    Type: System.String

    O nome do arquivo a ser adicionado.

  • data
    Type: []

    Uma matriz de bytes que contém o anexo.

Exceptions

Exception Condition
ArgumentNullException

data é null .

SPException

O nome do arquivo já existe na coleção.

Comentários

Adicionar um novo anexo com este método requer que você atualize o item da lista usando o método Update .

Examples

O exemplo de código a seguir mostra como adicionar um anexo de arquivo a um item da lista.

Uma vez que o método Add exige que você passe o arquivo em formato binário como um parâmetro, o exemplo usa o método OpenBinary da classe SPFile para abrir cada arquivo dentro da pasta em formato binário.

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

Dica

Determinados objetos implementam a interface IDisposable , e você deve evitar reter esses objetos na memória depois que eles não são mais necessários. Para obter informações sobre boas práticas de codificação, consulte Disposing Objects.

Ver também

Referência

SPAttachmentCollection class

SPAttachmentCollection members

Microsoft.SharePoint namespace