你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

CloudPageBlob 类

包:

com.microsoft.azure.storage.blob

• java.lang.Object
• • ListBlobItem
  • • CloudBlob
    • • com.microsoft.azure.storage.blob.CloudPageBlob

public class CloudPageBlob extends CloudBlob

表示 Microsoft Azure 页 Blob。

构造函数摘要

构造函数	说明
CloudPageBlob(final CloudPageBlob otherBlob)	通过从另一个页 Blob 复制值来创建 类的实例。
CloudPageBlob(final StorageUri blobAbsoluteUri)	使用指定的绝对 URI 和存储服务客户端创建 类的实例。
CloudPageBlob(final StorageUri blobAbsoluteUri, final StorageCredentials credentials)	使用指定的绝对 StorageUri 和凭据创建 类的实例。
CloudPageBlob(final StorageUri blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)	使用指定的绝对 StorageUri、快照 ID 和凭据创建 类的实例。
CloudPageBlob(final URI blobAbsoluteUri)	使用指定的绝对 URI 和存储服务客户端创建 类的实例。
CloudPageBlob(final URI blobAbsoluteUri, final StorageCredentials credentials)	使用指定的绝对 URI 和凭据创建 类的实例。
CloudPageBlob(final URI blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)	使用指定的绝对 URI、快照 ID 和凭据创建 类的实例。
CloudPageBlob(String blobName, String snapshotID, CloudBlobContainer container)	使用指定的类型、名称、快照 ID 和容器创建 类的实例。

方法摘要

修饰符和类型	方法和描述
void	clearPages(final long offset, final long length) 从页 Blob 中清除页。 调用 将释放指定页面使用的存储空间。 已清除的页不再作为页 Blob 的一部分进行跟踪，并且不再对存储帐户产生费用。
void	clearPages(final long offset, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 使用指定的租约 ID、请求选项和操作上下文从页 Blob 中清除页。 调用 将释放指定页面使用的存储空间。 已清除的页不再作为页 Blob 的一部分进行跟踪，并且不再对存储帐户产生费用。
void	create(final long length) 创建页 Blob。 如果 Blob 已存在，这将替换它。 若要在 Blob 已存在时引发错误，请将 重载与 一 create(final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 起使用 generateIfNotExistsCondition()。
void	create(final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 使用指定的请求选项和操作上下文创建页 Blob。 如果 Blob 已存在，这将替换它。 若要在 Blob 已存在的情况下引发错误，请使用 generateIfNotExistsCondition()。
void	create(final long length, final PremiumPageBlobTier premiumBlobTier, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 使用指定的请求选项和操作上下文创建页 Blob。 如果 Blob 已存在，这将替换它。 若要在 Blob 已存在的情况下引发错误，请使用 generateIfNotExistsCondition()。
ArrayList<PageRange>	downloadPageRanges() 返回页范围及其起始和结束字节偏移量的集合。 每个页面范围的起始和结束字节偏移将包含在内。
ArrayList<PageRange>	downloadPageRanges(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 使用指定的请求选项和操作上下文返回页范围及其起始和结束字节偏移量的集合。
List<PageRange>	downloadPageRanges(final long offset, final Long length) 返回页范围及其起始和结束字节偏移量的集合。
List<PageRange>	downloadPageRanges(final long offset, final Long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 使用指定的请求选项和操作上下文返回页范围及其起始和结束字节偏移量的集合。
List<PageRangeDiff>	downloadPageRangesDiff(final String previousSnapshot) 获取指定快照和此 对象之间不同的页范围的集合。
List<PageRangeDiff>	downloadPageRangesDiff(final String previousSnapshot, final Long offset, final Long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 获取指定快照和此 对象之间不同的页范围的集合。
BlobOutputStream	openWriteExisting() 打开输出流对象以将数据写入页 Blob。 页 Blob 必须已存在，并且任何现有数据可能会被覆盖。
BlobOutputStream	openWriteExisting(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 使用指定的租约 ID、请求选项和操作上下文打开输出流对象以将数据写入页 Blob。 页 Blob 必须已存在，并且任何现有数据可能会被覆盖。
BlobOutputStream	openWriteNew(final long length) 打开输出流对象以将数据写入页 Blob。 页 Blob 尚不需要存在，将使用指定的长度创建。 如果服务上已存在 Blob，则会覆盖该 Blob。 若要避免覆盖并引发错误，请将重载与相应的 AccessCondition结合使用openWriteNew(final long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)。
BlobOutputStream	openWriteNew(final long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 使用指定的租约 ID、请求选项和操作上下文打开输出流对象以将数据写入页 Blob。 页 Blob 尚不需要存在，将使用指定的长度创建。如果服务上已存在 Blob，则会覆盖该 Blob。 若要避免覆盖并引发错误，请使用 传入 AccessCondition 生成的 generateIfNotExistsCondition()。
BlobOutputStream	openWriteNew(final long length, final PremiumPageBlobTier premiumBlobTier, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 使用指定的租约 ID、请求选项和操作上下文打开输出流对象以将数据写入页 Blob。 页 Blob 尚不需要存在，将使用指定的长度创建。如果服务上已存在 Blob，则会覆盖该 Blob。 若要避免覆盖并引发错误，请使用 传入 AccessCondition 生成的 generateIfNotExistsCondition()。
void	putPagesFromURI(long offset, long length, final URI copySource, final Long sourceOffset) 使用指定的源 URL 写入 PageRange。
void	putPagesFromURI(long offset, long length, final URI copySource, final Long sourceOffset, String md5, AccessCondition accessCondition, AccessCondition sourceAccessCondition, BlobRequestOptions options, OperationContext opContext) 使用指定的源 URL 写入 PageRange。
void	resize(long size) 将页 Blob 调整为指定大小。
void	resize(long size, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 将页 Blob 调整为指定大小。
void	setStreamWriteSizeInBytes(final int streamWriteSizeInBytes) 设置写入 到 BlobOutputStream时要缓冲的字节数。
final String	startCopy(final CloudPageBlob sourceBlob) 请求服务开始将 Blob 的内容、属性和元数据复制到新 Blob。
final String	startCopy(final CloudPageBlob sourceBlob, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) 请求服务使用指定的访问条件、租用 ID、请求选项和操作上下文开始将 Blob 的内容、属性和元数据复制到新 Blob。
final String	startCopy(final CloudPageBlob sourceBlob, final PremiumPageBlobTier premiumBlobTier, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) 请求服务使用指定的 Blob 层、访问条件、租用 ID、请求选项和操作上下文开始将 Blob 的内容、属性和元数据复制到新 Blob。
final String	startIncrementalCopy(final CloudPageBlob sourceSnapshot) 请求服务开始向此 Blob 复制另一页 Blob 的内容、属性和元数据。
final String	startIncrementalCopy(final CloudPageBlob sourceSnapshot, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) 请求服务使用指定的访问条件、租用 ID、请求选项和操作上下文开始将 Blob 的内容、属性和元数据复制到新 Blob。
final String	startIncrementalCopy(final URI sourceSnapshot) 请求服务开始向此 Blob 复制另一页 Blob 的内容、属性和元数据。
final String	startIncrementalCopy(final URI sourceSnapshot, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) 请求服务使用指定的访问条件、租用 ID、请求选项和操作上下文开始将 Blob 的内容、属性和元数据复制到新 Blob。
void	updateSequenceNumberFromResponse(HttpURLConnection request)
void	upload(final InputStream sourceStream, final long length) 将源流数据上传到页 Blob。 如果服务中已存在 Blob，则会覆盖该 Blob。
void	upload(final InputStream sourceStream, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 使用指定的租约 ID、请求选项和操作上下文将源流数据上传到页 Blob。 如果服务中已存在 Blob，则会覆盖该 Blob。
void	upload(final InputStream sourceStream, final long length, final PremiumPageBlobTier premiumBlobTier, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 使用指定的租约 ID、请求选项和操作上下文将源流数据上传到页 Blob。 如果服务中已存在 Blob，则会覆盖该 Blob。
void	uploadFromByteArray(final byte[] buffer, final int offset, final int length, final PremiumPageBlobTier premiumBlobTier, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 从字节数组中的数据上传 Blob。 如果服务中已存在 Blob，则会覆盖该 Blob。
void	uploadFromFile(final String path, final PremiumPageBlobTier premiumBlobTier, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 从文件上传 Blob。 如果服务中已存在 Blob，则会覆盖该 Blob。
void	uploadPages(final InputStream sourceStream, final long offset, final long length) 在页 Blob 中的指定偏移量处上传一系列连续页面，最大大小为 4 MB。
void	uploadPages(final InputStream sourceStream, final long offset, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 使用指定的租约 ID、请求选项和操作上下文，在页 Blob 中的指定偏移量上传一系列连续页，最大为 4 MB。
void	uploadPremiumPageBlobTier(final PremiumPageBlobTier premiumBlobTier) 在高级存储帐户的页 Blob 上设置 Blob 层。
void	uploadPremiumPageBlobTier(final PremiumPageBlobTier premiumBlobTier, BlobRequestOptions options, OperationContext opContext) 设置高级存储帐户上页 Blob 上的层。

继承成员

CloudBlob.abortCopy(final String copyId) CloudBlob.abortCopy(final String copyId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.acquireLease() CloudBlob.acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId) CloudBlob.acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.assertCorrectBlobType() CloudBlob.assertNoWriteOperationForSnapshot() CloudBlob.blobServiceClient CloudBlob.breakLease(final Integer breakPeriodInSeconds) CloudBlob.breakLease(final Integer breakPeriodInSeconds, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.changeLease(final String proposedLeaseId, final AccessCondition accessCondition) CloudBlob.changeLease(final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.CloudBlob(final BlobType type, String blobName, String snapshotID, CloudBlobContainer container) CloudBlob.CloudBlob(final BlobType type, final StorageUri uri, final String snapshotID, final StorageCredentials credentials) CloudBlob.CloudBlob(final CloudBlob otherBlob) CloudBlob.createSnapshot() CloudBlob.createSnapshot(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.createSnapshot(final HashMap<String, String> metadata, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.delete() CloudBlob.delete(final DeleteSnapshotsOption deleteSnapshotsOption, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.deleteIfExists() CloudBlob.deleteIfExists(final DeleteSnapshotsOption deleteSnapshotsOption, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.download(final OutputStream outStream) CloudBlob.download(final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadAccountInfo() CloudBlob.downloadAccountInfo(BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadAccountInformationImpl(final RequestOptions options) CloudBlob.downloadAttributes() CloudBlob.downloadAttributes(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadRange(final long offset, final Long length, final OutputStream outStream) CloudBlob.downloadRange(final long offset, final Long length, final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadRangeInternal(final long blobOffset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset) CloudBlob.downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadToByteArray(final byte[] buffer, final int bufferOffset) CloudBlob.downloadToByteArray(final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadToFile(final String path) CloudBlob.downloadToFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.exists() CloudBlob.exists(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final String groupPolicyIdentifier) CloudBlob.generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier) CloudBlob.generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols) CloudBlob.generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols, boolean skipDecoding) CloudBlob.generateUserDelegationSharedAccessSignature(UserDelegationKey delegationKey, SharedAccessBlobPolicy policy) CloudBlob.generateUserDelegationSharedAccessSignature(final UserDelegationKey delegationKey, final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final IPRange ipRange, final SharedAccessProtocols protocols) CloudBlob.getContainer() CloudBlob.getCopyState() CloudBlob.getMetadata() CloudBlob.getName() CloudBlob.getParent() CloudBlob.getParentNameFromURI(final StorageUri resourceAddress, final String delimiter, final CloudBlobContainer container) CloudBlob.getProperties() CloudBlob.getQualifiedStorageUri() CloudBlob.getQualifiedUri() CloudBlob.getServiceClient() CloudBlob.getSnapshotID() CloudBlob.getSnapshotQualifiedStorageUri() CloudBlob.getSnapshotQualifiedUri() CloudBlob.getStorageUri() CloudBlob.getStreamMinimumReadSizeInBytes() CloudBlob.getStreamWriteSizeInBytes() CloudBlob.getTransformedAddress(final OperationContext opContext) CloudBlob.getUri() CloudBlob.isSnapshot() CloudBlob.openInputStream() CloudBlob.openInputStream(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.openInputStream(final long offset, final Long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.parent CloudBlob.releaseLease(final AccessCondition accessCondition) CloudBlob.releaseLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.renewLease(final AccessCondition accessCondition) CloudBlob.renewLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.setContainer(final CloudBlobContainer container) CloudBlob.setMetadata(final HashMap<String, String> metadata) CloudBlob.setProperties(final BlobProperties properties) CloudBlob.setSnapshotID(final String snapshotID) CloudBlob.setStorageUri(final StorageUri storageUri) CloudBlob.setStreamMinimumReadSizeInBytes(final int minimumReadSize) CloudBlob.startCopy(final URI source) CloudBlob.startCopy(final URI source, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.startCopy(final URI source, final String blobTierString, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.startCopy(final URI source, String contentMd5, boolean syncCopy, final String blobTierString, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.startCopy(final URI source, String contentMd5, boolean syncCopy, final String blobTierString, final RehydratePriority rehydratePriority, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.startCopyImpl(final URI source, final String contentMd5, final boolean syncCopy, final boolean incrementalCopy, final String blobTierString, final RehydratePriority rehydratePriority, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, final BlobRequestOptions options) CloudBlob.streamMinimumReadSizeInBytes CloudBlob.streamWriteSizeInBytes CloudBlob.undelete() CloudBlob.undelete(BlobRequestOptions options, OperationContext opContext) CloudBlob.updateEtagAndLastModifiedFromResponse(HttpURLConnection request) CloudBlob.updateLengthFromResponse(HttpURLConnection request) CloudBlob.uploadFromByteArray(final byte[] buffer, final int offset, final int length) CloudBlob.uploadFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.uploadFromFile(final String path) CloudBlob.uploadFromFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.uploadMetadata() CloudBlob.uploadMetadata(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.uploadProperties() CloudBlob.uploadProperties(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.validateCPKHeaders(StorageRequest<CloudBlobClient, T, R> request, BlobRequestOptions options, boolean upload)

构造函数详细信息

CloudPageBlob

public CloudPageBlob(final CloudPageBlob otherBlob)

通过从另一个页 Blob 复制值来创建 类的实例。

Parameters:

otherBlob - 一个 CloudPageBlob 对象，表示要复制的页 Blob。

CloudPageBlob

public CloudPageBlob(final StorageUri blobAbsoluteUri)

使用指定的绝对 URI 和存储服务客户端创建 类的实例。

Parameters:

blobAbsoluteUri - 一个 StorageUri 对象，表示 Blob 的绝对 URI。

Throws:

StorageException - 如果发生存储服务错误。

CloudPageBlob

public CloudPageBlob(final StorageUri blobAbsoluteUri, final StorageCredentials credentials)

使用指定的绝对 StorageUri 和凭据创建 类的实例。

Parameters:

blobAbsoluteUri - 一个 StorageUri 对象，该对象表示 Blob 的绝对 URI。

credentials - StorageCredentials用于对访问进行身份验证的 对象。

Throws:

StorageException - 如果发生存储服务错误。

CloudPageBlob

public CloudPageBlob(final StorageUri blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)

使用指定的绝对 StorageUri、快照 ID 和凭据创建 类的实例。

Parameters:

blobAbsoluteUri - 一个 StorageUri 对象，该对象表示 Blob 的绝对 URI。

snapshotID - 表示String快照版本的 （如果适用）。

credentials - StorageCredentials用于对访问进行身份验证的 对象。

Throws:

StorageException - 如果发生存储服务错误。

CloudPageBlob

public CloudPageBlob(final URI blobAbsoluteUri)

使用指定的绝对 URI 和存储服务客户端创建 类的实例。

Parameters:

blobAbsoluteUri - 一个 java.net.URI 对象，表示 Blob 的绝对 URI。

Throws:

StorageException - 如果发生存储服务错误。

CloudPageBlob

public CloudPageBlob(final URI blobAbsoluteUri, final StorageCredentials credentials)

使用指定的绝对 URI 和凭据创建 类的实例。

Parameters:

blobAbsoluteUri - 一个 java.net.URI 对象，该对象表示 Blob 的绝对 URI。

credentials - StorageCredentials用于对访问进行身份验证的 对象。

Throws:

StorageException - 如果发生存储服务错误。

CloudPageBlob

public CloudPageBlob(final URI blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)

使用指定的绝对 URI、快照 ID 和凭据创建 类的实例。

Parameters:

blobAbsoluteUri - 一个 java.net.URI 对象，该对象表示 Blob 的绝对 URI。

snapshotID - 表示String快照版本的 （如果适用）。

credentials - StorageCredentials用于对访问进行身份验证的 对象。

Throws:

StorageException - 如果发生存储服务错误。

CloudPageBlob

protected CloudPageBlob(String blobName, String snapshotID, CloudBlobContainer container)

使用指定的类型、名称、快照 ID 和容器创建 类的实例。

Parameters:

blobName - blob 的名称。

snapshotID - 表示String快照版本的 （如果适用）。

container - 对父容器的引用。

Throws:

URISyntaxException - 如果资源 URI 无效。

方法详细信息

clearPages

public void clearPages(final long offset, final long length)

从页 Blob 中清除页。

调用 将释放指定页面使用的存储空间。 已清除的页不再作为页 Blob 的一部分进行跟踪，并且不再对存储帐户产生费用。

Parameters:

offset - 开始清除页的偏移量（以字节为单位）。 此值必须是 512 的倍数。

length - 要清除的数据范围的长度（以字节为单位）。 此值必须是 512 的倍数。

Throws:

StorageException - 如果发生存储服务错误。

clearPages

public void clearPages(final long offset, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

使用指定的租约 ID、请求选项和操作上下文从页 Blob 中清除页。

调用 将释放指定页面使用的存储空间。 已清除的页不再作为页 Blob 的一部分进行跟踪，并且不再对存储帐户产生费用。

Parameters:

offset - 一个 long ，表示开始清除页面的偏移量（以字节为单位）。 此值必须是 512 的倍数。

length - 一个 ， long 表示要清除的数据范围的长度（以字节为单位）。 此值必须是 512 的倍数。

accessCondition - 一个 AccessCondition 对象，表示 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 ( CloudBlobClient) 的默认请求选项。

opContext - 一个 OperationContext 对象，表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Throws:

StorageException - 如果发生存储服务错误。

create

public void create(final long length)

创建页 Blob。 如果 Blob 已存在，这将替换它。 若要在 Blob 已存在时引发错误，请将 重载与 一 create(final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 起使用 generateIfNotExistsCondition()。

Parameters:

length - 一个 long ，它表示页 Blob 的大小（以字节为单位）。

Throws:

IllegalArgumentException - 如果长度不是 512 的倍数。

StorageException - 如果发生存储服务错误。

create

public void create(final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

使用指定的请求选项和操作上下文创建页 Blob。 如果 Blob 已存在，这将替换它。 若要在 Blob 已存在的情况下引发错误，请使用 generateIfNotExistsCondition()。

Parameters:

length - 一个 long ，它表示页 Blob 的大小（以字节为单位）。

accessCondition - 一个 AccessCondition 对象，表示 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 ( CloudBlobClient) 的默认请求选项。

opContext - 一个 OperationContext 对象，表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Throws:

IllegalArgumentException - 如果长度不是 512 的倍数。

StorageException - 如果发生存储服务错误。

create

public void create(final long length, final PremiumPageBlobTier premiumBlobTier, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

使用指定的请求选项和操作上下文创建页 Blob。 如果 Blob 已存在，这将替换它。 若要在 Blob 已存在的情况下引发错误，请使用 generateIfNotExistsCondition()。

Parameters:

length - 一个 long ，它表示页 Blob 的大小（以字节为单位）。

premiumBlobTier - 一个 PremiumPageBlobTier 表示 Blob 层的 对象。

accessCondition - 一个 AccessCondition 对象，表示 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 ( CloudBlobClient) 的默认请求选项。

opContext - 一个 OperationContext 对象，表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Throws:

IllegalArgumentException - 如果长度不是 512 的倍数。

StorageException - 如果发生存储服务错误。

downloadPageRanges

public ArrayList downloadPageRanges()

返回页范围及其起始和结束字节偏移量的集合。

每个页面范围的起始和结束字节偏移将包含在内。

Returns:

一个 ArrayList 对象，表示页范围集及其起始和结束字节偏移量。

Throws:

StorageException - 如果发生存储服务错误。

downloadPageRanges

public ArrayList downloadPageRanges(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

使用指定的请求选项和操作上下文返回页范围及其起始和结束字节偏移量的集合。

Parameters:

accessCondition - 一个 AccessCondition 对象，表示 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 ( CloudBlobClient) 的默认请求选项。

opContext - 一个 OperationContext 对象，表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Returns:

一个 ArrayList 对象，表示页范围集及其起始和结束字节偏移量。

Throws:

StorageException - 如果发生存储服务错误。

downloadPageRanges

public List downloadPageRanges(final long offset, final Long length)

返回页范围及其起始和结束字节偏移量的集合。

Parameters:

offset - 要根据其列出页面范围的数据范围的起始偏移量（以字节为单位）。 必须是 512 的倍数。

length - 要根据其列出页面范围的数据范围的长度（以字节为单位）。 必须是 512 的倍数。

Returns:

一个 List 对象，它表示页范围集及其起始字节和结束字节偏移量。

Throws:

StorageException - 如果发生存储服务错误。

downloadPageRanges

public List downloadPageRanges(final long offset, final Long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

使用指定的请求选项和操作上下文返回页范围及其起始和结束字节偏移量的集合。

Parameters:

offset - 要根据其列出页面范围的数据范围的起始偏移量（以字节为单位）。 必须是 512 的倍数。

length - 要根据其列出页面范围的数据范围的长度（以字节为单位）。 必须是 512 的倍数。

accessCondition - 一个 AccessCondition 对象，表示 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 ( CloudBlobClient) 的默认请求选项。

opContext - 一个 OperationContext 对象，表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Returns:

一个 List 对象，它表示页范围集及其起始字节和结束字节偏移量。

Throws:

StorageException - 如果发生存储服务错误。

downloadPageRangesDiff

public List downloadPageRangesDiff(final String previousSnapshot)

获取指定快照和此 对象之间不同的页范围的集合。

Parameters:

previousSnapshot - 一个字符串，表示用作差异起点的快照。 如果此 CloudPageBlob 表示快照，则 previousSnapshot 参数必须早于当前快照。

Returns:

一个 List 包含不同页面范围集的 对象。

Throws:

StorageException - 如果发生存储服务错误。

downloadPageRangesDiff

public List downloadPageRangesDiff(final String previousSnapshot, final Long offset, final Long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

获取指定快照和此 对象之间不同的页范围的集合。

Parameters:

previousSnapshot - 一个字符串，表示要用作差异起点的快照时间戳。 如果此 CloudPageBlob 表示快照，则 previousSnapshot 参数必须早于当前快照。

offset - 要根据其列出页面范围的数据范围的起始偏移量（以字节为单位）。 必须是 512 的倍数。

length - 要根据其列出页面范围的数据范围的长度（以字节为单位）。 必须是 512 的倍数。

accessCondition - 一个 AccessCondition 对象，表示 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 ( CloudBlobClient) 的默认请求选项。

opContext - 一个 OperationContext 对象，表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Returns:

一个 List 包含不同页面范围集的 对象。

Throws:

StorageException - 如果发生存储服务错误。

openWriteExisting

public BlobOutputStream openWriteExisting()

打开输出流对象以将数据写入页 Blob。 页 Blob 必须已存在，并且任何现有数据可能会被覆盖。

Returns:

BlobOutputStream用于将数据写入 Blob 的 对象。

Throws:

StorageException - 如果发生存储服务错误。

openWriteExisting

public BlobOutputStream openWriteExisting(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

使用指定的租约 ID、请求选项和操作上下文打开输出流对象以将数据写入页 Blob。 页 Blob 必须已存在，并且任何现有数据可能会被覆盖。

Parameters:

accessCondition - 一个 AccessCondition 对象，表示 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 ( CloudBlobClient) 的默认请求选项。

opContext - 一个 OperationContext 对象，表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Returns:

BlobOutputStream用于将数据写入 Blob 的 对象。

Throws:

StorageException - 如果发生存储服务错误。

openWriteNew

public BlobOutputStream openWriteNew(final long length)

打开输出流对象以将数据写入页 Blob。 页 Blob 尚不需要存在，将使用指定的长度创建。 如果服务上已存在 Blob，则会覆盖该 Blob。

若要避免覆盖并引发错误，请将重载与相应的 AccessCondition结合使用openWriteNew(final long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)。

Parameters:

length - 一个 long ，表示要创建的流的长度（以字节为单位）。 此值必须是 512 的倍数。

Returns:

BlobOutputStream用于将数据写入 Blob 的 对象。

Throws:

StorageException - 如果发生存储服务错误。

openWriteNew

public BlobOutputStream openWriteNew(final long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

使用指定的租约 ID、请求选项和操作上下文打开输出流对象以将数据写入页 Blob。 页 Blob 尚不需要存在，将使用指定的长度创建。如果服务上已存在 Blob，则会覆盖该 Blob。

若要避免覆盖并引发错误，请使用 传入 AccessCondition 生成的 generateIfNotExistsCondition()。

Parameters:

length - 一个 long ，表示要创建的流的长度（以字节为单位）。 此值必须是 512 的倍数。

accessCondition - 一个 AccessCondition 对象，表示 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 ( CloudBlobClient) 的默认请求选项。

opContext - 一个 OperationContext 对象，表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Returns:

BlobOutputStream用于将数据写入 Blob 的 对象。

Throws:

StorageException - 如果发生存储服务错误。

openWriteNew

public BlobOutputStream openWriteNew(final long length, final PremiumPageBlobTier premiumBlobTier, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

使用指定的租约 ID、请求选项和操作上下文打开输出流对象以将数据写入页 Blob。 页 Blob 尚不需要存在，将使用指定的长度创建。如果服务上已存在 Blob，则会覆盖该 Blob。

若要避免覆盖并引发错误，请使用 传入 AccessCondition 生成的 generateIfNotExistsCondition()。

Parameters:

length - 一个 long ，表示要创建的流的长度（以字节为单位）。 此值必须是 512 的倍数。

premiumBlobTier - 一个 PremiumPageBlobTier 表示 Blob 层的 对象。

accessCondition - 一个 AccessCondition 对象，表示 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 ( CloudBlobClient) 的默认请求选项。

opContext - 一个 OperationContext 对象，表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Returns:

BlobOutputStream用于将数据写入 Blob 的 对象。

Throws:

StorageException - 如果发生存储服务错误。

putPagesFromURI

public void putPagesFromURI(long offset, long length, final URI copySource, final Long sourceOffset)

使用指定的源 URL 写入 PageRange。

Parameters:

offset - 开始写入页的偏移量（以字节为单位）。 此值必须是 512 的倍数。

length - 要写入的数据范围的长度（以字节为单位）。 此值必须是 512 的倍数。 此值还将用作要从源复制的数据的长度。

copySource - URI源数据的 。 它可以指向任何公共的 Azure Blob 或文件，或者 URL 可以包含共享访问签名。

sourceOffset - 一个 ， long 表示用作源起点的偏移量。 要从源复制的数据的长度将从源长度参数中获取。

Throws:

StorageException - 如果发生存储服务错误。

putPagesFromURI

public void putPagesFromURI(long offset, long length, final URI copySource, final Long sourceOffset, String md5, AccessCondition accessCondition, AccessCondition sourceAccessCondition, BlobRequestOptions options, OperationContext opContext)

使用指定的源 URL 写入 PageRange。

Parameters:

offset - 开始写入页的偏移量（以字节为单位）。 此值必须是 512 的倍数。

length - 要写入的数据范围的长度（以字节为单位）。 此值必须是 512 的倍数。 此值还将用作要从源复制的数据的长度。

copySource - URI源数据的 。 它可以指向任何公共的 Azure Blob 或文件，或者 URL 可以包含共享访问签名。

sourceOffset - 一个 ， long 表示用作源起点的偏移量。 要从源复制的数据的长度将从源长度参数中获取。

md5 - 一个 String ，它表示数据的 MD5 哈希。

accessCondition - 一个 AccessCondition 对象，表示 Blob 的访问条件。

sourceAccessCondition - 一个 AccessCondition 对象，表示源 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 ( CloudBlobClient) 的默认请求选项。

opContext - 一个 OperationContext 对象，表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Throws:

StorageException - 如果发生存储服务错误。

resize

public void resize(long size)

将页 Blob 调整为指定大小。

Parameters:

size - 一个 ， long 它表示页 Blob 的大小（以字节为单位）。

Throws:

StorageException - 如果发生存储服务错误。

resize

public void resize(long size, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

将页 Blob 调整为指定大小。

Parameters:

size - 一个 ， long 它表示页 Blob 的大小（以字节为单位）。

accessCondition - 一个 AccessCondition 对象，表示 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 ( CloudBlobClient) 的默认请求选项。

opContext - 一个 OperationContext 对象，表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Throws:

StorageException - 如果发生存储服务错误。

setStreamWriteSizeInBytes

public void setStreamWriteSizeInBytes(final int streamWriteSizeInBytes)

设置写入 到 BlobOutputStream时要缓冲的字节数。

Parameters:

streamWriteSizeInBytes - 一个 ， int 表示写入页 Blob 流时要缓冲的最大字节数。 此值必须是 512 的倍数，并且小于或等于 4 MB。

Throws:

IllegalArgumentException - 如果 streamWriteSizeInBytes 小于 512、大于 4 MB，或者不是倍数或 512。

startCopy

public final String startCopy(final CloudPageBlob sourceBlob)

请求服务开始将 Blob 的内容、属性和元数据复制到新 Blob。

Parameters:

sourceBlob - 一个 CloudPageBlob 对象，表示要复制的源 Blob。

Returns:

一个 String ，表示与复制操作关联的复制 ID。

Throws:

StorageException - 如果发生存储服务错误。

URISyntaxException

startCopy

public final String startCopy(final CloudPageBlob sourceBlob, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

请求服务使用指定的访问条件、租用 ID、请求选项和操作上下文开始将 Blob 的内容、属性和元数据复制到新 Blob。

Parameters:

sourceBlob - 一个 CloudPageBlob 对象，表示要复制的源 Blob。

sourceAccessCondition - 一个 AccessCondition 对象，表示源 Blob 的访问条件。

destinationAccessCondition - 一个 AccessCondition 对象，表示目标 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 () CloudBlobClient 的默认请求选项。

opContext - 一个 OperationContext 对象，它一个表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Returns:

， String 它表示与复制操作关联的复制 ID。

Throws:

StorageException - 如果发生存储服务错误。

URISyntaxException

startCopy

public final String startCopy(final CloudPageBlob sourceBlob, final PremiumPageBlobTier premiumBlobTier, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

请求服务使用指定的 Blob 层、访问条件、租用 ID、请求选项和操作上下文开始将 Blob 的内容、属性和元数据复制到新 Blob。

Parameters:

sourceBlob - 一个 CloudPageBlob 对象，表示要复制的源 Blob。

premiumBlobTier - 一个 PremiumPageBlobTier 表示 Blob 层的 对象。

sourceAccessCondition - 一个 AccessCondition 对象，表示源 Blob 的访问条件。

destinationAccessCondition - 一个 AccessCondition 对象，表示目标 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 () CloudBlobClient 的默认请求选项。

opContext - 一个 OperationContext 对象，它一个表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Returns:

， String 它表示与复制操作关联的复制 ID。

Throws:

StorageException - 如果发生存储服务错误。

URISyntaxException

startIncrementalCopy

public final String startIncrementalCopy(final CloudPageBlob sourceSnapshot)

请求服务开始向此 Blob 复制另一页 Blob 的内容、属性和元数据。

Parameters:

sourceSnapshot - 一个 CloudPageBlob 对象，表示要复制的源 Blob。 必须是快照。

Returns:

， String 它表示与复制操作关联的复制 ID。

Throws:

StorageException - 如果发生存储服务错误。

URISyntaxException

startIncrementalCopy

public final String startIncrementalCopy(final CloudPageBlob sourceSnapshot, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

请求服务使用指定的访问条件、租用 ID、请求选项和操作上下文开始将 Blob 的内容、属性和元数据复制到新 Blob。

Parameters:

sourceSnapshot - 一个 CloudPageBlob 对象，表示要复制的源 Blob。 必须是快照。

destinationAccessCondition - 一个 AccessCondition 对象，表示目标 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 () CloudBlobClient 的默认请求选项。

opContext - 一个 OperationContext 对象，它一个表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Returns:

， String 它表示与复制操作关联的复制 ID。

Throws:

StorageException - 如果发生存储服务错误。

URISyntaxException

startIncrementalCopy

public final String startIncrementalCopy(final URI sourceSnapshot)

请求服务开始向此 Blob 复制另一页 Blob 的内容、属性和元数据。

Parameters:

sourceSnapshot - 一个 CloudPageBlob 对象，表示要复制的源 Blob。 必须是快照。

Returns:

， String 它表示与复制操作关联的复制 ID。

Throws:

StorageException - 如果发生存储服务错误。

URISyntaxException

startIncrementalCopy

public final String startIncrementalCopy(final URI sourceSnapshot, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

请求服务使用指定的访问条件、租用 ID、请求选项和操作上下文开始将 Blob 的内容、属性和元数据复制到新 Blob。

Parameters:

sourceSnapshot - 一个 CloudPageBlob 对象，表示要复制的源 Blob。 必须是快照。

destinationAccessCondition - 一个 AccessCondition 对象，表示目标 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 () CloudBlobClient 的默认请求选项。

opContext - 一个 OperationContext 对象，它一个表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Returns:

， String 它表示与复制操作关联的复制 ID。

Throws:

StorageException - 如果发生存储服务错误。

URISyntaxException

updateSequenceNumberFromResponse

protected void updateSequenceNumberFromResponse(HttpURLConnection request)

Parameters:

request

upload

public void upload(final InputStream sourceStream, final long length)

将源流数据上传到页 Blob。 如果服务中已存在 Blob，则会覆盖该 Blob。

Parameters:

sourceStream - 要 InputStream 从中读取的对象。

length - 表示 long 流数据的长度（以字节为单位）的 必须是非零和 512 的倍数。

Throws:

IOException - 如果发生 I/O 异常。

StorageException - 如果发生存储服务错误。

upload

public void upload(final InputStream sourceStream, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

使用指定的租约 ID、请求选项和操作上下文将源流数据上传到页 Blob。 如果服务中已存在 Blob，则会覆盖该 Blob。

Parameters:

sourceStream - 要 InputStream 从中读取的对象。

length - 一个 long ，它表示流数据的长度（以字节为单位）。 此值必须大于 0，且为 512 的倍数。

accessCondition - 一个 AccessCondition 对象，表示 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 () CloudBlobClient 的默认请求选项。

opContext - 一个 OperationContext 对象，表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Throws:

IOException - 如果发生 I/O 异常。

StorageException - 如果发生存储服务错误。

upload

public void upload(final InputStream sourceStream, final long length, final PremiumPageBlobTier premiumBlobTier, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

使用指定的租约 ID、请求选项和操作上下文将源流数据上传到页 Blob。 如果服务中已存在 Blob，则会覆盖该 Blob。

Parameters:

sourceStream - 要 InputStream 从中读取的对象。

length - 一个 long ，它表示流数据的长度（以字节为单位）。 此值必须大于 0，且为 512 的倍数。

premiumBlobTier - 一个 PremiumPageBlobTier 表示 Blob 层的 对象。

accessCondition - 一个 AccessCondition 对象，表示 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 () CloudBlobClient 的默认请求选项。

opContext - 一个 OperationContext 对象，表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Throws:

IOException - 如果发生 I/O 异常。

StorageException - 如果发生存储服务错误。

uploadFromByteArray

public void uploadFromByteArray(final byte[] buffer, final int offset, final int length, final PremiumPageBlobTier premiumBlobTier, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

从字节数组中的数据上传 Blob。 如果服务中已存在 Blob，则会覆盖该 Blob。

Parameters:

buffer - 表示 byte 要写入 Blob 的数据的数组。

offset - 一个 int ，它表示从中开始上传数据的字节数组的偏移量。

length - 一个 int ，表示要从输入缓冲区上传的字节数。

premiumBlobTier - 一个 PremiumPageBlobTier 表示 Blob 层的 对象。

accessCondition - 一个表示 Blob 访问条件的 AccessCondition 对象。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 () CloudBlobClient 的默认请求选项。

opContext - 一个 OperationContext 对象，它一个表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Throws:

StorageException - 如果发生存储服务错误。

IOException

uploadFromFile

public void uploadFromFile(final String path, final PremiumPageBlobTier premiumBlobTier, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

从文件上传 Blob。 如果服务中已存在 Blob，则会覆盖该 Blob。

Parameters:

path - 一个 String ，它表示要上载的文件的路径。

premiumBlobTier - 一个 PremiumPageBlobTier 表示 Blob 层的 对象。

accessCondition - 一个表示 Blob 访问条件的 AccessCondition 对象。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 () CloudBlobClient 的默认请求选项。

opContext - 一个 OperationContext 对象，它一个表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Throws:

StorageException - 如果发生存储服务错误。

IOException

uploadPages

public void uploadPages(final InputStream sourceStream, final long offset, final long length)

在页 Blob 中的指定偏移量处上传一系列连续页面，最大大小为 4 MB。

Parameters:

sourceStream - 一个 InputStream 对象，表示要写入页 Blob 的输入流。

offset - 一个 long ，它表示开始写入数据的偏移量（字节数）。 此值必须是 512 的倍数。

length - ， long 它表示要写入的数据的长度（以字节为单位）。 此值必须是 512 的倍数。

Throws:

IllegalArgumentException - 如果偏移量或长度不是 512 的倍数，或者长度大于 4 MB。

IOException - 如果发生 I/O 异常。

StorageException - 如果发生存储服务错误。

uploadPages

public void uploadPages(final InputStream sourceStream, final long offset, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

使用指定的租约 ID、请求选项和操作上下文，在页 Blob 中的指定偏移量上传一系列连续页，最大为 4 MB。

Parameters:

sourceStream - 一个 InputStream 对象，表示要写入页 Blob 的输入流。

offset - 一个 long ，它表示开始写入数据的偏移量（字节数）。 此值必须是 512 的倍数。

length - ， long 它表示要写入的数据的长度（以字节为单位）。 此值必须是 512 的倍数。

accessCondition - 一个 AccessCondition 对象，表示 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 () CloudBlobClient 的默认请求选项。

opContext - 一个 OperationContext 对象，表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Throws:

IllegalArgumentException - 如果偏移量或长度不是 512 的倍数，或者长度大于 4 MB。

IOException - 如果发生 I/O 异常。

StorageException - 如果发生存储服务错误。

uploadPremiumPageBlobTier

public void uploadPremiumPageBlobTier(final PremiumPageBlobTier premiumBlobTier)

在高级存储帐户的页 Blob 上设置 Blob 层。

Parameters:

premiumBlobTier - 一个 PremiumPageBlobTier 表示 Blob 层的 对象。

Throws:

StorageException - 如果发生存储服务错误。

uploadPremiumPageBlobTier

public void uploadPremiumPageBlobTier(final PremiumPageBlobTier premiumBlobTier, BlobRequestOptions options, OperationContext opContext)

设置高级存储帐户上页 Blob 上的层。

Parameters:

premiumBlobTier - 一个 PremiumPageBlobTier 表示 Blob 层的 对象。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 () CloudBlobClient 的默认请求选项。

opContext - 一个 OperationContext 对象，表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Throws:

StorageException - 如果发生存储服务错误。