Compartir a través de


del método SPAttachmentCollection.AddNow

Agrega los datos adjuntos que está representado por la matriz de bytes y de nombre de archivo especificado para el elemento de lista sin necesidad de realizar una actualización en el elemento de lista primario.

Espacio de nombres:  Microsoft.SharePoint
Ensamblado:  Microsoft.SharePoint (en Microsoft.SharePoint.dll)

Sintaxis

'Declaración
Public Function AddNow ( _
    leafName As String, _
    data As Byte() _
) As String
'Uso
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
)

Parámetros

  • leafName
    Tipo: System.String

    Una cadena que especifica el nombre del archivo que desea adjuntar.

  • data
    Tipo: []

    Una matriz de bytes que contiene el archivo que desea adjuntar.

Valor devuelto

Tipo: System.String
Una cadena que contiene la dirección URL de los datos adjuntos.

Comentarios

Si agrega un archivo adjunto a través del método AddNow , el cambio surte efecto inmediatamente en la base de datos y no es necesario actualizar el elemento de lista para actualizar la información de versión. Sin embargo, los datos adjuntos no se agregan inmediatamente al objeto de colección de datos adjuntos actuales, y debe llamar a la propiedad Attachments del elemento de lista para obtener la colección de datos adjuntos actualizados.

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

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

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.

Vea también

Referencia

clase SPAttachmentCollection

Miembros SPAttachmentCollection

Espacio de nombres Microsoft.SharePoint