ShareClient Classe

Definição

Permite-lhe ShareClient manipular partilhas do Armazenamento do Azure e os respetivos diretórios e ficheiros.

public class ShareClient
type ShareClient = class
Public Class ShareClient
Herança
ShareClient

Construtores

ShareClient()

Inicializa uma nova instância da ShareClient classe para simular.

ShareClient(String, String)

Inicializa uma nova instância da ShareClient classe .

ShareClient(String, String, ShareClientOptions)

Inicializa uma nova instância da ShareClient classe .

ShareClient(Uri, AzureSasCredential, ShareClientOptions)

Inicializa uma nova instância da ShareClient classe .

Tenha em atenção que a autenticação de credenciais de token só é compatível com as GetPermission(String, CancellationToken)operações ao nível da partilha , GetPermissionAsync(String, CancellationToken), CreatePermission(String, CancellationToken)e CreatePermissionAsync(String, CancellationToken) .

ShareClient(Uri, ShareClientOptions)

Inicializa uma nova instância da ShareClient classe .

ShareClient(Uri, StorageSharedKeyCredential, ShareClientOptions)

Inicializa uma nova instância da ShareClient classe .

ShareClient(Uri, TokenCredential, ShareClientOptions)

Inicializa uma nova instância da ShareClient classe .

Tenha em atenção que as únicas operações ao nível da partilha que suportam a autenticação de credenciais de token são CreatePermission(String, CancellationToken), CreatePermissionAsync(String, CancellationToken), GetPermission(String, CancellationToken)e GetPermissionAsync(String, CancellationToken).

Este construtor também permite a construção de um ShareServiceClient que pode ser utilizado para derivar uma ShareClient autenticação com credenciais de token.

Tenha também em atenção que ShareTokenIntent é atualmente necessário para a autenticação de tokens.

Propriedades

AccountName

Obtém o nome da conta de Armazenamento correspondente ao cliente de partilha.

CanGenerateSasUri

Determina se o cliente é capaz de gerar uma SAS. Se o cliente for autenticado com um StorageSharedKeyCredential.

Name

Obtém o nome da partilha.

Uri

Obtém o ponto final principal Uri da partilha.

Métodos

Create(ShareCreateOptions, CancellationToken)

A Create(ShareCreateOptions, CancellationToken) operação cria uma nova partilha na conta especificada. Se já existir uma partilha com o mesmo nome, a operação falhará.

Para obter mais informações, veja Criar Partilha.

CreateAsync(ShareCreateOptions, CancellationToken)

A CreateAsync(ShareCreateOptions, CancellationToken) operação cria uma nova partilha na conta especificada. Se já existir uma partilha com o mesmo nome, a operação falhará.

Para obter mais informações, veja Criar Partilha.

CreateDirectory(String, IDictionary<String,String>, FileSmbProperties, String, CancellationToken)

A CreateDirectory(String, IDictionary<String,String>, FileSmbProperties, String, CancellationToken) operação cria um novo diretório nesta partilha.

Para obter mais informações, veja Criar Diretório.

CreateDirectoryAsync(String, IDictionary<String,String>, FileSmbProperties, String, CancellationToken)

A CreateDirectoryAsync(String, IDictionary<String,String>, FileSmbProperties, String, CancellationToken) operação cria um novo diretório nesta partilha.

Para obter mais informações, veja Criar Diretório.

CreateIfNotExists(ShareCreateOptions, CancellationToken)

A CreateIfNotExists(ShareCreateOptions, CancellationToken) operação cria uma nova partilha na conta especificada. Se já existir uma partilha com o mesmo nome, esta não será alterada.

Para obter mais informações, veja Criar Partilha.

CreateIfNotExistsAsync(IDictionary<String,String>, Nullable<Int32>, CancellationToken)

A CreateIfNotExistsAsync(IDictionary<String,String>, Nullable<Int32>, CancellationToken) operação cria uma nova partilha na conta especificada. Se já existir uma partilha com o mesmo nome, esta não será alterada.

Para obter mais informações, veja Criar Partilha.

CreateIfNotExistsAsync(ShareCreateOptions, CancellationToken)

A CreateIfNotExistsAsync(IDictionary<String,String>, Nullable<Int32>, CancellationToken) operação cria uma nova partilha na conta especificada. Se já existir uma partilha com o mesmo nome, esta não será alterada.

Para obter mais informações, veja Criar Partilha.

CreatePermission(String, CancellationToken)

Cria uma permissão (um descritor de segurança) ao nível da partilha. O descritor de segurança criado pode ser utilizado para os ficheiros/diretórios na partilha.

CreatePermissionAsync(String, CancellationToken)

Cria uma permissão (um descritor de segurança) ao nível da partilha. O descritor de segurança criado pode ser utilizado para os ficheiros/diretórios na partilha.

CreateSnapshot(IDictionary<String,String>, CancellationToken)

Cria um instantâneo só de leitura de uma partilha.

Para obter mais informações, veja Partilha de Instantâneos.

CreateSnapshotAsync(IDictionary<String,String>, CancellationToken)

Cria um instantâneo só de leitura de uma partilha.

Para obter mais informações, veja Partilha de Instantâneos.

Delete(ShareDeleteOptions, CancellationToken)

Marca o instantâneo de partilha ou partilha especificado para eliminação. O instantâneo de partilha ou partilha e quaisquer ficheiros nele contidos são posteriormente eliminados durante a libertação da memória, o que pode demorar vários minutos.

Para obter mais informações, veja Eliminar Partilha.

DeleteAsync(ShareDeleteOptions, CancellationToken)

Marca o instantâneo de partilha ou partilha especificado para eliminação. O instantâneo de partilha ou partilha e quaisquer ficheiros nele contidos são posteriormente eliminados durante a libertação da memória, o que pode demorar vários minutos.

Para obter mais informações, veja Eliminar Partilha.

DeleteDirectory(String, CancellationToken)

A DeleteDirectory(String, CancellationToken) operação remove o diretório vazio especificado.

Para obter mais informações, veja Eliminar Diretório.

DeleteDirectoryAsync(String, CancellationToken)

A DeleteDirectoryAsync(String, CancellationToken) operação remove o diretório vazio especificado.

Para obter mais informações, veja Eliminar Diretório.

DeleteIfExists(ShareDeleteOptions, CancellationToken)

Marca o instantâneo de partilha ou partilha especificado para eliminação, se existir.

Para obter mais informações, veja Eliminar Partilha.

DeleteIfExistsAsync(ShareDeleteOptions, CancellationToken)

Marca o instantâneo de partilha ou partilha especificado para eliminação, se existir.

Para obter mais informações, veja Eliminar Partilha.

Exists(CancellationToken)

A Exists(CancellationToken) operação pode ser chamada num ShareClient para ver se a partilha associada existe na conta de armazenamento no serviço de armazenamento.

ExistsAsync(CancellationToken)

A ExistsAsync(CancellationToken) operação pode ser chamada num ShareClient para ver se a partilha associada existe na conta de armazenamento no serviço de armazenamento.

GenerateSasUri(ShareSasBuilder)

O GenerateSasUri(ShareSasBuilder) devolve um Uri que gera um Uri de Assinatura de Acesso Partilhado (SAS) do Serviço de Contentor de Blobs com base nas propriedades do Cliente e no construtor transmitidos. A SAS é assinada pela credencial de chave partilhada do cliente.

Para verificar se o cliente consegue assinar um Serviço Sas, consulte CanGenerateSasUri.

Para obter mais informações, veja Construir uma SAS de Serviço.

GenerateSasUri(ShareSasPermissions, DateTimeOffset)

O GenerateSasUri(ShareSasPermissions, DateTimeOffset) devolve um Uri que gera um Uri de Assinatura de Acesso Partilhado (SAS) do Serviço de Partilha com base nas propriedades e parâmetros do Cliente transmitidos. A SAS é assinada pela credencial de chave partilhada do cliente.

Para verificar se o cliente consegue assinar um Serviço Sas, consulte CanGenerateSasUri.

Para obter mais informações, veja Construir uma SAS de serviço.

GetAccessPolicy(ShareFileRequestConditions, CancellationToken)

A GetAccessPolicy(ShareFileRequestConditions, CancellationToken) operação obtém as permissões para esta partilha. As permissões indicam se os dados de partilha podem ser acedidos publicamente.

Para obter mais informações, veja Obter ACL de Partilha.

GetAccessPolicyAsync(ShareFileRequestConditions, CancellationToken)

A GetAccessPolicyAsync(ShareFileRequestConditions, CancellationToken) operação obtém as permissões para esta partilha. As permissões indicam se os dados de partilha podem ser acedidos publicamente.

Para obter mais informações, veja Obter ACL de Partilha.

GetDirectoryClient(String)

Crie um novo ShareDirectoryClient objeto ao acrescentar directoryName ao final de Uri. O novo ShareDirectoryClient utiliza o mesmo pipeline de política de pedido que o ShareClient.

GetParentServiceClientCore()

Crie um novo ShareServiceClient que aponte para o contentor principal deste ShareClient. O novo ShareServiceClient utiliza o mesmo pipeline de política de pedido que o ShareClient.

GetPermission(String, CancellationToken)

Obtém a permissão de ficheiro em Security Descriptor Definition Language (SDDL).

GetPermissionAsync(String, CancellationToken)

Obtém a permissão de ficheiro em Security Descriptor Definition Language (SDDL).

GetProperties(ShareFileRequestConditions, CancellationToken)

A GetProperties(ShareFileRequestConditions, CancellationToken) operação devolve todos os metadados definidos pelo utilizador, propriedades HTTP padrão e propriedades do sistema para a partilha.

Para obter mais informações, veja Obter Propriedades de Partilha.

GetPropertiesAsync(ShareFileRequestConditions, CancellationToken)

A GetPropertiesAsync(ShareFileRequestConditions, CancellationToken) operação devolve todos os metadados definidos pelo utilizador, propriedades HTTP padrão e propriedades do sistema para a partilha.

Para obter mais informações, veja Obter Propriedades de Partilha.

GetRootDirectoryClient()

Crie um ShareDirectoryClient objeto para a raiz da partilha. O novo ShareDirectoryClient utiliza o mesmo pipeline de política de pedido que o ShareClient.

GetStatistics(ShareFileRequestConditions, CancellationToken)

Obtém estatísticas relacionadas com a partilha.

Para obter mais informações, veja Obter Estatísticas de Partilha.

GetStatisticsAsync(ShareFileRequestConditions, CancellationToken)

Obtém estatísticas relacionadas com a partilha.

Para obter mais informações, veja Obter Estatísticas de Partilha.

SetAccessPolicy(IEnumerable<ShareSignedIdentifier>, ShareFileRequestConditions, CancellationToken)

A SetAccessPolicy(IEnumerable<ShareSignedIdentifier>, ShareFileRequestConditions, CancellationToken) operação define as permissões para a partilha especificada. As permissões indicam se os dados de partilha podem ser acedidos publicamente.

Para obter mais informações, veja Defina Partilhar ACL.

SetAccessPolicyAsync(IEnumerable<ShareSignedIdentifier>, ShareFileRequestConditions, CancellationToken)

A SetAccessPolicyAsync(IEnumerable<ShareSignedIdentifier>, ShareFileRequestConditions, CancellationToken) operação define as permissões para a partilha especificada. As permissões indicam se os dados de partilha podem ser acedidos publicamente.

Para obter mais informações, veja Defina Partilhar ACL.

SetMetadata(IDictionary<String,String>, ShareFileRequestConditions, CancellationToken)

A SetMetadata(IDictionary<String,String>, ShareFileRequestConditions, CancellationToken) operação define metadados definidos pelo utilizador para a partilha especificada como um ou mais pares nome-valor.

Para obter mais informações, veja Defina Partilhar Metadados.

SetMetadataAsync(IDictionary<String,String>, ShareFileRequestConditions, CancellationToken)

A SetMetadataAsync(IDictionary<String,String>, ShareFileRequestConditions, CancellationToken) operação define metadados definidos pelo utilizador para a partilha especificada como um ou mais pares nome-valor.

Para obter mais informações, veja Defina Partilhar Metadados.

SetProperties(ShareSetPropertiesOptions, CancellationToken)

Define as propriedades da partilha.

Para obter mais informações, veja Defina Propriedades de Partilha.

SetPropertiesAsync(ShareSetPropertiesOptions, CancellationToken)

Define as propriedades da partilha.

Para obter mais informações, veja Defina Propriedades de Partilha.

WithSnapshot(String)

Inicializa uma nova instância da classe com uma origem ShareClient idêntica Uri , mas o carimbo de data/hora especificado snapshot .

Para obter mais informações, veja Partilha de Instantâneos.

Métodos da Extensão

GetShareLeaseClient(ShareClient, String)

Inicializa uma nova instância da ShareLeaseClient classe.

GetParentServiceClient(ShareClient)

Crie um novo ShareServiceClient que aponte para este ShareClientcontentor principal. O novo ShareServiceClient utiliza o mesmo pipeline de política de pedido que o ShareClient.

Aplica-se a