上传下载

方法
ClearAllHTTPFormField() FTPDownload()
FTPDownloadDirectly() FTPDownloadEx()
FTPUpload() FTPUploadAllAsMultiPageTIFF()
FTPUploadAllAsPDF() FTPUploadAsMultiPagePDF()
FTPUploadAsMultiPageTIFF() FTPUploadEx()
HTTPDownload() HTTPDownloadDirectly()
HTTPDownloadEx() HTTPUpload()
HTTPUploadAllThroughPostAsMultiPageTIFF() HTTPUploadAllThroughPostAsPDF()
HTTPUploadThroughPost() HTTPUploadThroughPostAsMultiPagePDF()
HTTPUploadThroughPostAsMultiPageTIFF() HTTPUploadThroughPostEx()
SetHTTPFormField() SetUploadSegment()
SetHTTPHeader()
属性
FTPPassword FTPPort
FTPUserName HttpFieldNameOfUploadedImage
HTTPPort HTTPPostResponseString
IfPASVMode IfShowCancelDialogWhenImageTransfer
IfSSL MaxUploadImageSize
事件
OnInternetTransferPercentage

示例代码

以下示例代码演示了如何使用上面的API实现基本上传。

DWObject.HTTPUpload('www.dynamsoft.com/SaveToFile.aspx', [0,1],  EnumDWT_ImageType.IT_PDF, EnumDWT_UploadDataFormat.Binary, 'test.pdf', OnHttpUploadSuccess, OnHttpUploadFailure);
function OnHttpUploadSuccess (httpResponse) {
    console.log("HTTPResponseString: " + httpResponse);
}
function OnHttpUploadFailure (errorCode, errorString, httpResponse) {
    alert("ErrorCode: " + errorCode+ "ErrorString: " + errorString + "HTTPResponseString: " + httpResponse);
}

方法

ClearAllHTTPFormField()
清除所有将在上传时与图像一起发送到服务器的Web表单字段。
语法 .ClearAllHTTPFormField();
参数
返回值 Boolean
示例代码
DWObject.ClearAllHTTPFormField(); 
使用说明
版本信息 v5.0+
FTPDownload()
从指定的FTP服务器下载图像。
语法 .FTPDownload(fTPServer, fTPRemoteFile, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 String fTPServer: FTP服务器.
String fTPRemoteFile: FTP服务器上文件的路径。
以下两个参数是可选的。如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<OnSuccess function> optional optionalAsyncSuccessFunc: 文件下载成功时触发的回调函数。
<OnFailure function> o ptional optionalAsyncFailureFunc: 文件下载失败时触发的回调函数。
请参考函数原型 成功回调或者 失败回调
返回值 Boolean, 仅在同步使用时有效。
示例代码
使用说明 Dynamic Web TWAIN根据fTPRemoteFile的扩展名来决定图像的格式。
版本信息 v4.0+
FTPDownloadDirectly()
直接从指定的FTP服务器下载文件到本地,而无需在Dynamic Web TWAIN中打开它。
语法 .FTPDownloadDirectly(fTPServer, fTPRemoteFile, localFile, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 string fTPServer: FTP服务器。
string fTPRemoteFile: FTP服务器上文件的路径。
string localFile: 下载文件的本地路径。
以下两个参数是可选的。如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<OnSuccess function> optional optionalAsyncSuccessFunc: 文件下载成功时触发的回调函数。
<OnFailure function> optional optionalAsyncFailureFunc: 文件下载失败时触发的回调函数。
请参考函数原型 成功回调 或者 失败回调
返回值 Boolean, 仅在同步使用时有效。
示例代码
使用说明 从技术上讲,此方法可以从FTP服务器下载任何文件。
版本信息 v7.0+
FTPDownloadEx()
从指定的FTP服务器下载图像。
语法 .FTPDownloadEx(fTPServer, fTPRemoteFile, imageType, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 string fTPServer: FTP服务器。
string fTPRemoteFile: FTP服务器上文件的路径。
EnumDWT_ImageType (int) imageType: 图像的格式。
图像格式 对应数值
IT_BMP 0
IT_JPG 1
IT_TIF 2
IT_PNG 3
IT_PDF 4
以下两个参数是可选的。如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<OnSuccess function> optional optionalAsyncSuccessFunc: 文件下载成功时触发的回调函数。
<OnFailure function> optional optionalAsyncFailureFunc: 文件下载失败时触发的回调函数。
请参考函数原型 成功回调 或者 失败回调
返回值 Boolean, 仅在同步使用时有效。
示例代码
使用说明
版本信息 v5.0+
FTPUpload()
将缓冲区中指定索引的图像以指定的图像格式上传到FTP服务器。
语法 .FTPUpload(fTPServer, sImageIndex, fTPRemoteFile, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 String fTPServer: FTP服务器。
Number sImageIndex: 缓冲区中图像的索引。该索引从0开始。
String fTPRemoteFile: 文件名(包含路径)。
以下两个参数是可选的。如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<OnSuccess function> optional optionalAsyncSuccessFunc: 文件上传成功时触发的回调函数。
<OnFailure function> optional optionalAsyncFailureFunc: 文件上传失败时触发的回调函数。
请参考函数原型 成功回调 或者 失败回调
返回值 Boolean, 仅在同步使用时有效。
示例代码
使用说明 Dynamic Web TWAIN根据fTPRemoteFile的扩展名来决定图像的格式。
版本信息 v4.0+
FTPUploadAllAsMultiPageTIFF()
将缓冲区中的所有图像作为TIFF文件上传到指定的FTP服务器。
语法 .FTPUploadAllAsMultiPageTIFF(fTPServer, fileName, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 String fTPServer: FTP服务器。
String fileName: 文件名(包含路径)。
以下两个参数是可选的。如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<OnSuccess function> optional optionalAsyncSuccessFunc: 文件上传成功时触发的回调函数。
<OnFailure function> optional optionalAsyncFailureFunc: 文件上传失败时触发的回调函数。
请参考函数原型 成功回调 或者 失败回调
返回值 Boolean, 仅在同步使用时有效。
示例代码
使用说明
版本信息 v4.0+
FTPUploadAllAsPDF()
将缓冲区中的所有图像作为PDF文件上传到指定的FTP服务器。
语法 .FTPUploadAllAsPDF(fTPServer, fileName, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 String fTPServer: FTP服务器。
String fileName: 文件名(包含路径)。
以下两个参数是可选的。如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<OnSuccess function> optional optionalAsyncSuccessFunc: 文件上传成功时触发的回调函数。
<OnFailure function> optional optionalAsyncFailureFunc: 文件上传失败时触发的回调函数。
请参考函数原型 成功回调 或者 失败回调
返回值 Boolean, 仅在同步使用时有效。
示例代码
使用说明
版本信息 v4.0+
FTPUploadAsMultiPagePDF()
将缓冲区中的选定图像作为PDF文件上传到FTP服务器。
语法 .FTPUploadAsMultiPagePDF(fTPServer, fileName, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 String fTPServer: FTP服务器。
String fileName: 文件名(包含路径)。
以下两个参数是可选的。如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<OnSuccess function> optional optionalAsyncSuccessFunc: 文件上传成功时触发的回调函数。
<OnFailure function> optional optionalAsyncFailureFunc: 文件上传失败时触发的回调函数。
请参考函数原型 成功回调 或者 失败回调
返回值 Boolean, 仅在同步使用时有效。
示例代码
使用说明
版本信息 v6.0+
FTPUploadAsMultiPageTIFF()
将缓冲区中的选定图像作为TIFF文件上传到FTP服务器。
语法 .FTPUploadAsMultiPageTIFF(fTPServer, fileName, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 String fTPServer: FTP服务器。
String fileName: 文件名(包含路径)。
以下两个参数是可选的。如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<OnSuccess function> optional optionalAsyncSuccessFunc: 文件上传成功时触发的回调函数。
<OnFailure function> optional optionalAsyncFailureFunc: 文件上传失败时触发的回调函数。
请参考函数原型 成功回调 或者 失败回调
返回值 Boolean, 仅在同步使用时有效。
示例代码
使用说明
版本信息 v6.0+
FTPUploadEx()
将缓冲区中指定索引的图像以指定的图像格式上传到FTP服务器。
语法 .FTPUploadEx(fTPServer, sImageIndex, fTPRemoteFile, imageType, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 String fTPServer: FTP服务器。
Number sImageIndex: 缓冲区中的图像索引。 该索引从0开始。
String fTPRemoteFile: 文件名(包含路径)。
EnumDWT_ImageType (int) imageType: 图像格式。
图像格式 对应数值
IT_BMP 0
IT_JPG 1
IT_TIF 2
IT_PNG 3
IT_PDF 4
以下两个参数是可选的。 如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<OnSuccess function> optional optionalAsyncSuccessFunc: 文件上传成功时触发的回调函数。
<OnFailure function> optional optionalAsyncFailureFunc: 文件上传失败时触发的回调函数。
请参考函数原型 成功回调 或者 失败回调
返回值 Boolean, 仅在同步使用时有效。
示例代码
使用说明
版本信息 v5.0+
HTTPDownload()
从指定的HTTP服务器下载图像。
语法 .HTTPDownload(hTTPServer, hTTPRemoteFile,[optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 String hTTPServer: HTTP服务器。
String hTTPRemoteFile: HTTP服务器上文件的路径。
以下两个参数是可选的。 如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<OnSuccess function> optional optionalAsyncSuccessFunc:文件下载成功时触发的回调函数。
<OnFailure function> optional optionalAsyncFailureFunc:文件下载失败时触发的回调函数。
请参考函数原型 成功回调 或者 失败回调
返回值 Boolean, 仅在同步使用时有效。
示例代码
/****获取图像image01.png:
 http://www.dynamsoft.com/images/image01.png****/ 
DWObject.HTTPDownload('www.dynamsoft.com','/images/image01.png'); 
使用说明 如果您想使用此方法通过HTTPS上传/下载文件,请不要忘记将IfSSL设置为true并设置正确的HTTPPort。
版本信息 v4.0+
HTTPDownloadDirectly()
直接从指定的HTTP服务器下载文件,而无需在Dynamic Web TWAIN中打开它。
语法 .HTTPDownloadDirectly(hTTPServer, hTTPRemoteFile, localFile, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 String hTTPServer: HTTP服务器。
String hTTPRemoteFile: HTTP服务器上文件的路径,或操作页面的路径(带必要的参数),该页面获取文件流并将其发送回客户端。
String localFile: 下载文件的本地路径。
以下两个参数是可选的。 如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<OnSuccess function> optional optionalAsyncSuccessFunc: 文件下载成功时触发的回调函数。
<OnFailure function> optional optionalAsyncFailureFunc: 文件下载失败时触发的回调函数。
请参考函数原型 成功回调 或者 失败回调
返回值 Boolean, 仅在同步使用时有效。
示例代码
/****获取文件 ducument.txt: http://www.dynamsoft.com/files/ducument.txt****/
/****保存01.txt到 D:/ ****/
DWObject.HTTPDownloadDirectly('www.dynamsoft.com','/files/ducument.txt','D:/01.txt');

/**获取图像image02.jpg:
http://www.dynamsoft.com/images/GetImage.aspx?Index=2&Name=image02.jpg**/
/**保存02.jpg到 D:/temp/02.jpg**/
DWObject.HTTPDownloadDirectly('www.dynamsoft.com', 
'/images/GetImage.aspx?Index=2&Name=image02.jpg','D:/temp/02.jpg');
使用说明 从技术上讲,此方法可以从HTTP服务器下载任何文件。
如果您想使用此方法通过HTTPS上传/下载文件,请不要忘记将IfSSL设置为true并设置正确的HTTPPort。
版本信息 v7.0+
HTTPDownloadEx()
从指定的HTTP服务器下载图像。
语法 .HTTPDownloadEx(hTTPServer, hTTPRemoteFile, imageType, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 String hTTPServer: HTTP服务器的地址。 例如:“www.dynamsoft.com”,“localhost”,“127.0.0.1”。
String hTTPRemoteFile: HTTP服务器上文件的路径,或操作页面的路径(带有必要的参数),该页面获取图像流并将其发送回客户端。
EnumDWT_ImageType (int) imageType: 图像格式。
图像格式 对应数值
IT_BMP 0
IT_JPG 1
IT_TIF 2
IT_PNG 3
IT_PDF 4
以下两个参数是可选的。 如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<OnSuccess function> optional optionalAsyncSuccessFunc: 文件下载成功时触发的回调函数。
<OnFailure function> optional optionalAsyncFailureFunc: 文件下载失败时触发的回调函数。
请参考函数原型 成功回调 或者 失败回调
返回值 Boolean, 仅在同步使用时有效。
示例代码
/****获取图像 image01.png:
http://www.dynamsoft.com/images/image01.png****/
DWObject.HTTPDownloadEx('www.dynamsoft.com',
'/images/image01.png',3);

/**获取image02.jpg:
http://www.dynamsoft.com/images/GetImage.aspx?Index=2&Name=image02.jpg**/
DWObject.HTTPDownloadEx('www.dynamsoft.com', 
'/images/GetImage.aspx?Index=2&Name=image02.jpg',1);
使用说明 如果您想使用此方法通过HTTPS上传/下载文件,请不要忘记将IfSSL设置为true并设置正确的HTTPPort。
版本信息 v5.0+
HTTPUpload()
1. 将缓冲区中指定索引的图像异步上传到HTTP服务器。
1. 或者上传由SetHTTPFormField创建的表单。
语法 1. HTTPUpload(url, indices, enumImageType, dataFormat, fileName, asyncSuccessFunc, asyncFailureFunc);
2. HTTPUpload(url, indices, enumImageType, dataFormat, asyncSuccessFunc, asyncFailureFunc);
3. HTTPUpload(url, asyncSuccessFunc, asyncFailureFunc);
参数 String url: 指定http服务器的名称以及操作页面和文件名。 例如,“www.dynamsoft.com/ActionPageName”。
Array indices: 指定缓冲区中图像的索引。该索引从0开始。
如果EnumDWT_ImageType是IT_BMP / IT_JPG / IT_PNG,由于无法使用多页文件,因此您只能指定一个索引。
EnumDWT_ImageType enumImageType: 指定要上传的文件的格式。
图像格式 对应数值
IT_BMP 0
IT_JPG 1
IT_TIF 2
IT_PNG 3
IT_PDF 4
EnumDWT_UploadDataFormat dataFormat: 指定数据格式,EnumDWT_UploadDataFormat.Binary或EnumDWT_UploadDataFormat.base64。
数据格式 对应数值
BINARY 0
BASE64 1
String fileName: 指定文件名。
<onHttpUploadSuccess function> asyncSuccessFunc: 文件上传成功时触发的回调函数。
<onHttpUploadFailure function> asyncFailureFunc: 文件上传失败时触发的回调函数。
请参考函数原型 上传成功回调 或者 上传失败回调
返回值 Boolean此方法仅用于异步。即使它返回true也不意味着上传成功。
示例代码
DWObject.HTTPUpload('www.dynamsoft.com/SaveToFile.aspx', 
[0,1],  EnumDWT_ImageType.IT_PDF, EnumDWT_UploadDataFormat.Binary, 'test.pdf', 
OnHttpUploadSuccess, OnHttpUploadFailure);
function OnHttpUploadSuccess (httpResponse) {
    console.log("HTTPResponseString: " + httpResponse);
}
function OnHttpUploadFailure (errorCode, errorString, httpResponse) {
    alert("ErrorCode: " +errorCode+ "ErrorString: " +errorString+ 
    "HTTPResponseString: " + httpResponse);
}
使用说明 此方法仅在v12.0及以上的HTML5版本中有效。
版本信息 v12.0+
HTTPUploadAllThroughPostAsMultiPageTIFF()
将缓冲区中的所有图像作为单个TIFF文件上传到指定的HTTP服务器。
语法 .HTTPUploadAllThroughPostAsMultiPageTIFF(hTTPServer, actionPage, fileName, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 String hTTPServer: HTTP服务器的名称。 例如:“www.dynamsoft.com”,“localhost”,“127.0.0.1”。
String actionPage: 服务器上操作页面的相对路径。 操作页面将接收并处理上传的图像流。
String fileName: 文件名。
以下两个参数是可选的。 如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<onHttpUploadSuccess function> optional optionalAsyncSuccessFunc: 文件上传成功时触发的回调函数。
<onHttpUploadFailure function> optional optionalAsyncFailureFunc: 文件上传失败时触发的回调函数。
请参考函数原型 上传成功回调 或者 上传失败回调
返回值 Boolean, 仅在同步使用时有效。
示例代码
function btnScan_onclick() 
{
    if (DWObject) {
        DWObject.SelectSource();
        DWObject.OpenSource();
        DWObject.IfDisableSourceAfterAcquire = true;
        DWObject.AcquireImage();
    }
}

// OnHttpUploadSuccess和OnHttpUploadFailure是回调函数。
function OnHttpUploadSuccess() {
    console.log('successful');
}
function OnHttpUploadFailure(errorCode, errorString, sHttpResponse) {
    alert(errorString + sHttpResponse);
}

function btnUpload_onclick() 
{
    var strHTTPServer = location.hostname; //HTTP服务器的名称。 
    var CurrentPathName = unescape(location.pathname);
    var CurrentPath = CurrentPathName.substring(0, CurrentPathName.lastIndexOf("/") + 1);
    var strActionPage = CurrentPath + "SaveToFile.aspx";
    DWObject.IfSSL = false; // 设置是否使用SSL
    DWObject.HTTPPort = location.port == "" ? 80 : location.port;

    // 将缓冲区中的所有图像作为TIFF文件异步上传到HTTP服务器
    DWObject.HTTPUploadAllThroughPostAsMultiPageTIFF(
      strHTTPServer,
      strActionPage,
      "imageData.tif",
      OnHttpUploadSuccess,
      OnHttpUploadFailure
    );
}
//SaveToFile.aspx:
<%@ Page Language="C#" %>
<%
    try{
        String strImageName;
        HttpFileCollection files = HttpContext.Current.Request.Files;
        HttpPostedFile uploadfile = files["RemoteFile"];
        strImageName = uploadfile.FileName;
        uploadfile.SaveAs(Server.MapPath(".") + "\\UploadedImages\\" + strImageName);
    }
    catch{
    }
%>
使用说明 如果您想使用此方法通过HTTPS上传/下载文件,请不要忘记将IfSSL设置为true并设置正确的HTTPPort。
版本信息 v4.0+
HTTPUploadAllThroughPostAsPDF()
将缓冲区中的所有图像作为PDF文件上传到指定的HTTP服务器。
语法 .HTTPUploadAllThroughPostAsPDF(hTTPServer, actionPage, fileName, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 String hTTPServer: HTTP服务器的名称。 例如:“www.dynamsoft.com”,“localhost”,“127.0.0.1”。
String actionPage: 服务器上操作页面的相对路径。 操作页面将接收并处理上传的图像流。
String fileName: 要保存在服务器上的文件名。
以下两个参数是可选的。 如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<onHttpUploadSuccess function> optional optionalAsyncSuccessFunc: 文件上传成功时触发的回调函数。
<onHttpUploadFailure function> optional optionalAsyncFailureFunc: 文件上传失败时触发的回调函数。
请参考函数原型 上传成功回调 或者 上传失败回调
返回值 Boolean, 仅在同步使用时有效。
示例代码
function btnScan_onclick() 
{
    if (DWObject) {
        DWObject.SelectSource();
        DWObject.OpenSource();
        DWObject.IfDisableSourceAfterAcquire = true;
        DWObject.AcquireImage();
    }
}

// OnHttpUploadSuccess和OnHttpUploadFailure是回调函数。
function OnHttpUploadSuccess() {
    console.log('successful');
}
function OnHttpUploadFailure(errorCode, errorString, sHttpResponse) {
    alert(errorString + sHttpResponse);
}

function btnUpload_onclick() 
{
    var strHTTPServer = location.hostname; //HTTP服务器的名称。 
    var CurrentPathName = unescape(location.pathname);
    var CurrentPath = CurrentPathName.substring(0, CurrentPathName.lastIndexOf("/") + 1);
    var strActionPage = CurrentPath + "SaveToFile.aspx";
    DWObject.IfSSL = false; // 设置是否使用SSL
    DWObject.HTTPPort = location.port == "" ? 80 : location.port;

    // 将Dynamic Web TWAIN查看器中的所有图像作为PDF文件异步上传到HTTP服务器
    DWObject.HTTPUploadAllThroughPostAsPDF(
      strHTTPServer, 
      strActionPage, 
      "imageData.pdf", 
      OnHttpUploadSuccess, 
      OnHttpUploadFailure
    );
}
//SaveToFile.aspx:
<%@ Page Language="C#" %>
<%
    try{
        String strImageName;
        HttpFileCollection files = HttpContext.Current.Request.Files;
        HttpPostedFile uploadfile = files["RemoteFile"];
        strImageName = uploadfile.FileName;
        uploadfile.SaveAs(Server.MapPath(".") + "\\UploadedImages\\" + strImageName);
    }
    catch{
    }
%>
使用说明 如果您想使用此方法通过HTTPS上传/下载文件,请不要忘记将IfSSL设置为true并设置正确的HTTPPort。
版本信息 v5.0+
HTTPUploadThroughPost()
将缓冲区中指定索引的图像上传到指定的HTTP服务器。
语法 .HTTPUploadThroughPost(hTTPServer, sImageIndex, actionPage, fileName, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 String hTTPServer: HTTP服务器的名称。 例如:“www.dynamsoft.com”,“localhost”,“127.0.0.1”。
Number sImageIndex: 缓冲区中的图像索引。 该索引从0开始。
String actionPage: 服务器上操作页面的相对路径。 操作页面将接收并处理上传的图像流。
String fileName: 要保存在服务器上的文件名。
以下两个参数是可选的。 如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<onHttpUploadSuccess function> optional optionalAsyncSuccessFunc: 文件上传成功时触发的回调函数。
<onHttpUploadFailure function> optional optionalAsyncFailureFunc: 文件上传失败时触发的回调函数。
请参考函数原型 上传成功回调 或者 上传失败回调
返回值 Boolean, 仅在同步使用时有效。
示例代码
function btnScan_onclick() 
{
    if (DWObject) {
        DWObject.SelectSource();
        DWObject.OpenSource();
        DWObject.IfDisableSourceAfterAcquire = true;
        DWObject.AcquireImage();
    }
}

// OnHttpUploadSuccess和OnHttpUploadFailure是回调函数。
function OnHttpUploadSuccess() {
    console.log('successful');
}
function OnHttpUploadFailure(errorCode, errorString, sHttpResponse) {
    alert(errorString + sHttpResponse);
}

function btnUpload_onclick() 
{
    var strHTTPServer = location.hostname; //HTTP服务器的名称。 
    var CurrentPathName = unescape(location.pathname);
    var CurrentPath = CurrentPathName.substring(0, CurrentPathName.lastIndexOf("/") + 1);
    var strActionPage = CurrentPath + "SaveToFile.aspx";
    DWObject.IfSSL = false; // 设置是否使用SSL
    DWObject.HTTPPort = location.port == "" ? 80 : location.port;

    // 将Dynamic Web TWAIN查看器中指定索引的图像异步上传到HTTP服务器
    if (document.getElementById("JPEG").checked) {
        DWObject.HTTPUploadThroughPost(
          strHTTPServer, 
          DWObject.CurrentImageIndexInBuffer,               
          strActionPage,              
          "imageData.jpg",              
          OnHttpUploadSuccess,              
          OnHttpUploadFailure
        );
    }
    if (document.getElementById("PNG").checked) {
        DWObject.HTTPUploadThroughPost(
          strHTTPServer,             
          DWObject.CurrentImageIndexInBuffer,             
          strActionPage,            
          "imageData.png",             
          OnHttpUploadSuccess,            
          OnHttpUploadFailure
        );
    }
    if (document.getElementById("BMP").checked) {
        DWObject.HTTPUploadThroughPost(
          strHTTPServer,             
          DWObject.CurrentImageIndexInBuffer,             
          strActionPage,            
          "imageData.bmp",            
          OnHttpUploadSuccess,            
          OnHttpUploadFailure
        );
    }
}
//SaveToFile.aspx:
<%@ Page Language="C#" %>
<%
    try{
        String strImageName;
        HttpFileCollection files = HttpContext.Current.Request.Files;
        HttpPostedFile uploadfile = files["RemoteFile"];
        strImageName = uploadfile.FileName;
        uploadfile.SaveAs(Server.MapPath(".") + "\\UploadedImages\\" + strImageName);
    }
    catch{
    }
%>
使用说明 Dynamic Web TWAIN根据fileName的扩展名处理图像格式。
如果您想使用此方法通过HTTPS上传/下载文件,请不要忘记将IfSSL设置为true并设置正确的HTTPPort。
版本信息 v4.0+
HTTPUploadThroughPostAsMultiPagePDF()
将缓冲区中的选定图像作为PDF文件上传到HTTP服务器。
语法 .HTTPUploadThroughPostAsMultiPagePDF(hTTPServer, actionPage, fileName, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 String hTTPServer: HTTP服务器的名称。 例如:“www.dynamsoft.com”,“localhost”,“127.0.0.1”。
String actionPage: 服务器上操作页面的相对路径。 操作页面将接收并处理上传的图像流。
String fileName: 要保存在服务器上的文件名。
以下两个参数是可选的。 如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<onHttpUploadSuccess function> optional optionalAsyncSuccessFunc: 文件上传成功时触发的回调函数。
<onHttpUploadFailure function> optional optionalAsyncFailureFunc: 文件上传失败时触发的回调函数。
Please refer to the function prototype [onHttpUploadSuccess](onHttpUploadSuccess.md) or [onHttpUploadFailure](onHttpUploadFailure.md).
返回值 Boolean, 仅在同步使用时有效。
示例代码
function btnScan_onclick() 
{
    if (DWObject) {
        DWObject.SelectSourceByIndex(document.getElementById("source").selectedIndex);
        DWObject.OpenSource();
        DWObject.IfDisableSourceAfterAcquire = true;
        DWObject.AcquireImage();
    }
}

// OnHttpUploadSuccess和OnHttpUploadFailure是回调函数。
function OnHttpUploadSuccess() {
    console.log('successful');
}
function OnHttpUploadFailure(errorCode, errorString, sHttpResponse) {
    alert(errorString + sHttpResponse);
}

function btnUpload_onclick() 
{
    var strHTTPServer = location.hostname; //HTTP服务器的名称。 
    var CurrentPathName = unescape(location.pathname);
    var CurrentPath = CurrentPathName.substring(0, CurrentPathName.lastIndexOf("/") + 1);
    var strActionPage = CurrentPath + "SaveToFile.aspx";
    DWObject.IfSSL = false; // 设置是否使用SSL
    DWObject.HTTPPort = location.port == "" ? 80 : location.port;

    DWObject.SelectedImagesCount = 3;
    DWObject.SetSelectedImageIndex(0, 0); // 将第1张图像设置为第1个选定图像。
    DWObject.SetSelectedImageIndex(1, 2); // 将第3张图像设置为第2个选定图像。
    DWObject.SetSelectedImageIndex(2, 4); // 将第5张图像设置为第3个选定图像。
    DWObject.GetSelectedImagesSize(4); // 4 - PDF格式。 以PDF格式计算所选图像的大小。

    // 异步上传所选图像到服务器
    DWObject.HTTPUploadThroughPostAsMultiPagePDF(
      strHTTPServer, 
      strActionPage, 
      "imageData.pdf", 
      OnHttpUploadSuccess, 
      OnHttpUploadFailure
    );
}
//SaveToFile.aspx:
<%@ Page Language="C#" %>
<%
    try{
        String strImageName;
        HttpFileCollection files = HttpContext.Current.Request.Files;
        HttpPostedFile uploadfile = files["RemoteFile"];
        strImageName = uploadfile.FileName;
        uploadfile.SaveAs(Server.MapPath(".") + "\\UploadedImages\\" + strImageName);
    }
    catch{
    }
%>
使用说明 如果您想使用此方法通过HTTPS上传/下载文件,请不要忘记将IfSSL设置为true并设置正确的HTTPPort。
版本信息 v6.0+
HTTPUploadThroughPostAsMultiPageTIFF()
将缓冲区中的选定图像作为TIFF文件上传到HTTP服务器。
语法 .HTTPUploadThroughPostAsMultiPageTIFF(hTTPServer, actionPage, fileName, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 String hTTPServer: HTTP服务器的名称。 例如:“www.dynamsoft.com”,“localhost”,“127.0.0.1”。
String actionPage: 服务器上操作页面的相对路径。 操作页面将接收并处理上传的图像流。
String fileName: 要保存在服务器上的文件名。
以下两个参数是可选的。 如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<onHttpUploadSuccess function> optional optionalAsyncSuccessFunc: 文件上传成功时触发的回调函数。
<onHttpUploadFailure function> optional optionalAsyncFailureFunc: 文件上传失败时触发的回调函数。
请参考函数原型 上传成功回调 或者 上传失败回调
返回值 Boolean, 仅在同步使用时有效。
示例代码
function btnScan_onclick() 
{
    if (DWObject) {
        DWObject.SelectSourceByIndex(document.getElementById("source").selectedIndex);
        DWObject.OpenSource();
        DWObject.IfDisableSourceAfterAcquire = true;
        DWObject.AcquireImage();
    }
}

// OnHttpUploadSuccess和OnHttpUploadFailure是回调函数。
function OnHttpUploadSuccess() {
    console.log('successful');
}
function OnHttpUploadFailure(errorCode, errorString, sHttpResponse) {
    alert(errorString + sHttpResponse);
}

function btnUpload_onclick() 
{
    var strHTTPServer = location.hostname; //HTTP服务器的名称。 
    var CurrentPathName = unescape(location.pathname);
    var CurrentPath = CurrentPathName.substring(0, CurrentPathName.lastIndexOf("/") + 1);
    var strActionPage = CurrentPath + "SaveToFile.aspx";
    DWObject.IfSSL = false; // 设置是否使用SSL
    DWObject.HTTPPort = location.port == "" ? 80 : location.port;

    DWObject.SelectedImagesCount = 3;
    DWObject.SetSelectedImageIndex(0, 0); // 将第1张图像设置为第1个选定图像。
    DWObject.SetSelectedImageIndex(1, 2); // 将第3张图像设置为第2个选定图像。
    DWObject.SetSelectedImageIndex(2, 4); // 将第5张图像设置为第3个选定图像。
    DWObject.GetSelectedImagesSize(2); // 2 - TIFF格式。 以TIFF格式计算所选图像的大小。

    // 异步上传所选图像到服务器
    DWObject.HTTPUploadThroughPostAsMultiPageTIFF(
      strHTTPServer, 
      strActionPage, 
      "imageData.tiff", 
      OnHttpUploadSuccess, 
      OnHttpUploadFailure
    );
}
//SaveToFile.aspx:
<%@ Page Language="C#" %>
<%
    try{
        String strImageName;
        HttpFileCollection files = HttpContext.Current.Request.Files;
        HttpPostedFile uploadfile = files["RemoteFile"];
        strImageName = uploadfile.FileName;
        uploadfile.SaveAs(Server.MapPath(".") + "\\UploadedImages\\" + strImageName);
    }
    catch{
    }
%>
使用说明 如果您想使用此方法通过HTTPS上传/下载文件,请不要忘记将IfSSL设置为true并设置正确的HTTPPort。
版本信息 v6.0+
HTTPUploadThroughPostEx()
以指定的图像格式将缓冲区中指定索引的图像上传到HTTP服务器。
语法 .HTTPUploadThroughPostEx(hTTPServer, sImageIndex, actionPage, fileName, imageType, [optionalAsyncSuccessFunc, optionalAsyncFailureFunc]);
参数 String hTTPServer: HTTP服务器的名称。 例如:“www.dynamsoft.com”,“localhost”,“127.0.0.1”。
Number sImageIndex: 缓冲区中的图像索引。 该索引从0开始。
String actionPage: 服务器上操作页面的相对路径。 操作页面将接收并处理上传的图像流。
String fileName: 要保存在服务器上的文件名。
EnumDWT_ImageType imageType: 图像的格式。
图像格式 对应数值
IT_BMP 0
IT_JPG 1
IT_TIF 2
IT_PNG 3
IT_PDF 4
以下两个参数是可选的。 如果存在任何一个或两者都存在,则该方法是异步的,否则它是同步的。
<onHttpUploadSuccess function> optional optionalAsyncSuccessFunc: 文件上传成功时触发的回调函数。
<onHttpUploadFailure function> optional optionalAsyncFailureFunc: 文件上传失败时触发的回调函数。
请参考函数原型 上传成功回调 或者 上传失败回调
返回值 Boolean, 仅在同步使用时有效。
示例代码
function btnScan_onclick() 
{
    if (DWObject) {
        DWObject.SelectSourceByIndex(document.getElementById("source").selectedIndex);
        DWObject.OpenSource();
        DWObject.IfDisableSourceAfterAcquire = true;
        DWObject.AcquireImage();
    }
}

// OnHttpUploadSuccess和OnHttpUploadFailure是回调函数。
function OnHttpUploadSuccess() {
    console.log('successful');
}
function OnHttpUploadFailure(errorCode, errorString, sHttpResponse) {
    alert(errorString + sHttpResponse);
}

function btnUpload_onclick() 
{
    var strHTTPServer = location.hostname; //HTTP服务器的名称。 
    var CurrentPathName = unescape(location.pathname);
    var CurrentPath = CurrentPathName.substring(0, CurrentPathName.lastIndexOf("/") + 1);
    var strActionPage = CurrentPath + "SaveToFile.aspx";
    DWObject.IfSSL = false; // 设置是否使用SSL
    DWObject.HTTPPort = location.port == "" ? 80 : location.port;

    // 以特定的图像格式将缓冲区中的特定图像异步上传到HTTP服务器
    DWObject.HTTPUploadThroughPostEx(
      strHTTPServer, 
      DWObject.CurrentImageIndexInBuffer, 
      strActionPage, "imageData.jpg", 
      EnumDWT_ImageType.IT_JPG, 
      OnHttpUploadSuccess, 
      OnHttpUploadFailure
    );
}
//SaveToFile.aspx:
<%@ Page Language="C#" %>
<%
    try{
        String strImageName;
        HttpFileCollection files = HttpContext.Current.Request.Files;
        HttpPostedFile uploadfile = files["RemoteFile"];
        strImageName = uploadfile.FileName;
        uploadfile.SaveAs(Server.MapPath(".") + "\\UploadedImages\\" + strImageName);
    }
    catch{
    }
%>
使用说明 如果您想使用此方法通过HTTPS上传/下载文件,请不要忘记将IfSSL设置为true并设置正确的HTTPPort。
版本信息 v5.0+
SetHTTPFormField()
在Web表单中设置一个字段,一旦启动上传,该字段将发送到服务器。 您可以通过多次调用此方法来设置多个字段。
语法 .SetHTTPFormField(fieldName, fieldValue);
.SetHTTPFormField(fieldName, blobValue, optional fileName);
参数 String fieldName: 字段的名称,可以在服务器端用来检索字段值。
String fieldValue: 字段值。
String fieldName: 字段的名称,可以在服务器端用来检索blob.
Blob blobValue: 要上传的二进制数据。
String fileName optional : 在服务器上保存二进制文件时使用的名称。
返回值 Boolean
示例代码
DWObject.ClearAllHTTPFormField();
DWObject.SetHTTPFormField("PDFFileName", "test.pdf");
//获取操作页面路径
var CurrentPathName = unescape(location.pathname); 
var CurrentPath = CurrentPathName.substring(0, CurrentPathName.lastIndexOf("/") + 1);
var strActionPage = CurrentPath + "SaveToFile.aspx";
DWObject.HTTPUploadAllThroughPostAsMultiPageTIFF(
  "www.dynamsoft.com",
  strActionPage,
  "test.tiff"
);
//C# 操作页面部分:
System.Web.HttpContext.Current.Request.Form["PDFFileName"];
使用说明 从v13.1开始,在HTTP表单中添加字符串的基础上,新增了添加Blob的功能。
版本信息 v5.0+
SetUploadSegment()
设置什么时候启动分段上传和分段的大小。
语法 .SetUploadSegment(segementUploadThreshold, moduleSize);
参数 Number segementUploadThreshold: 指定触发调用分段上传的阈值(以MB为单位)。 默认值为500MB。
Number moduleSize: 每个段的大小(以KB为单位)。
返回值 Boolean
示例代码
使用说明
版本信息 v12.1+
SetHTTPHeader()
为http(s)post请求添加标头。每次完成HTTPUpload / HTTPDownload请求时,都会清除此标头。
语法 .SetHTTPHeader(HeaderName, HeaderValue);
参数 String HeaderName: 标头的名称,可以在服务器上用于检索标头值。
String HeaderValue: 标头值。
返回值 Boolean
示例代码
DWObject.SetHTTPHeader('dwt_CustomHeader','dynamsoft');
DWObject.HTTPUpload ('www.dynamsoft.com/SaveToFile.aspx?filename=001.pdf', [0,1], 
EnumImageType.PDF, EnumDWT_UploadDataFormat.BINARY, true,
 OnHttpUploadSuccess, OnHttpUploadFailure);
function OnHttpUploadSuccess (httpResponse) {
    console.log("HTTPResponseString: " + httpResponse);
}

function OnHttpUploadFailure (errorCode, errorString, httpResponse) {
    alert("ErrorCode: " + errorCode+ "ErrorString: " + errorString + 
    "HTTPResponseString: " + httpResponse);
}
使用说明 此方法仅在HTML5版本中有效。
版本信息 v12.0+

属性

FTPPassword
返回或设置用于登录FTP服务器的密码。
类型 String
访问权限 Get Set
使用说明 如果以“匿名”身份登录FTP服务器,则无需设置FTPUserName或FTPUserPassword。
版本信息 v5.2+
FTPPort
返回或设置用于FTP服务器上传/下载的端口号。
类型 Number
访问权限 Get Set
使用说明 默认FTP端口号为21。
版本信息 v5.2+
FTPUserName
返回或设置用于登录FTP服务器的用户名。
类型 String
访问权限 Get Set
使用说明 如果以“匿名”身份登录FTP服务器,则无需设置FTPUserName或FTPUserPassword。
版本信息 v5.2+
HttpFieldNameOfUploadedImage
通过POST上传时,返回或设置上传图像的字段名称。
类型 String
访问权限 Get Set
使用说明 默认值为“RemoteFile”。
版本信息 v6.0+
HTTPPort
返回或设置用于HTTP上传的端口号。
类型 Number
访问权限 Get Set
使用说明 默认HTTP端口号为80。此属性通常与IfSSL一起使用。
版本信息 v4.2.1+
HTTPPostResponseString
获取HTTP服务器返回信息。如果在调用HTTPUploadThroughPost ***方法之一后发生错误,则返回HTTP服务器的响应字符串。
类型 String
访问权限 Get
使用说明 这是一个只读属性。
版本信息 v3.0.3+
IfPASVMode
返回或设置是否启用FTP被动模式。
类型 Boolean
访问权限 Get Set
使用说明 默认值是true。
当属性值为true时,启用FTP被动模式。
当属性值为false时,启用FTP主动模式。
版本信息 v6.0+
IfShowCancelDialogWhenImageTransfer
返回或设置将图像上传到服务器时是否显示取消对话框。默认值是true。
类型 Boolean
访问权限 Get Set
使用说明 在HTML5 版本中,此属性仅适用于异步上传。
IfShowProgressBar 属性适用于任何图像编码/解码相关方法。例如: LoadImage,LoadImageEx 等等。
属性 HTML5 版本 非HTML5 版本 (ActiveX / Plugin)
IfShowCancelDialogWhenImageTransfer true 上传/下载:
将出现进度条。
上传/下载:
将出现进度条。
false 上传/下载:
进度条不会出现。
上传/下载:
进度条不会出现。
IfShowProgressBar true 保存/载入:
将出现进度条。
保存/载入:
将出现进度条。

上传/下载 (编码/解码):
将出现进度条。
false 保存/载入:
进度条不会出现。
保存/载入:
进度条不会出现。

上传/下载 (编码/解码):
进度条不会出现。
版本信息 v5.2+
IfSSL
返回或设置上传或下载图像时是否使用SSL。
类型 Number
访问权限 Get Set
使用说明 默认值为false。
此属性通常与HTTPPort一起使用。如果IfSSL设置为true,请确保将HTTPPort设置为安全端口,如443。
版本信息 v5.2+
MaxUploadImageSize
返回或设置上传图像的大小限制。
类型 Number
访问权限 Get Set
使用说明 默认值为-1,表示上传大小没有限制。单位是“字节”。
版本信息 v5.2+

事件

OnInternetTransferPercentage
此事件在图像上传或下载期间触发。
语法 .RegisterEvent('OnInternetTransferPercentage',function(sPercentage){...});
参数
  • Number sPercentage: 已上传或下载的百分比。
示例代码
DWObject.RegisterEvent('OnInternetTransferPercentage', function(sPercentage) {
    console.log(sPercentage);
});
使用说明
版本信息 v5.0+

results matching ""

    No results matching ""