Skip to content

GetRes()

Jump to bottom
任延华 edited this page Jan 20, 2020 · 1 revision

对应于dp2library的GetRes() API。

案例1:

Path:中文图书/10/object/0
Start:0
Length:-1
Style:metadata,timestamp,data,outputpath

这是获取一个书目记录下属的对象。Length为-1表示获取全部数据。

Style中的metadata表示同时获取对象的元数据，这是一个XML字符串，会返回到result.Metadata中；timestamp表示同时获取对象的时间戳，会返回到result.Timestamp中；data表示要返回数据部分，可能返回到result.Data中，也可能直接写入Stream对象，这要看具体调用了哪个API函数。

outputpath表示同时获取对象的路径，这在根据相对关系定位下一条记录的时候特别有用，可以知道实际返回的记录的路径。

案例2:

Path:中文图书/10/object/0
Start:0
Length:1000
Style:metadata,timestamp,data,outputpath

从头开始获取1000个byte。

下列这个函数版本，是直接将获得的数据写入Stream对象中。适合写入文件，或者ASP.NET页面的Response.OutputStream。而函数返回的GetResResponse对象中，Data成员为空，没有被使用。

        public Task<GetResResponse> GetResAsync(
            string strRemoteUserName,
            GetResRequest request,
            Stream stream,
            Delegate_setProgress func_setProgress,
            TimeSpan timeout,
            CancellationToken token)

func_setProgress是一个回调函数，可以动态设置数据传输进度。如果不使用它，就要使用null。

Clone this wiki locally