你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
SasQueryParameters 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
对象 SasQueryParameters 表示构成 Azure 存储共享访问签名查询参数的组件。 它包括所有 Azure 存储资源使用的组件， (Blob 容器、Blob、文件和队列) 。 可以使用特定于服务的 SAS 生成器类型构造新实例。 有关详细信息，请参阅： 创建服务 SAS。
public class SasQueryParameterstype SasQueryParameters = classPublic Class SasQueryParameters- 继承
-
SasQueryParameters
- 派生
构造函数
| SasQueryParameters() |
初始化 SasQueryParameters 类的新实例。 |
| SasQueryParameters(IDictionary<String,String>) |
基于提供的查询参数 |
| 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>) |
基于提供的查询参数 |
| 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 编码的查询字符串。 |
