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

SasQueryParameters 类

定义

命名空间:

Azure.Storage.Sas

程序集:

Azure.Storage.Common.dll

包:

Azure.Storage.Common v12.19.0

Source:

SasQueryParameters.cs

对象 SasQueryParameters 表示构成 Azure 存储共享访问签名查询参数的组件。 它包括所有 Azure 存储资源使用的组件， (Blob 容器、Blob、文件和队列) 。 可以使用特定于服务的 SAS 生成器类型构造新实例。 有关详细信息，请参阅： 创建服务 SAS。

public class SasQueryParameters

type SasQueryParameters = class

Public Class SasQueryParameters

继承

Object

SasQueryParameters

派生

Azure.Storage.Sas.BlobSasQueryParameters

Azure.Storage.Sas.DataLakeSasQueryParameters

构造函数

SasQueryParameters()	初始化 SasQueryParameters 类的新实例。
SasQueryParameters(IDictionary<String,String>)	基于提供的查询参数 values创建 类型的新实例SasQueryParameters。 将从 中删除 values所有与 SAS 相关的查询参数。
SasQueryParameters(String, Nullable<AccountSasServices>, Nullable<AccountSasResourceTypes>, SasProtocol, DateTimeOffset, DateTimeOffset, SasIPRange, String, String, String, String, String, String, String, String, String, String, String, String, Nullable<Int32>, String)	创建新的 SasQueryParameters 实例。

字段

DefaultSasVersion

用于共享访问签名的默认服务版本。

属性

AgentObjectId	获取与共享访问签名关联的未经授权的 AAD 对象 ID。 用户委派密钥的所有者假定未授权的用户的 AAD 对象 ID。 Azure 存储服务将执行额外的 POSIX ACL 检查，以确定用户是否有权执行请求的操作。 这不能用于与 PreauthorizedAgentObjectId的结合。 仅在已启用 HNS 的帐户中有效。 如果在未启用 HNS 的帐户中设置此值，则会引发授权失败。
CacheControl	获取Cache-Control响应标头，该标头允许指定要用于 Blob 和文件下载的客户端缓存。
ContentDisposition	获取 Content-Disposition 响应标头，该标头允许指定 Blob 或文件内容在浏览器中的显示方式。
ContentEncoding	获取内容编码响应标头，该标头允许指定用于 Blob 和文件下载的编码类型。
ContentLanguage	获取 Content-Language 响应标头，该标头允许指定下载的 Blob 或文件内容的语言。
ContentType	获取 Content-Type 响应标头，该标头允许指定下载的 Blob 或文件内容的类型。
CorrelationId	获取与共享访问签名关联的关联 ID。 这用于将存储审核日志与生成和分发 SAS 的主体使用的审核日志相关联。
DirectoryDepth	获取字符串到符号的规范化resource 字段中指定的目录深度。 目录的深度是根文件夹下的目录数。 当资源 (sr) = d 以指示目录深度时是必需的。 该值必须是非负整数。
Empty	获取空的共享访问签名查询参数。
EncryptionScope	获取与共享访问签名关联的加密范围。
ExpiresOn	获取共享访问签名失效的时间。 MinValue 表示未设置。
Identifier	获取长度为 64 个字符的可选唯一值，该值与为 Blob 容器、队列或共享指定的访问策略相关联。
IPRange	获取接受请求的可选 IP 地址或 IP 地址范围。 指定范围时，请注意该区域是非独占的。
Permissions	获取与共享访问签名关联的权限。 用户只能执行权限允许的操作。 如果已在关联的存储访问策略中指定，则必须省略此字段。
PreauthorizedAgentObjectId	获取与共享访问签名关联的授权 AAD 对象 ID。 用户委派密钥所有者授权执行 SAS 授予的操作的用户的 AAD 对象 ID。 Azure 存储服务将确保用户委派密钥的所有者在授予访问权限之前具有所需的权限，但不会对此值中指定的用户执行其他权限检查。 这不能用于与 AgentObjectId的结合。 仅在已启用 HNS 的帐户中有效。 如果在未启用 HNS 的帐户中设置此值，则会引发授权失败。
Protocol	可选。 指定允许使用共享访问签名发出的请求的协议。
Resource	获取可通过共享访问签名访问的资源。
ResourceTypes	获取可通过共享访问签名访问的资源。
Services	获取可通过帐户级别共享访问签名访问的已签名服务。
Signature	获取字符串到签名，这是从字段构造的唯一字符串，必须验证该字段才能对请求进行身份验证。 该签名是利用 SHA256 算法通过 string-to-sign 和密钥计算，然后使用 Base64 编码方式进行编码的 HMAC。
StartsOn	获取共享访问签名生效的可选时间。 如果省略，将假定此调用的开始时间就是存储服务收到请求的时间。 MinValue 表示未设置。
Version	获取用于对此共享访问签名发出的请求进行身份验证的存储服务版本，以及处理使用此共享访问签名发出的请求时要使用的服务版本。

方法

AppendProperties(StringBuilder)	生成 SasQueryParameters 实例的查询参数字符串。
Create(IDictionary<String,String>)	基于提供的查询参数 values创建 类型的新实例SasQueryParameters。 将从 中删除 values所有与 SAS 相关的查询参数。
Create(String, Nullable<AccountSasServices>, Nullable<AccountSasResourceTypes>, SasProtocol, DateTimeOffset, DateTimeOffset, SasIPRange, String, String, String, String, String, String, String, String, String, String, String, String, Nullable<Int32>, String)	创建新的 SasQueryParameters 实例。
ToString()	将 SAS 查询参数转换为 URL 编码的查询字符串。