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

BlobContainerClient 类

定义

命名空间:

Azure.Storage.Blobs

程序集:

Azure.Storage.Blobs.dll

包:

Azure.Storage.Blobs v12.19.1

Source:

BlobContainerClient.cs

BlobContainerClient 允许操作 Azure 存储容器及其 Blob。

public class BlobContainerClient

type BlobContainerClient = class

Public Class BlobContainerClient

继承

Object

BlobContainerClient

构造函数

BlobContainerClient()	初始化 类的新实例 BlobContainerClient 以便模拟。
BlobContainerClient(String, String)	初始化 BlobContainerClient 类的新实例。
BlobContainerClient(String, String, BlobClientOptions)	初始化 BlobContainerClient 类的新实例。
BlobContainerClient(Uri, AzureSasCredential, BlobClientOptions)	初始化 BlobContainerClient 类的新实例。
BlobContainerClient(Uri, BlobClientOptions)	初始化 BlobContainerClient 类的新实例。
BlobContainerClient(Uri, StorageSharedKeyCredential, BlobClientOptions)	初始化 BlobContainerClient 类的新实例。
BlobContainerClient(Uri, TokenCredential, BlobClientOptions)	初始化 BlobContainerClient 类的新实例。

字段

LogsBlobContainerName	用于标识存储帐户日志容器的 Azure 存储名称。
RootBlobContainerName	用于标识存储帐户根容器的 Azure 存储名称。
WebBlobContainerName	用于标识存储帐户的 Web 内容容器的 Azure 存储名称。

属性

AccountName	获取与容器客户端对应的存储帐户名称。
CanGenerateSasUri	确定客户端是否能够生成 SAS。 如果客户端使用 StorageSharedKeyCredential进行身份验证。
Name	获取容器的名称。
Uri	获取容器的主 Uri 终结点。

方法

Create(PublicAccessType, IDictionary<String,String>, BlobContainerEncryptionScopeOptions, CancellationToken)	Create(PublicAccessType, IDictionary<String,String>, BlobContainerEncryptionScopeOptions, CancellationToken)操作在指定帐户下创建一个新容器。 如果已存在同名的容器，操作将失败。 有关详细信息，请参阅 创建容器。
CreateAsync(PublicAccessType, IDictionary<String,String>, BlobContainerEncryptionScopeOptions, CancellationToken)	CreateAsync(PublicAccessType, IDictionary<String,String>, BlobContainerEncryptionScopeOptions, CancellationToken)操作在指定帐户下创建一个新容器。 如果已存在同名的容器，操作将失败。 有关详细信息，请参阅 创建容器。
CreateClient(Uri, BlobClientOptions, HttpPipeline)	初始化 BlobContainerClient 类的新实例。
CreateIfNotExists(PublicAccessType, IDictionary<String,String>, BlobContainerEncryptionScopeOptions, CancellationToken)	CreateIfNotExists(PublicAccessType, IDictionary<String,String>, BlobContainerEncryptionScopeOptions, CancellationToken)操作在指定帐户下创建一个新容器。 如果同名的容器已存在，则不会更改该容器。 有关详细信息，请参阅 创建容器。
CreateIfNotExistsAsync(PublicAccessType, IDictionary<String,String>, BlobContainerEncryptionScopeOptions, CancellationToken)	CreateIfNotExistsAsync(PublicAccessType, IDictionary<String,String>, BlobContainerEncryptionScopeOptions, CancellationToken)操作在指定帐户下创建一个新容器。 如果同名的容器已存在，则不会更改该容器。 有关详细信息，请参阅 创建容器。
Delete(BlobRequestConditions, CancellationToken)	Delete(BlobRequestConditions, CancellationToken)操作将指定的容器标记为删除。 容器及其中包含的任何 Blob 稍后将在垃圾回收期间删除，这可能需要几分钟时间。 有关详细信息，请参阅 删除容器。
DeleteAsync(BlobRequestConditions, CancellationToken)	DeleteAsync(BlobRequestConditions, CancellationToken)操作将指定的容器标记为删除。 容器及其中包含的任何 Blob 稍后将在垃圾回收期间删除，这可能需要几分钟时间。 有关详细信息，请参阅 删除容器。
DeleteBlob(String, DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)	DeleteBlob(String, DeleteSnapshotsOption, BlobRequestConditions, CancellationToken) 操作标记要删除的指定 Blob 或快照。 稍后在垃圾回收期间删除 Blob，这可能需要几分钟时间。 请注意，要删除 Blob，必须删除其所有快照。 可以使用 同时 IncludeSnapshots删除这两者。 有关详细信息，请参阅 删除 Blob。
DeleteBlobAsync(String, DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)	DeleteBlobAsync(String, DeleteSnapshotsOption, BlobRequestConditions, CancellationToken) 操作标记要删除的指定 Blob 或快照。 稍后在垃圾回收期间删除 Blob，这可能需要几分钟时间。 请注意，要删除 Blob，必须删除其所有快照。 可以使用 同时 IncludeSnapshots删除这两者。 有关详细信息，请参阅 删除 Blob。
DeleteBlobIfExists(String, DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)	如果 blob 或快照存在，则DeleteBlobIfExists(String, DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)操作将标记指定的 blob 或快照以供删除。 稍后在垃圾回收期间删除 Blob，这可能需要几分钟时间。 请注意，要删除 Blob，必须删除其所有快照。 可以使用 同时 IncludeSnapshots删除这两者。 有关详细信息，请参阅 删除 Blob。
DeleteBlobIfExistsAsync(String, DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)	如果 blob 或快照存在，则DeleteBlobIfExistsAsync(String, DeleteSnapshotsOption, BlobRequestConditions, CancellationToken)操作将标记指定的 blob 或快照以供删除。 稍后在垃圾回收期间删除 Blob，这可能需要几分钟时间。 请注意，要删除 Blob，必须删除其所有快照。 可以使用 同时 IncludeSnapshots删除这两者。 有关详细信息，请参阅 删除 Blob。
DeleteIfExists(BlobRequestConditions, CancellationToken)	操作 DeleteIfExists(BlobRequestConditions, CancellationToken) 将指定的容器标记为删除（如果存在）。 容器及其中包含的任何 Blob 稍后将在垃圾回收期间删除，这可能需要几分钟时间。 有关详细信息，请参阅 删除容器。
DeleteIfExistsAsync(BlobRequestConditions, CancellationToken)	操作 DeleteIfExistsAsync(BlobRequestConditions, CancellationToken) 将指定的容器标记为删除（如果存在）。 容器及其中包含的任何 Blob 稍后将在垃圾回收期间删除，这可能需要几分钟时间。 有关详细信息，请参阅 删除容器。
Exists(CancellationToken)	Exists(CancellationToken)可以对 调用 BlobContainerClient 操作，以查看存储服务中的存储帐户上是否存在关联的容器。
ExistsAsync(CancellationToken)	ExistsAsync(CancellationToken)可以对 调用 BlobContainerClient 操作，以查看存储服务中的存储帐户上是否存在关联的容器。
FindBlobsByTags(String, CancellationToken)	通过筛选 Blob 操作，调用方可以列出所有容器中的 Blob，这些容器的标记与给定的搜索表达式匹配，并且仅返回表达式中显示的标记。 筛选器 Blob 在存储帐户中的所有容器中进行搜索，但可以在表达式中限定为单个容器。 有关详细信息，请参阅 通过标记查找 Blob。
FindBlobsByTagsAsync(String, CancellationToken)	通过筛选 Blob 操作，调用方可以列出所有容器中的 Blob，这些容器的标记与给定的搜索表达式匹配，并且仅返回表达式中显示的标记。 筛选器 Blob 在存储帐户中的所有容器中进行搜索，但可以在表达式中限定为单个容器。 有关详细信息，请参阅 通过标记查找 Blob。
GenerateSasUri(BlobContainerSasPermissions, DateTimeOffset)	GenerateSasUri(BlobContainerSasPermissions, DateTimeOffset)返回一个 ，Uri根据传递的客户端属性和参数生成 Blob 容器服务共享访问签名 (SAS) URI。 SAS 由客户端的共享密钥凭据签名。 若要检查客户端是否能够对服务 Sas 进行签名，请参阅 CanGenerateSasUri。 有关详细信息，请参阅 构造服务 SAS。
GenerateSasUri(BlobSasBuilder)	GenerateSasUri(BlobSasBuilder)返回一个 ，Uri根据传递的客户端属性和生成器生成 Blob 容器服务共享访问签名 (SAS) URI。 SAS 由客户端的共享密钥凭据签名。 若要检查客户端是否能够对服务 Sas 进行签名，请参阅 CanGenerateSasUri。 有关详细信息，请参阅 构造服务 SAS。
GetAccessPolicy(BlobRequestConditions, CancellationToken)	操作 GetAccessPolicy(BlobRequestConditions, CancellationToken) 获取此容器的权限。 这些权限指示是否可以公开访问容器数据。 有关详细信息，请参阅 获取容器 ACL。
GetAccessPolicyAsync(BlobRequestConditions, CancellationToken)	操作 GetAccessPolicyAsync(BlobRequestConditions, CancellationToken) 获取此容器的权限。 这些权限指示是否可以公开访问容器数据。 有关详细信息，请参阅 获取容器 ACL。
GetAppendBlobClientCore(String)	AppendBlobClient通过连接到 blobName 的Uri末尾创建新的 对象。 新的 AppendBlobClient 使用与 相同的请求策略管道 BlobContainerClient。
GetBlobBaseClientCore(String)	通过将 追加blobName到 的Uri末尾来创建新的 BlobBaseClient 对象。 新的 BlobBaseClient 使用与 相同的请求策略管道 BlobContainerClient。
GetBlobClient(String)	通过将 追加blobName到 的Uri末尾来创建新的 BlobClient 对象。 新的 BlobClient 使用与 相同的请求策略管道 BlobContainerClient。
GetBlobLeaseClientCore(String)	初始化 BlobLeaseClient 类的新实例。
GetBlobs(BlobTraits, BlobStates, String, CancellationToken)	操作 GetBlobs(BlobTraits, BlobStates, String, CancellationToken) 将返回此容器中的 Blob 的异步序列。 枚举 Blob 可能会在提取所有值时向服务发出多个请求。 Blob 按字典顺序按名称排序。 有关详细信息，请参阅 列出 Blob。
GetBlobsAsync(BlobTraits, BlobStates, String, CancellationToken)	操作 GetBlobsAsync(BlobTraits, BlobStates, String, CancellationToken) 将返回此容器中的 Blob 的异步序列。 枚举 Blob 可能会在提取所有值时向服务发出多个请求。 Blob 按字典顺序按名称排序。 有关详细信息，请参阅 列出 Blob。
GetBlobsByHierarchy(BlobTraits, BlobStates, String, String, CancellationToken)	操作 GetBlobsByHierarchy(BlobTraits, BlobStates, String, String, CancellationToken) 将返回此容器中 Blob 的异步集合。 枚举 Blob 可能会在提取所有值时向服务发出多个请求。 Blob 按字典顺序按名称排序。 delimiter可用于遍历 Blob 的虚拟层次结构，就像它是文件系统一样。 有关详细信息，请参阅 列出 Blob。
GetBlobsByHierarchyAsync(BlobTraits, BlobStates, String, String, CancellationToken)	操作 GetBlobsByHierarchyAsync(BlobTraits, BlobStates, String, String, CancellationToken) 将返回此容器中 Blob 的异步集合。 枚举 Blob 可能会在提取所有值时向服务发出多个请求。 Blob 按字典顺序按名称排序。 delimiter可用于遍历 Blob 的虚拟层次结构，就像它是文件系统一样。 有关详细信息，请参阅 列出 Blob。
GetBlockBlobClientCore(String)	BlockBlobClient通过连接到 blobName 的Uri末尾创建新的 对象。 新的 BlockBlobClient 使用与 相同的请求策略管道 BlobContainerClient。
GetPageBlobClientCore(String)	PageBlobClient通过连接到 blobName 的Uri末尾创建新的 对象。 新的 PageBlobClient 使用与 相同的请求策略管道 BlobContainerClient。
GetParentBlobServiceClientCore()	创建一个指向此 BlobContainerClientBlob 服务的新 BlobServiceClient 。 新的 BlobServiceClient 使用与 相同的请求策略管道 BlobContainerClient。
GetProperties(BlobRequestConditions, CancellationToken)	GetProperties(BlobRequestConditions, CancellationToken)操作返回指定容器的所有用户定义的元数据和系统属性。 返回的数据不包含该容器的 Blob 列表。 有关详细信息，请参阅 获取容器属性。
GetPropertiesAsync(BlobRequestConditions, CancellationToken)	GetPropertiesAsync(BlobRequestConditions, CancellationToken)操作返回指定容器的所有用户定义的元数据和系统属性。 返回的数据不包含该容器的 Blob 列表。 有关详细信息，请参阅 获取容器属性。
SetAccessPolicy(PublicAccessType, IEnumerable<BlobSignedIdentifier>, BlobRequestConditions, CancellationToken)	SetAccessPolicy(PublicAccessType, IEnumerable<BlobSignedIdentifier>, BlobRequestConditions, CancellationToken) 操作设置指定容器的权限。 权限指示是否可以公开访问 Blob 容器数据。 有关详细信息，请参阅 设置容器 ACL。
SetAccessPolicyAsync(PublicAccessType, IEnumerable<BlobSignedIdentifier>, BlobRequestConditions, CancellationToken)	SetAccessPolicyAsync(PublicAccessType, IEnumerable<BlobSignedIdentifier>, BlobRequestConditions, CancellationToken) 操作设置指定容器的权限。 权限指示是否可以公开访问 Blob 容器数据。 有关详细信息，请参阅 设置容器 ACL。
SetMetadata(IDictionary<String,String>, BlobRequestConditions, CancellationToken)	SetMetadata(IDictionary<String,String>, BlobRequestConditions, CancellationToken) 操作为指定的容器设置一个或多个用户定义的名称-值对。 有关详细信息，请参阅 设置容器元数据。
SetMetadataAsync(IDictionary<String,String>, BlobRequestConditions, CancellationToken)	SetMetadataAsync(IDictionary<String,String>, BlobRequestConditions, CancellationToken) 操作为指定的容器设置一个或多个用户定义的名称-值对。 有关详细信息，请参阅 设置容器元数据。
UploadBlob(String, BinaryData, CancellationToken)	操作 UploadBlob(String, BinaryData, CancellationToken) 将创建新的块 Blob。 有关部分块 Blob 更新和其他高级功能，请参阅 BlockBlobClient。 若要创建或修改页或追加 Blob，请参阅 PageBlobClient 或 AppendBlobClient。 有关详细信息，请参阅 放置 Blob。
UploadBlob(String, Stream, CancellationToken)	操作 UploadBlob(String, Stream, CancellationToken) 将创建新的块 Blob。 有关部分块 Blob 更新和其他高级功能，请参阅 BlockBlobClient。 若要创建或修改页或追加 Blob，请参阅 PageBlobClient 或 AppendBlobClient。 有关详细信息，请参阅 放置 Blob。
UploadBlobAsync(String, BinaryData, CancellationToken)	操作 UploadBlobAsync(String, BinaryData, CancellationToken) 将创建新的块 Blob。 有关部分块 Blob 更新和其他高级功能，请参阅 BlockBlobClient。 若要创建或修改页或追加 Blob，请参阅 PageBlobClient 或 AppendBlobClient。 有关详细信息，请参阅 放置 Blob。
UploadBlobAsync(String, Stream, CancellationToken)	操作 UploadBlobAsync(String, Stream, CancellationToken) 将创建新的块 Blob。 有关部分块 Blob 更新和其他高级功能，请参阅 BlockBlobClient。 若要创建或修改页或追加 Blob，请参阅 PageBlobClient 或 AppendBlobClient。 有关详细信息，请参阅 放置 Blob。

扩展方法

GetAppendBlobClient(BlobContainerClient, String)	通过连接到 blobName 的Uri末尾client来创建新的 AppendBlobClient 对象。 新的 AppendBlobClient 使用与 相同的请求策略管道 BlobContainerClient。
GetBlobBaseClient(BlobContainerClient, String)	通过连接到 blobName 的Uri末尾client来创建新的 BlobBaseClient 对象。 新的 BlobBaseClient 使用与 相同的请求策略管道 BlobContainerClient。
GetBlobBatchClient(BlobContainerClient)	BlobBatchClient为与 BlobContainerClient关联的容器创建新的 对象。 新的 BlobBatchClient 使用与 相同的请求策略管道 BlobContainerClient。
GetBlobLeaseClient(BlobContainerClient, String)	初始化 BlobLeaseClient 类的新实例。
GetBlockBlobClient(BlobContainerClient, String)	通过连接到 blobName 的Uri末尾client来创建新的 BlockBlobClient 对象。 新的 BlockBlobClient 使用与 相同的请求策略管道 BlobContainerClient。
GetParentBlobServiceClient(BlobContainerClient)	创建一个指向此 BlobContainerClientBlob 服务的新 BlobServiceClient 。 新的 BlobServiceClient 使用与 相同的请求策略管道 BlobContainerClient。