¡Ayúdanos a traducir esta Web!
English | Castellano

Cómo usar el FileUpload AJAX

HttpPostedFileAJAX

Como previa a la explicación del manejo del HttpPostedFileAJAX, veamos primero qué es el HttpPostedFileAJAX. Pues bien, el HttpPostedFileAJAX es al FileUploadAJAX como el HttpPostedFile clásico es al FileUpload clásico.

Quizás ésta sea la mejor definición conceptual, pero mejor veamos todas sus propiedades para conocerlo mejor y poder entender el ejemplo de gestión y manejo del HttpPostedFileAJAX:
  • FileName: nombre del fichero original, tal y como estaba nombrado en el ordenador del usuario.
  • FileName_SavedAs: path (directorio + nombre) que le hemos dado al fichero al guardarlo en nuestro sistema (aplicable sólo cuando hemos hecho un Save).
  • FileName_Path: path formateado de forma que es accesible mediante HTML normal.
  • ContentType: El content type mime del fichero. Útil para filtrar qué tipo de ficheros vamos a admitir. En todos los ejemplos de esta web se filtran sólo imágenes GIF, cuyo ContentType es "image/gif".
  • Type: es un enumerador "fileType" que supone un apoyo al ContentType para averiguar el tipo de fichero que estamos tratando. Basándose en el ContentType (nunca en la extensión de fichero), nos distingue los siguientes tipos de ficheros:
    • image: un fichero de imagen cualquiera: .gif, .jpg, .png, .bmp, etc.
    • audio: un fichero de audio cualquiera: .mp3, .wav, etc.
    • video: fichero de vídeo en general: .mpg, .avi, etc.
    • text: fichero que puede ser leído como texto. Puede ser un texto plano, un archivo HTML, un CSS, un XML, etc.
    • office: ficheros que pertenecen a la familia de Office: word, excel, power point, access, publisher, project, etc.
    • zip: fichero de compresión de tipo ZIP.
    • application: cuando no es ni ZIP ni Office, pero es una aplicación (en general).
    • others: cuando no es de ningún tipo anterior.
    • unknow: cuando el fichero no tiene ContentType. Por ejemplo, cuando ni tal siquiera se ha cargado el fichero.
  • ContentLength: Longitud en bytes del fichero. También útil para filtrar un tamaño máximo de fichero. En todos los ejemplos de esta Web, se prohiben los ficheros mayores de 5KB
  • responseMessage_Uploaded_Saved: Mensaje que se muestra por pantalla cuando un fichero ha sido correctamente guardado. Por defecto vale:
    "<a href="{3}" target="_blank">{0}</a> (>i>{1}>/i>) {2}KB".
    Donde:
    • {0} = FileName
    • {1} = ContentType
    • {2} = ContentLength
    • {3} = path correspondiente a FileName_SavedAs
  • responseMessage_Uploaded_NotSaved: Mensaje que se muestra por pantalla cuando un fichero NO ha sido correctamente guardado. Por defecto vale:
    "{0} no guardado". Donde {0} = FileName
  • Saved: Booleano que indica si el fichero se ha guardado correctamente o no.
  • Deleted: Booleano que indica si el fichero lo ha borrado el usuario tras haberlo subido.
  • responseMessage_Uploaded: Si no lo hemos modificado, muestra en mensaje que se le va a mostrar al usuario tras haber intentado subir el fichero. Si se ha subido correctamente, valdrá "responseMessage_Uploaded_Saved", si no "responseMessage_Uploaded_NotSaved".