Partilhar via


ShareFileClient Classe

Definição

Permite-lhe ShareFileClient manipular ficheiros do Armazenamento do Azure.

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

Construtores

ShareFileClient()

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

ShareFileClient(String, String, String)

Inicializa uma nova instância da ShareFileClient classe .

ShareFileClient(String, String, String, ShareClientOptions)

Inicializa uma nova instância da ShareFileClient classe .

ShareFileClient(Uri, AzureSasCredential, ShareClientOptions)

Inicializa uma nova instância da ShareFileClient classe .

ShareFileClient(Uri, ShareClientOptions)

Inicializa uma nova instância da ShareFileClient classe .

ShareFileClient(Uri, StorageSharedKeyCredential, ShareClientOptions)

Inicializa uma nova instância da ShareFileClient classe .

ShareFileClient(Uri, TokenCredential, ShareClientOptions)

Inicializa uma nova instância da ShareFileClient classe .

Tenha 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 ficheiro.

CanGenerateSasUri

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

Name

Obtém o nome do ficheiro.

Path

Obtém o caminho do ficheiro.

ShareName

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

Uri

Obtém o ponto final principal Uri do diretório.

Métodos

AbortCopy(String, ShareFileRequestConditions, CancellationToken)

Tenta cancelar uma cópia pendente iniciada anteriormente e deixa um ficheiro de destino com comprimento zero e metadados completos.

Para obter mais informações, veja Abortar Ficheiro de Cópia.

AbortCopyAsync(String, ShareFileRequestConditions, CancellationToken)

Tenta cancelar uma cópia pendente iniciada anteriormente e deixa um ficheiro de destino com comprimento zero e metadados completos.

Para obter mais informações, veja Abortar Ficheiro de Cópia.

ClearRange(HttpRange, ShareFileRequestConditions, CancellationToken)

A ClearRange(HttpRange, ShareFileRequestConditions, CancellationToken) operação limpa o range de um ficheiro.

Para obter mais informações, veja Colocar Intervalo.

ClearRangeAsync(HttpRange, ShareFileRequestConditions, CancellationToken)

A ClearRangeAsync(HttpRange, ShareFileRequestConditions, CancellationToken) operação limpa o range de um ficheiro.

Para obter mais informações, veja Colocar Intervalo.

Create(Int64, ShareFileHttpHeaders, IDictionary<String,String>, FileSmbProperties, String, ShareFileRequestConditions, CancellationToken)

Cria um novo ficheiro ou substitui um ficheiro existente.

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

CreateAsync(Int64, ShareFileHttpHeaders, IDictionary<String,String>, FileSmbProperties, String, ShareFileRequestConditions, CancellationToken)

Cria um novo ficheiro ou substitui um ficheiro existente.

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

Delete(ShareFileRequestConditions, CancellationToken)

A Delete(ShareFileRequestConditions, CancellationToken) operação remove imediatamente o ficheiro da conta de armazenamento.

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

DeleteAsync(ShareFileRequestConditions, CancellationToken)

A DeleteAsync(ShareFileRequestConditions, CancellationToken) operação remove imediatamente o ficheiro da conta de armazenamento.

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

DeleteIfExists(ShareFileRequestConditions, CancellationToken)

A DeleteIfExists(ShareFileRequestConditions, CancellationToken) operação remove imediatamente o ficheiro da conta de armazenamento, se existir.

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

DeleteIfExistsAsync(ShareFileRequestConditions, CancellationToken)

A DeleteIfExists(ShareFileRequestConditions, CancellationToken) operação remove imediatamente o ficheiro da conta de armazenamento, se existir.

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

Download(ShareFileDownloadOptions, CancellationToken)

A Download(ShareFileDownloadOptions, CancellationToken) operação lê ou transfere um ficheiro do sistema, incluindo os respetivos metadados e propriedades.

Para obter mais informações, veja Obter Ficheiro.

DownloadAsync(ShareFileDownloadOptions, CancellationToken)

A DownloadAsync(ShareFileDownloadOptions, CancellationToken) operação lê ou transfere um ficheiro do sistema, incluindo os respetivos metadados e propriedades.

Para obter mais informações, veja Obter Ficheiro.

Exists(CancellationToken)

A Exists(CancellationToken) operação pode ser chamada num ShareFileClient para ver se o ficheiro associado existe na partilha na conta de armazenamento.

ExistsAsync(CancellationToken)

A Exists(CancellationToken) operação pode ser chamada num ShareFileClient para ver se o ficheiro associado existe na partilha na conta de armazenamento.

ForceCloseAllHandles(CancellationToken)

A ForceCloseAllHandles(CancellationToken) operação fecha todos os identificadores abertos num ficheiro no serviço.

Esta API destina-se a ser utilizada juntamente GetHandlesAsync(CancellationToken) para forçar a fecho de identificadores que bloqueiam as operações. Estes identificadores podem ter sido vazados ou perdidos de controlo por clientes SMB. A API tem impacto no lado do cliente no identificador que está a ser fechado, incluindo erros visíveis do utilizador devido a tentativas falhadas de ler ou escrever ficheiros. Esta API não se destina a ser utilizada como substituição ou alternativa para fecho de SMB.

Para obter mais informações, veja Forçar Fecho de Identificadores.

ForceCloseAllHandlesAsync(CancellationToken)

A ForceCloseAllHandlesAsync(CancellationToken) operação fecha todos os identificadores abertos num ficheiro no serviço.

Esta API destina-se a ser utilizada juntamente GetHandlesAsync(CancellationToken) para forçar a fecho de identificadores que bloqueiam as operações. Estes identificadores podem ter sido vazados ou perdidos de controlo por clientes SMB. A API tem impacto no lado do cliente no identificador que está a ser fechado, incluindo erros visíveis do utilizador devido a tentativas falhadas de ler ou escrever ficheiros. Esta API não se destina a ser utilizada como substituição ou alternativa para fecho de SMB.

Para obter mais informações, veja Forçar Fecho de Identificadores.

ForceCloseHandle(String, CancellationToken)

A ForceCloseHandle(String, CancellationToken) operação fecha um identificador aberto num ficheiro no serviço. Suporta fechar uma única alça especificada por handleId.

Esta API destina-se a ser utilizada juntamente GetHandlesAsync(CancellationToken) para forçar a fecho de identificadores que bloqueiam as operações. Estes identificadores podem ter sido vazados ou perdidos de controlo por clientes SMB. A API tem impacto no lado do cliente no identificador que está a ser fechado, incluindo erros visíveis do utilizador devido a tentativas falhadas de ler ou escrever ficheiros. Esta API não se destina a ser utilizada como substituição ou alternativa para fecho de SMB.

Para obter mais informações, veja Forçar Fecho de Identificadores.

ForceCloseHandleAsync(String, CancellationToken)

A ForceCloseHandleAsync(String, CancellationToken) operação fecha um identificador aberto num ficheiro no serviço. Suporta fechar uma única alça especificada por handleId.

Esta API destina-se a ser utilizada juntamente GetHandlesAsync(CancellationToken) para forçar a fecho de identificadores que bloqueiam as operações. Estes identificadores podem ter sido vazados ou perdidos de controlo por clientes SMB. A API tem impacto no lado do cliente no identificador que está a ser fechado, incluindo erros visíveis do utilizador devido a tentativas falhadas de ler ou escrever ficheiros. Esta API não se destina a ser utilizada como substituição ou alternativa para fecho de SMB.

Para obter mais informações, veja Forçar Fecho de Identificadores.

GenerateSasUri(ShareFileSasPermissions, DateTimeOffset)

O GenerateSasUri(ShareFileSasPermissions, DateTimeOffset) devolve um Uri que gera um Uri de Assinatura de Acesso Partilhado (SAS) do Serviço de Ficheiros 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.

GenerateSasUri(ShareSasBuilder)

O GenerateSasUri(ShareSasBuilder) devolve um Uri que gera um Uri de Assinatura de Acesso Partilhado (SAS) do Serviço de Ficheiros de Partilha com base nas propriedades e no construtor do Cliente. 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.

GetHandles(CancellationToken)

A GetHandles(CancellationToken) operação devolve uma sequência assíncrona dos identificadores abertos num diretório ou ficheiro. Enumerar os identificadores pode fazer vários pedidos ao serviço ao obter todos os valores.

Para obter mais informações, veja Alças de Lista.

GetHandlesAsync(CancellationToken)

A GetHandlesAsync(CancellationToken) operação devolve uma sequência assíncrona dos identificadores abertos num diretório ou ficheiro. Enumerar os identificadores pode fazer vários pedidos ao serviço ao obter todos os valores.

Para obter mais informações, veja Alças de Lista.

GetParentShareClientCore()

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

GetParentShareDirectoryClientCore()

Crie um novo ShareDirectoryClient que aponte para este ShareFileClientcontentor principal. O novo ShareDirectoryClient utiliza o mesmo pipeline de política de pedido que o ShareFileClient.

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 o ficheiro. Não devolve o conteúdo do ficheiro.

Para obter mais informações, veja Obter Propriedades do Ficheiro.

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 o ficheiro. Não devolve o conteúdo do ficheiro.

Para obter mais informações, veja Obter Propriedades do Ficheiro.

GetRangeList(ShareFileGetRangeListOptions, CancellationToken)

Devolve a lista de intervalos válidos para um ficheiro.

Para obter mais informações, veja Intervalos de Lista.

GetRangeListAsync(ShareFileGetRangeListOptions, CancellationToken)

Devolve a lista de intervalos válidos para um ficheiro.

Para obter mais informações, veja Intervalos de Lista.

GetRangeListDiff(ShareFileGetRangeListDiffOptions, CancellationToken)

Devolve a lista de intervalos que foram alterados no ficheiro desde que previousSnapshot foi tirada.

Para obter mais informações, veja Intervalos de Lista.

GetRangeListDiffAsync(ShareFileGetRangeListDiffOptions, CancellationToken)

Devolve a lista de intervalos que foram alterados no ficheiro desde que previousSnapshot foi tirada.

Para obter mais informações, veja Intervalos de Lista.

OpenRead(ShareFileOpenReadOptions, CancellationToken)

Abre um fluxo para leitura a partir do ficheiro. O fluxo só transferirá o ficheiro à medida que o fluxo for lido.

OpenReadAsync(ShareFileOpenReadOptions, CancellationToken)

Abre um fluxo para leitura a partir do ficheiro. O fluxo só transferirá o ficheiro à medida que o fluxo for lido.

OpenWrite(Boolean, Int64, ShareFileOpenWriteOptions, CancellationToken)

Abre um fluxo para escrever no ficheiro.

OpenWriteAsync(Boolean, Int64, ShareFileOpenWriteOptions, CancellationToken)

Abre um fluxo para escrever no ficheiro.

Rename(String, ShareFileRenameOptions, CancellationToken)

Muda o nome de um ficheiro. Esta API não suporta mudar o nome de um ficheiro de uma partilha para outra ou entre contas de armazenamento.

RenameAsync(String, ShareFileRenameOptions, CancellationToken)

Muda o nome de um ficheiro. Esta API não suporta mudar o nome de um ficheiro de uma partilha para outra ou entre contas de armazenamento.

SetHttpHeaders(Nullable<Int64>, ShareFileHttpHeaders, FileSmbProperties, String, ShareFileRequestConditions, CancellationToken)

A SetHttpHeaders(Nullable<Int64>, ShareFileHttpHeaders, FileSmbProperties, String, ShareFileRequestConditions, CancellationToken) operação define as propriedades do sistema no ficheiro.

Para obter mais informações, veja Defina Propriedades do Ficheiro.

SetHttpHeadersAsync(Nullable<Int64>, ShareFileHttpHeaders, FileSmbProperties, String, ShareFileRequestConditions, CancellationToken)

A SetHttpHeadersAsync(Nullable<Int64>, ShareFileHttpHeaders, FileSmbProperties, String, ShareFileRequestConditions, CancellationToken) operação define as propriedades do sistema no ficheiro.

Para obter mais informações, veja Defina Propriedades do Ficheiro.

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

A SetMetadata(IDictionary<String,String>, ShareFileRequestConditions, CancellationToken) operação define metadados definidos pelo utilizador para o ficheiro especificado como um ou mais pares name-value.

Para obter mais informações, veja Definir Metadados de Ficheiro.

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

A SetMetadataAsync(IDictionary<String,String>, ShareFileRequestConditions, CancellationToken) operação define metadados definidos pelo utilizador para o ficheiro especificado como um ou mais pares name-value.

Para obter mais informações, veja Definir Metadados de Ficheiro.

StartCopy(Uri, ShareFileCopyOptions, CancellationToken)

Copia um blob ou ficheiro para um ficheiro de destino na conta de armazenamento.

Para obter mais informações, veja Copiar Ficheiro.

StartCopyAsync(Uri, ShareFileCopyOptions, CancellationToken)

Copia um blob ou ficheiro para um ficheiro de destino na conta de armazenamento.

Para obter mais informações, veja Copiar Ficheiro.

Upload(Stream, ShareFileUploadOptions, CancellationToken)

A Upload(Stream, ShareFileUploadOptions, CancellationToken) operação é escrita options.Stream.Stream num ficheiro.

Para obter mais informações, veja Colocar Intervalo.

UploadAsync(Stream, ShareFileUploadOptions, CancellationToken)

A UploadAsync(Stream, ShareFileUploadOptions, CancellationToken) operação é escrita options.Stream.Stream num ficheiro.

Para obter mais informações, veja Colocar Intervalo.

UploadRange(HttpRange, Stream, ShareFileUploadRangeOptions, CancellationToken)

A Azure.Storage.Files.Shares.ShareFileClient.UploadRange(Azure.HttpRange,System.IO.Stream,System.Byte[],System.IProgress{System.Int64},Azure.Storage.Files.Shares.Models.ShareFileRequestConditions,System.Threading.CancellationToken) operação é escrita content num range ficheiro.

Para obter mais informações, veja Colocar Intervalo.

UploadRangeAsync(HttpRange, Stream, ShareFileUploadRangeOptions, CancellationToken)

A Azure.Storage.Files.Shares.ShareFileClient.UploadRangeAsync(Azure.HttpRange,System.IO.Stream,System.Byte[],System.IProgress{System.Int64},Azure.Storage.Files.Shares.Models.ShareFileRequestConditions,System.Threading.CancellationToken) operação é escrita content num range ficheiro.

Para obter mais informações, veja Colocar Intervalo.

UploadRangeFromUri(Uri, HttpRange, HttpRange, ShareFileUploadRangeFromUriOptions, CancellationToken)

A UploadRangeFromUri(Uri, HttpRange, HttpRange, ShareFileUploadRangeFromUriOptions, CancellationToken) operação escreve um intervalo de um Ficheiro do Azure para outro ficheiro do Azure. Esta API é suportada apenas para a versão 2019-02-02 e superior.

UploadRangeFromUriAsync(Uri, HttpRange, HttpRange, ShareFileUploadRangeFromUriOptions, CancellationToken)

A Azure.Storage.Files.Shares.ShareFileClient.UploadRangeFromUriAsync(System.Uri,Azure.HttpRange,Azure.HttpRange,Azure.Storage.Files.Shares.Models.ShareFileRequestConditions,System.Threading.CancellationToken) operação escreve um intervalo de um Ficheiro do Azure para outro ficheiro do Azure. Esta API é suportada apenas para a versão 2019-02-02 e superior.

WithSnapshot(String)

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

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

Métodos da Extensão

GetShareLeaseClient(ShareFileClient, String)

Inicializa uma nova instância da ShareLeaseClient classe.

GetParentShareClient(ShareFileClient)

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

GetParentShareDirectoryClient(ShareFileClient)

Crie um novo ShareDirectoryClient que aponte para este ShareFileClientcontentor principal. O novo ShareDirectoryClient utiliza o mesmo pipeline de política de pedido que o ShareFileClient.

Aplica-se a