HTTPUploadThroughPostEx Method
Description
Uploads the image of a specified index in buffer to the HTTP server as a specified image format through HTTP POST method.
| ActiveX Edition | Plug-in Edition | Mac Edition |
|---|---|---|
| Since V5.0 | Since V5.0 | Since V6.4 |
Syntax
Boolean ObjectName. HTTPUploadThroughPostEx(String HTTPServer, Short sImageIndex, String ActionPage, String FileName, Long ImageType)
Parameters
String HTTPServer: the name of the HTTP server.
Short sImageIndex: specifies the index of image in buffer. The index is 0-based.
String ActionPage: the specified page for posting image files. This is the relative path of the page, not the absolute path. For example: "upload.asp", not "http://www.webserver.com/upload.asp". This is the page corresponds to the action in <form> html tag: <form id = "frmSample" action = "upload.asp" method = post>...</form>
String FileName: the name of the image to be uploaded.
Long ImageType: the image format of the file to be created on the HTTP server.
Return value
Boolean.
TRUE indicates success. FALSE indicates failure.
When an error occurs and IfThrowException property is TRUE, an exception will be thrown.
When FALSE is returned or an exception is thrown, check ErrorCode property and ErrorString property for error information.
Remarks
Dynamic Webcam processes the image format according to the value of the ImageType.
| Allowed Values | ImageType |
| 0 | BMP |
| 1 | JPEG |
| 2 | TIFF |
| 3 | PNG |
| 4 |
The field name of the uploaded image is RemoteFile.
IMPORTANT: Dynamic Webcam uses a special way to see if an image is uploaded and processed successfully by server. If the server returns 0 bytes, indicates success. Otherwise, indicates failure. In other words, when the uploaded image is processed successfully, the action page on the server should not return anything, even the "<html>".
See also
FTPUserName property, FTPPassword property, FTPPort property, ProxyServer property, FTPDownloadEx(), HTTPPort property, HTTPUserName property, HTTPPassword property, HTTPDownloadEx(), HTTPUploadThroughPutEx(), HTTPUploadThroughPostEx()
Sample
...
<script language="javascript" type="text/javascript">
Webcam = document.getElementById("iDynamicWebcam");//iDynamicWebcam is the id of the Dynamic Webcam on the page (An object or an embed).
function btnScan_onclick()
{
Webcam.SelectSource();
Webcam.OpenSource();
Webcam.AcquireImage();
}
function btnUpload_onclick()
{
var strActionPage;
var strHostIP;
var CurrentPathName = unescape(location.pathname); // get current PathName in plain ASCII
var CurrentPath = CurrentPathName.substring(0, CurrentPathName.lastIndexOf("/") + 1);
strActionPage = CurrentPath + "SaveToFile.aspx"; //the ActionPage's file path
strHostIP = "localhost"; //The host's IP or name
Webcam.HTTPPort = 80;
Webcam.HTTPUploadThroughPostEx(strHostIP,0,strActionPage,"imageData.jpg",1);
if (Webcam.ErrorCode != 0)
alert(Webcam.ErrorString);
else //succeded
alert("Image Uploaded successfully");
}
</script>
...
SaveToFile.aspx:
<%@ Page Language="c#" AutoEventWireup="false" Debug="True"%>
<%
HttpFileCollection files = HttpContext.Current.Request.Files;
HttpPostedFile uploadfile = files["RemoteFile"];
uploadfile.SaveAs(System.Web.HttpContext.Current.Request.MapPath(".") + "/" + uploadfile.FileName);
%>