del método SPAttachmentCollection.Add
Agrega los datos adjuntos que está representado por la matriz de bytes y de nombre de archivo especificado para el elemento de lista.
Espacio de nombres: Microsoft.SharePoint
Ensamblado: Microsoft.SharePoint (en Microsoft.SharePoint.dll)
Sintaxis
'Declaración
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
Tipo: System.StringEl nombre del archivo que se va a agregar.
data
Tipo: []Una matriz de bytes que contiene los datos adjuntos.
Excepciones
Excepción | Condición |
---|---|
ArgumentNullException | data es nulo . |
SPException | El nombre de archivo ya existe en la colección. |
Comentarios
Agregar nuevos datos adjuntos con este método requiere que actualice el elemento de lista con el método Update .
Ejemplos
En el ejemplo de código siguiente se muestra cómo agregar un archivo adjunto a un elemento en la lista de anuncios.
Dado que el método Add requiere que pase el archivo en formato binario como un parámetro, el ejemplo utiliza el método OpenBinary de la clase SPFile para abrir cada archivo dentro de la carpeta en formato binario.
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();
}
Nota
Determinados objetos implementan la interfaz de IDisposable y, a continuación, se debe evitar la conservación de estos objetos en la memoria que ya no se necesitan. Para obtener información acerca de buenas prácticas de codificación, vea Disposing Objects.