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

ShareSasBuilder 类

定义

命名空间:

Azure.Storage.Sas

程序集:

Azure.Storage.Files.Shares.dll

包:

Azure.Storage.Files.Shares v12.18.0

Source:

ShareSasBuilder.cs

ShareSasBuilder 用于为 Azure 存储共享、目录或文件生成共享访问签名 (SAS) 。

   For more information, see

创建服务 SAS。

public class ShareSasBuilder

type ShareSasBuilder = class

Public Class ShareSasBuilder

继承

Object

ShareSasBuilder

构造函数

ShareSasBuilder(ShareFileSasPermissions, DateTimeOffset)	初始化 类的新实例 ShareSasBuilder 以创建 Azure 文件 Sas。
ShareSasBuilder(ShareSasPermissions, DateTimeOffset)	初始化 类的新实例 ShareSasBuilder 以创建文件共享 Sas。

属性

CacheControl	重写为Cache-Control响应标头返回的值。
ContentDisposition	重写为 Content-Disposition 响应标头返回的值。
ContentEncoding	重写为Cache-Encoding响应标头返回的值。
ContentLanguage	重写为Cache-Language响应标头返回的值。
ContentType	重写为Cache-Type响应标头返回的值。
ExpiresOn	共享访问签名变为无效的时间。 如果已在关联的存储访问策略中指定，则必须省略此字段。
FilePath	可供访问的文件或目录的路径，或 Empty 共享 SAS 的路径。
Identifier	长度为 64 个字符的可选唯一值，与为共享指定的访问策略相关联。
IPRange	指定从中接受请求的 IP 地址或 IP 地址范围。 如果请求源自的 IP 地址与 SAS 令牌上指定的 IP 地址或地址范围不匹配，则不会对请求进行身份验证。 指定 IP 地址范围时，请注意，该范围是非独占的。
Permissions	与共享访问签名关联的权限。 用户只能执行权限允许的操作。 如果已在关联的存储访问策略中指定，则必须省略此字段。 ShareFileSasPermissions、 ShareSasPermissions或 ShareAccountSasPermissions 可用于创建权限字符串。
Protocol	可选的已签名协议字段指定允许使用 SAS 发出的请求的协议。 可能值为 HttpsAndHttp、Https 和 None。
Resource	指定可通过共享访问签名访问哪些资源。 如果共享资源是文件，则指定“f”。 这会授予对文件内容和元数据的访问权限。 如果共享资源是共享，则指定“s”。 这会授予对共享中任何文件的内容和元数据以及共享中目录和文件列表的访问权限。
ShareName	可供访问的共享的名称。
StartsOn	（可选）指定共享访问签名生效的时间。 如果使用 DateTimeOffset.MinValue 时省略，则此调用的开始时间假定为存储服务接收请求的时间。

方法

SetPermissions(ShareAccountSasPermissions)	设置文件帐户级别 SAS 的权限。
SetPermissions(ShareFileSasPermissions)	设置文件 SAS 的权限。
SetPermissions(ShareSasPermissions)	设置共享 SAS 的权限。
SetPermissions(String)	使用原始权限字符串设置 SAS 的权限。
SetPermissions(String, Boolean)	使用原始权限字符串设置 SAS 的权限。
ToSasQueryParameters(StorageSharedKeyCredential)	使用帐户的 StorageSharedKeyCredential 对此共享访问签名值进行签名，以生成适当的 SAS 查询参数来对请求进行身份验证。