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

CloudFileShare 类

包:

com.microsoft.azure.storage.file

• java.lang.Object
• • com.microsoft.azure.storage.file.CloudFileShare

public class CloudFileShare

表示 Microsoft Azure 文件服务中的共享。

共享保存作为对象封装 CloudFileDirectory 的目录，目录保存文件。 目录还可以包含子目录。

构造函数摘要

构造函数	说明
CloudFileShare(final StorageUri storageUri)	使用指定的 URI 创建 类的实例。
CloudFileShare(final StorageUri storageUri, final StorageCredentials credentials)	使用指定的 StorageUri 和凭据创建 类的实例。
CloudFileShare(final String shareName, String snapshotID, final CloudFileClient client)	使用指定的名称和客户端创建 类的实例。
CloudFileShare(final URI uri)	使用指定的 URI 创建 类的实例。
CloudFileShare(final URI uri, final StorageCredentials credentials)	使用指定的 URI 和凭据创建 类的实例。

方法摘要

修饰符和类型	方法和描述
void	assertNoSnapshot() 断言共享不是快照。
void	create() 创建共享。
void	create(FileRequestOptions options, OperationContext opContext) 使用指定的选项和操作上下文创建共享。
String	createFilePermission(String permission) 创建文件权限。
String	createFilePermission(String permission, FileRequestOptions options, OperationContext opContext) 创建文件权限。
boolean	createIfNotExists() 如果共享不存在，则创建该共享。
boolean	createIfNotExists(FileRequestOptions options, OperationContext opContext) 使用指定的请求选项和操作上下文创建共享（如果不存在）。
final CloudFileShare	createSnapshot() 创建共享快照。
final CloudFileShare	createSnapshot(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) 使用指定的请求选项和操作上下文创建文件共享的快照。
final CloudFileShare	createSnapshot(final HashMap<String, String> metadata, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) 使用指定的请求选项和操作上下文创建文件共享的快照。
void	delete() 删除共享。
void	delete(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) 使用指定的请求选项和操作上下文删除共享。
void	delete(DeleteShareSnapshotsOption deleteSnapshotsOption, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) 使用指定的快照和请求选项以及操作上下文删除共享。 除非同时删除快照，否则无法删除包含快照的共享。 如果共享具有快照，请在删除基本共享时使用 INCLUDE_SNAPSHOTS 参数中的 值来包括快照。
boolean	deleteIfExists() 删除共享（如果存在）。
boolean	deleteIfExists(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) 使用指定的请求选项和操作上下文删除共享（如果存在）。
boolean	deleteIfExists(DeleteShareSnapshotsOption deleteSnapshotsOption, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) 使用指定的快照和请求选项以及操作上下文删除共享（如果存在）。 除非同时删除快照，否则无法删除包含快照的共享。 如果共享具有快照，请在删除基本共享时使用 INCLUDE_SNAPSHOTS 参数中的 值来包括快照。
void	downloadAttributes() 下载共享的属性，其中包括元数据和属性。
void	downloadAttributes(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) 使用指定的请求选项和操作上下文下载共享的属性，其中包括元数据和属性。
FileSharePermissions	downloadPermissions() 下载共享的权限设置。
FileSharePermissions	downloadPermissions(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) 使用指定的请求选项和操作上下文下载共享的权限设置。
boolean	exists() 返回一个值，该值指示共享是否存在。
boolean	exists(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) 使用指定的请求选项和操作上下文返回一个值，该值指示共享是否存在。
String	generateSharedAccessSignature(final SharedAccessFilePolicy policy, final String groupPolicyIdentifier) 返回共享的共享访问签名。 请注意，这不包含前导“？”。
String	generateSharedAccessSignature(final SharedAccessFilePolicy policy, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols) 返回共享的共享访问签名。 请注意，这不包含前导“？”。
String	getFilePermission(String filePermissionKey) 获取与文件权限密钥关联的文件权限。
String	getFilePermission(String filePermissionKey, FileRequestOptions options, OperationContext opContext) 获取与文件权限密钥关联的文件权限。
HashMap<String, String>	getMetadata() 返回共享的元数据。 此值通过调用 downloadAttributes()来初始化共享中的元数据，并在共享上通过调用 来 uploadMetadata()设置此值。
String	getName() 返回共享的名称。
FileShareProperties	getProperties() 返回共享的属性。
final URI	getQualifiedUri() 返回此共享的快照或共享访问签名限定 URI。
CloudFileDirectory	getRootDirectoryReference() 返回对 CloudFileDirectory 对象的引用，该对象表示此共享中的根文件目录。
CloudFileClient	getServiceClient() 返回与此共享关联的文件服务客户端。
final String	getSnapshot() 返回此共享的 snapshotID。
ShareStats	getStats() 查询此共享的服务 ShareStats。
ShareStats	getStats(FileRequestOptions options, OperationContext opContext) 查询此共享的服务 ShareStats。
StorageUri	getStorageUri() 返回所有位置的 URI 列表。
URI	getUri() 返回此共享的 URI。
final boolean	isSnapshot() 指示此共享是否为快照。
void	setMetadata(final HashMap<String, String> metadata) 设置要通过 uploadMetadata() 调用在共享上设置的名称/值对的元数据集合。 此集合将覆盖任何现有的共享元数据。 如果此值设置为空集合，则调用时 uploadMetadata() 将清除共享元数据。
void	setProperties(final FileShareProperties properties) 设置共享的属性。
void	uploadMetadata() 上传共享的元数据。
void	uploadMetadata(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) 使用指定的请求选项和操作上下文上传共享的元数据。
void	uploadPermissions(final FileSharePermissions permissions) 上传共享的权限。
void	uploadPermissions(final FileSharePermissions permissions, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) 使用指定的请求选项和操作上下文上传共享的权限。
final void	uploadProperties() 汇报存储服务上的共享属性。 使用 downloadAttributes() 从 Microsoft Azure 存储服务检索共享属性和元数据的最新值。
final void	uploadProperties(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext) 使用请求选项和操作上下文汇报共享的属性。 使用 downloadAttributes() 从 Microsoft Azure 存储服务检索共享属性和元数据的最新值。

构造函数详细信息

CloudFileShare

public CloudFileShare(final StorageUri storageUri)

使用指定的 URI 创建 类的实例。

Parameters:

storageUri - 一个 StorageUri 对象，表示共享的绝对 URI。

Throws:

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

CloudFileShare

public CloudFileShare(final StorageUri storageUri, final StorageCredentials credentials)

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

Parameters:

storageUri - 一个 StorageUri 对象，表示共享的绝对 StorageUri。

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

Throws:

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

CloudFileShare

public CloudFileShare(final String shareName, String snapshotID, final CloudFileClient client)

使用指定的名称和客户端创建 类的实例。

Parameters:

shareName - 一个 String ，它表示共享的名称，该共享必须遵循共享命名规则。 共享名称不应包含 /) (的任何路径分隔符。 共享名称必须为小写，长度介于 3-63 个字符之间，并且必须以字母或数字开头。 共享名称只能包含字母、数字和短划线 ( ) 字符。

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

client - 一个 CloudFileClient 对象，它表示关联的服务客户端，并指定文件服务的终结点。

Throws:

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

URISyntaxException - 如果基于 shareName 构造的资源 URI 无效。

CloudFileShare

public CloudFileShare(final URI uri)

使用指定的 URI 创建 类的实例。

Parameters:

uri - 一个 java.net.URI 对象，表示共享的绝对 URI。

Throws:

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

CloudFileShare

public CloudFileShare(final URI uri, final StorageCredentials credentials)

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

Parameters:

uri - 一个 java.net.URI 对象，表示共享的绝对 URI。

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

Throws:

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

方法详细信息

assertNoSnapshot

protected void assertNoSnapshot()

断言共享不是快照。

create

public void create()

创建共享。

Throws:

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

create

public void create(FileRequestOptions options, OperationContext opContext)

使用指定的选项和操作上下文创建共享。

Parameters:

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

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

Throws:

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

createFilePermission

public String createFilePermission(String permission)

创建文件权限。

Parameters:

permission - 一个 String 对象，表示要创建的文件权限。

Returns:

表示 String 与创建的文件权限关联的文件权限密钥。

Throws:

StorageException

IOException

createFilePermission

public String createFilePermission(String permission, FileRequestOptions options, OperationContext opContext)

创建文件权限。

Parameters:

permission - 一个 String 对象，表示要创建的文件权限。

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

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

Returns:

表示 String 与创建的文件权限关联的文件权限密钥。

Throws:

StorageException

IOException

createIfNotExists

public boolean createIfNotExists()

如果共享不存在，则创建该共享。

Returns:

如果共享不存在但已创建，则为 true；否则为 false。

Throws:

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

createIfNotExists

public boolean createIfNotExists(FileRequestOptions options, OperationContext opContext)

使用指定的请求选项和操作上下文创建共享（如果不存在）。

Parameters:

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

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

Returns:

如果共享不存在但已创建，则为 true；否则为 false。

Throws:

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

createSnapshot

public final CloudFileShare createSnapshot()

创建共享快照。

Returns:

一个 CloudFileShare 表示共享快照的 对象。

Throws:

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

createSnapshot

public final CloudFileShare createSnapshot(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

使用指定的请求选项和操作上下文创建文件共享的快照。

Parameters:

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

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

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

Returns:

一个 CloudFileShare 表示文件共享快照的 对象。

Throws:

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

createSnapshot

public final CloudFileShare createSnapshot(final HashMap metadata, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

使用指定的请求选项和操作上下文创建文件共享的快照。

Parameters:

metadata - 定义快照元数据的名称/值对集合，或 null。

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

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

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

Returns:

一个 CloudFileShare 表示文件共享快照的 对象。

Throws:

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

delete

public void delete()

删除共享。

Throws:

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

delete

public void delete(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

使用指定的请求选项和操作上下文删除共享。

Parameters:

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

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

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

Throws:

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

delete

public void delete(DeleteShareSnapshotsOption deleteSnapshotsOption, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

使用指定的快照和请求选项以及操作上下文删除共享。

除非同时删除快照，否则无法删除包含快照的共享。 如果共享具有快照，请在删除基本共享时使用 INCLUDE_SNAPSHOTS 参数中的 值来包括快照。

Parameters:

deleteSnapshotsOption - 一个 DeleteShareSnapshotsOption 对象，该对象指示是仅删除快照，还是删除共享及其快照。

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

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

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

Throws:

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

deleteIfExists

public boolean deleteIfExists()

删除共享（如果存在）。

Returns:

true 如果共享存在且已删除，则为 ;否则为 false。

Throws:

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

deleteIfExists

public boolean deleteIfExists(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

使用指定的请求选项和操作上下文删除共享（如果存在）。

Parameters:

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

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

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

Returns:

true 如果共享存在且已删除，则为 ;否则为 false。

Throws:

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

deleteIfExists

public boolean deleteIfExists(DeleteShareSnapshotsOption deleteSnapshotsOption, AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

使用指定的快照和请求选项以及操作上下文删除共享（如果存在）。

除非同时删除快照，否则无法删除包含快照的共享。 如果共享具有快照，请在删除基本共享时使用 INCLUDE_SNAPSHOTS 参数中的 值来包括快照。

Parameters:

deleteSnapshotsOption - 一个 DeleteShareSnapshotsOption 对象，该对象指示是仅删除快照，还是删除共享及其快照。

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

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

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

Returns:

true 如果共享存在且已删除，则为 ;否则为 false。

Throws:

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

downloadAttributes

public void downloadAttributes()

下载共享的属性，其中包括元数据和属性。

Throws:

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

downloadAttributes

public void downloadAttributes(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

使用指定的请求选项和操作上下文下载共享的属性，其中包括元数据和属性。

Parameters:

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

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

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

Throws:

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

downloadPermissions

public FileSharePermissions downloadPermissions()

下载共享的权限设置。

Returns:

一个 FileSharePermissions 表示共享权限的 对象。

Throws:

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

downloadPermissions

public FileSharePermissions downloadPermissions(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

使用指定的请求选项和操作上下文下载共享的权限设置。

Parameters:

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

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

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

Returns:

一个 FileSharePermissions 表示共享权限的 对象。

Throws:

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

exists

public boolean exists()

返回一个值，该值指示共享是否存在。

Returns:

true 如果共享存在，则为 ;否则为 false。

Throws:

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

exists

public boolean exists(final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

使用指定的请求选项和操作上下文返回一个值，该值指示共享是否存在。

Parameters:

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

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

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

Returns:

true 如果共享存在，则为 ;否则为 false。

Throws:

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

generateSharedAccessSignature

public String generateSharedAccessSignature(final SharedAccessFilePolicy policy, final String groupPolicyIdentifier)

返回共享的共享访问签名。 请注意，这不包含前导“？”。

Parameters:

policy - 一个 SharedAccessFilePolicy 对象，表示共享访问签名的访问策略。

groupPolicyIdentifier - 表示 String 共享级别访问策略的 。

Returns:

， String 它表示共享的共享访问签名。

Throws:

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

InvalidKeyException - 如果密钥无效。

generateSharedAccessSignature

public String generateSharedAccessSignature(final SharedAccessFilePolicy policy, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols)

返回共享的共享访问签名。 请注意，这不包含前导“？”。

Parameters:

policy - 一个 SharedAccessFilePolicy 对象，表示共享访问签名的访问策略。

groupPolicyIdentifier - 表示 String 共享级别访问策略的 。

ipRange - 包含 IPRange 允许的 IP 地址范围的 对象。

protocols - 表示 SharedAccessProtocols 允许的 Internet 协议的 。

Returns:

， String 它表示共享的共享访问签名。

Throws:

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

InvalidKeyException - 如果密钥无效。

getFilePermission

public String getFilePermission(String filePermissionKey)

获取与文件权限密钥关联的文件权限。

Parameters:

filePermissionKey - 一个 String 表示文件权限密钥的 对象。

Returns:

表示 String 与文件权限密钥关联的文件权限的 。

Throws:

StorageException

getFilePermission

public String getFilePermission(String filePermissionKey, FileRequestOptions options, OperationContext opContext)

获取与文件权限密钥关联的文件权限。

Parameters:

filePermissionKey - 一个 String 表示文件权限密钥的 对象。

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

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

Returns:

表示 String 与文件权限密钥关联的文件权限的 。

Throws:

StorageException

getMetadata

public HashMap getMetadata()

返回共享的元数据。 此值通过调用 downloadAttributes()来初始化共享中的元数据，并在共享上通过调用 来 uploadMetadata()设置此值。

Returns:

一个 java.util.HashMap 对象，表示共享的元数据。

getName

public String getName()

返回共享的名称。

Returns:

一个 String ，它表示共享的名称。

getProperties

public FileShareProperties getProperties()

返回共享的属性。

Returns:

一个 FileShareProperties 对象，表示共享的属性。

getQualifiedUri

public final URI getQualifiedUri()

返回此共享的快照或共享访问签名限定 URI。

Returns:

表示java.net.URI快照或共享访问签名的 对象。

Throws:

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

URISyntaxException - 如果资源 URI 无效。

getRootDirectoryReference

public CloudFileDirectory getRootDirectoryReference()

返回对 CloudFileDirectory 对象的引用，该对象表示此共享中的根文件目录。

Returns:

对此 CloudFileDirectory 共享的根目录的引用。

Throws:

StorageException

URISyntaxException

getServiceClient

public CloudFileClient getServiceClient()

返回与此共享关联的文件服务客户端。

Returns:

一个 CloudFileClient 对象，表示与此共享关联的服务客户端。

getSnapshot

public final String getSnapshot()

返回此共享的 snapshotID。

Returns:

作为此共享的字符串的 snapshotID。

getStats

public ShareStats getStats()

查询此共享的服务 ShareStats。

Returns:

ShareStats给定存储服务的 对象。

Throws:

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

getStats

public ShareStats getStats(FileRequestOptions options, OperationContext opContext)

查询此共享的服务 ShareStats。

Parameters:

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

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

Returns:

ShareStats给定存储服务的 对象。

Throws:

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

getStorageUri

public StorageUri getStorageUri()

返回所有位置的 URI 列表。

Returns:

一个 StorageUri 对象，表示所有位置的 URI 列表。

getUri

public URI getUri()

返回此共享的 URI。

Returns:

共享的绝对 URI。

isSnapshot

public final boolean isSnapshot()

指示此共享是否为快照。

Returns:

true如果共享是快照，则为 ;否则为 false。

setMetadata

public void setMetadata(final HashMap metadata)

设置要通过 uploadMetadata() 调用在共享上设置的名称/值对的元数据集合。 此集合将覆盖任何现有的共享元数据。 如果此值设置为空集合，则调用时 uploadMetadata() 将清除共享元数据。

Parameters:

metadata - 一个 java.util.HashMap 对象，表示要分配给共享的元数据。

setProperties

public void setProperties(final FileShareProperties properties)

设置共享的属性。

Parameters:

properties - 一个 FileShareProperties 对象，表示要分配给共享的属性。

uploadMetadata

public void uploadMetadata()

上传共享的元数据。

Throws:

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

uploadMetadata

public void uploadMetadata(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

使用指定的请求选项和操作上下文上传共享的元数据。

Parameters:

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

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

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

Throws:

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

uploadPermissions

public void uploadPermissions(final FileSharePermissions permissions)

上传共享的权限。

Parameters:

permissions - 一个 FileSharePermissions 表示上传权限的 对象。

Throws:

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

uploadPermissions

public void uploadPermissions(final FileSharePermissions permissions, final AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

使用指定的请求选项和操作上下文上传共享的权限。

Parameters:

permissions - 一个 FileSharePermissions 表示上传权限的 对象。

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

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

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

Throws:

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

uploadProperties

public final void uploadProperties()

汇报存储服务上的共享属性。

使用 downloadAttributes() 从 Microsoft Azure 存储服务检索共享属性和元数据的最新值。

Throws:

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

uploadProperties

public final void uploadProperties(AccessCondition accessCondition, FileRequestOptions options, OperationContext opContext)

使用请求选项和操作上下文汇报共享的属性。

使用 downloadAttributes() 从 Microsoft Azure 存储服务检索共享属性和元数据的最新值。

Parameters:

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

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

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

Throws:

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