你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
AdlsClient.BulkDownload 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| BulkDownload(String, String, Int32, IfExists, IProgress<TransferStatus>, Boolean, Boolean, CancellationToken) |
将目录或文件从远程服务器下载到本地。 传输目标目录下的源目录下的内容。 传输源文件并将其保存为目标路径。 此方法不会对任何条目的传输失败引发任何异常。 请参阅返回值 TransferStatus ，获取每个条目的传输状态/异常。 强烈建议在创建 AdlsClient 的任何实例之前，将 ServicePointManager.DefaultConnectionLimit 设置为应用程序希望 sdk 使用的线程数。 默认情况下，ServicePointManager.DefaultConnectionLimit 设置为 2。 |
| BulkDownload(String, String, Int32, IfExists, Boolean, IProgress<TransferStatus>, Boolean, Boolean, CancellationToken) |
将目录或文件从远程服务器下载到本地。 传输目标目录下的源目录下的内容。 传输源文件并将其保存为目标路径。
此方法不会对任何条目的传输失败引发任何异常。 请参阅返回值 TransferStatus ，获取每个条目的传输状态/异常。
默认情况下，将传输进度记录在系统临时路径中，以便用户可以在上传失败时使用 |
BulkDownload(String, String, Int32, IfExists, IProgress<TransferStatus>, Boolean, Boolean, CancellationToken)
将目录或文件从远程服务器下载到本地。 传输目标目录下的源目录下的内容。 传输源文件并将其保存为目标路径。 此方法不会对任何条目的传输失败引发任何异常。 请参阅返回值 TransferStatus ，获取每个条目的传输状态/异常。 强烈建议在创建 AdlsClient 的任何实例之前，将 ServicePointManager.DefaultConnectionLimit 设置为应用程序希望 sdk 使用的线程数。 默认情况下，ServicePointManager.DefaultConnectionLimit 设置为 2。
public virtual Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus BulkDownload (string srcPath, string destPath, int numThreads = -1, Microsoft.Azure.DataLake.Store.IfExists shouldOverwrite = Microsoft.Azure.DataLake.Store.IfExists.Overwrite, IProgress<Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus> progressTracker = default, bool notRecurse = false, bool resume = false, System.Threading.CancellationToken cancelToken = default);abstract member BulkDownload : string * string * int * Microsoft.Azure.DataLake.Store.IfExists * IProgress<Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus> * bool * bool * System.Threading.CancellationToken -> Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus
override this.BulkDownload : string * string * int * Microsoft.Azure.DataLake.Store.IfExists * IProgress<Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus> * bool * bool * System.Threading.CancellationToken -> Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatusPublic Overridable Function BulkDownload (srcPath As String, destPath As String, Optional numThreads As Integer = -1, Optional shouldOverwrite As IfExists = Microsoft.Azure.DataLake.Store.IfExists.Overwrite, Optional progressTracker As IProgress(Of TransferStatus) = Nothing, Optional notRecurse As Boolean = false, Optional resume As Boolean = false, Optional cancelToken As CancellationToken = Nothing) As TransferStatus参数
- srcPath
- String
远程源路径
- destPath
- String
本地目标路径。 它应始终为目录。
- numThreads
- Int32
线程数 - 如果未传递，则采用默认线程数 (物理核心数的 8 倍)
- shouldOverwrite
- IfExists
如果目标存在，则是否覆盖或跳过
- progressTracker
- IProgress<TransferStatus>
用于跟踪文件传输进度的进度跟踪器
- notRecurse
- Boolean
如果为 true，则执行枚举，直到级别 1，否则执行递归枚举
- resume
- Boolean
如果为 true，则我们希望从上次传输恢复
- cancelToken
- CancellationToken
取消令牌
返回
封装下载详细信息的传输状态
适用于
BulkDownload(String, String, Int32, IfExists, Boolean, IProgress<TransferStatus>, Boolean, Boolean, CancellationToken)
将目录或文件从远程服务器下载到本地。 传输目标目录下的源目录下的内容。 传输源文件并将其保存为目标路径。
此方法不会对任何条目的传输失败引发任何异常。 请参阅返回值 TransferStatus ，获取每个条目的传输状态/异常。
默认情况下，将传输进度记录在系统临时路径中，以便用户可以在上传失败时使用 resume 进行恢复。
可以使用 禁用 disableTransferLogging此进度日志记录。
强烈建议在创建 AdlsClient 的任何实例之前，将 ServicePointManager.DefaultConnectionLimit 设置为应用程序希望 sdk 使用的线程数。
默认情况下，ServicePointManager.DefaultConnectionLimit 设置为 2。
public virtual Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus BulkDownload (string srcPath, string destPath, int numThreads, Microsoft.Azure.DataLake.Store.IfExists shouldOverwrite, bool disableTransferLogging, IProgress<Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus> progressTracker, bool notRecurse, bool resume, System.Threading.CancellationToken cancelToken);abstract member BulkDownload : string * string * int * Microsoft.Azure.DataLake.Store.IfExists * bool * IProgress<Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus> * bool * bool * System.Threading.CancellationToken -> Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus
override this.BulkDownload : string * string * int * Microsoft.Azure.DataLake.Store.IfExists * bool * IProgress<Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatus> * bool * bool * System.Threading.CancellationToken -> Microsoft.Azure.DataLake.Store.FileTransfer.TransferStatusPublic Overridable Function BulkDownload (srcPath As String, destPath As String, numThreads As Integer, shouldOverwrite As IfExists, disableTransferLogging As Boolean, progressTracker As IProgress(Of TransferStatus), notRecurse As Boolean, resume As Boolean, cancelToken As CancellationToken) As TransferStatus参数
- srcPath
- String
远程源路径
- destPath
- String
本地目标路径。 它应始终为目录。
- numThreads
- Int32
线程数 - 默认 -1（如果未传递）将采用默认线程数 (物理核心数的 8 倍)
- shouldOverwrite
- IfExists
如果目标存在，则是否要覆盖或跳过，默认 IfExists.Overwrite
- disableTransferLogging
- Boolean
如果为 true，则禁用传输进度的日志记录。 这 和 resume 不能同时为 true。 默认值 false
- progressTracker
- IProgress<TransferStatus>
用于跟踪文件传输进度的进度跟踪器，默认为 null
- notRecurse
- Boolean
如果为 true，则执行枚举，直到级别 1 其他执行递归枚举，默认值为 false
- resume
- Boolean
如果为 true，则我们想要从上次传输恢复，默认值为 false
- cancelToken
- CancellationToken
取消令牌
返回
封装下载详细信息的传输状态
