ShareFileClient Classe

Definizione

consente ShareFileClient di modificare i file di Archiviazione di Azure.

public class ShareFileClient
type ShareFileClient = class
Public Class ShareFileClient
Ereditarietà
ShareFileClient

Costruttori

ShareFileClient()

Inizializza una nuova istanza della ShareFileClient classe per la simulazione.

ShareFileClient(String, String, String)

Inizializza una nuova istanza della classe ShareFileClient.

ShareFileClient(String, String, String, ShareClientOptions)

Inizializza una nuova istanza della classe ShareFileClient.

ShareFileClient(Uri, AzureSasCredential, ShareClientOptions)

Inizializza una nuova istanza della classe ShareFileClient.

ShareFileClient(Uri, ShareClientOptions)

Inizializza una nuova istanza della classe ShareFileClient.

ShareFileClient(Uri, StorageSharedKeyCredential, ShareClientOptions)

Inizializza una nuova istanza della classe ShareFileClient.

ShareFileClient(Uri, TokenCredential, ShareClientOptions)

Inizializza una nuova istanza della classe ShareFileClient.

Si noti che ShareTokenIntent è attualmente necessario per l'autenticazione del token.

Proprietà

AccountName

Ottiene il nome dell'account di archiviazione corrispondente al client di file.

CanGenerateSasUri

Determina se il client è in grado di generare una firma di accesso condiviso. Se il client viene autenticato con un StorageSharedKeyCredentialoggetto .

Name

Recupera il nome del file.

Path

Ottiene il percorso del file.

ShareName

Ottiene il nome della condivisione corrispondente al client di file.

Uri

Ottiene l'endpoint primario Uri della directory.

Metodi

AbortCopy(String, ShareFileRequestConditions, CancellationToken)

Tenta di annullare una copia in sospeso avviata in precedenza e lascia un file di destinazione con lunghezza zero e metadati completi.

Per ulteriori informazioni, vedere Annullare l'interruzione del file di copia.

AbortCopyAsync(String, ShareFileRequestConditions, CancellationToken)

Tenta di annullare una copia in sospeso avviata in precedenza e lascia un file di destinazione con lunghezza zero e metadati completi.

Per ulteriori informazioni, vedere Annullare l'interruzione del file di copia.

ClearRange(HttpRange, ShareFileRequestConditions, CancellationToken)

L'operazione ClearRange(HttpRange, ShareFileRequestConditions, CancellationToken) cancella l'oggetto range di un file.

Per ulteriori informazioni, vedere Inserisci intervallo.

ClearRangeAsync(HttpRange, ShareFileRequestConditions, CancellationToken)

L'operazione ClearRangeAsync(HttpRange, ShareFileRequestConditions, CancellationToken) cancella l'oggetto range di un file.

Per ulteriori informazioni, vedere Inserisci intervallo.

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

Crea un nuovo file o sostituisce un file esistente.

Per ulteriori informazioni, vedere Crea file.

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

Crea un nuovo file o sostituisce un file esistente.

Per ulteriori informazioni, vedere Crea file.

Delete(ShareFileRequestConditions, CancellationToken)

L'operazione Delete(ShareFileRequestConditions, CancellationToken) rimuove immediatamente il file dall'account di archiviazione.

Per ulteriori informazioni, vedere Elimina file.

DeleteAsync(ShareFileRequestConditions, CancellationToken)

L'operazione DeleteAsync(ShareFileRequestConditions, CancellationToken) rimuove immediatamente il file dall'account di archiviazione.

Per ulteriori informazioni, vedere Elimina file.

DeleteIfExists(ShareFileRequestConditions, CancellationToken)

L'operazione DeleteIfExists(ShareFileRequestConditions, CancellationToken) rimuove immediatamente il file dall'account di archiviazione, se presente.

Per ulteriori informazioni, vedere Elimina file.

DeleteIfExistsAsync(ShareFileRequestConditions, CancellationToken)

L'operazione DeleteIfExists(ShareFileRequestConditions, CancellationToken) rimuove immediatamente il file dall'account di archiviazione, se presente.

Per ulteriori informazioni, vedere Elimina file.

Download(ShareFileDownloadOptions, CancellationToken)

L'operazione Download(ShareFileDownloadOptions, CancellationToken) legge o scarica un file dal sistema, inclusi le proprietà e i metadati relativi.

Per ulteriori informazioni, vedere Recupera file.

DownloadAsync(ShareFileDownloadOptions, CancellationToken)

L'operazione DownloadAsync(ShareFileDownloadOptions, CancellationToken) legge o scarica un file dal sistema, inclusi le proprietà e i metadati relativi.

Per ulteriori informazioni, vedere Recupera file.

Exists(CancellationToken)

L'operazione Exists(CancellationToken) può essere chiamata su un ShareFileClient oggetto per verificare se il file associato esiste nella condivisione nell'account di archiviazione.

ExistsAsync(CancellationToken)

L'operazione Exists(CancellationToken) può essere chiamata su un ShareFileClient oggetto per verificare se il file associato esiste nella condivisione nell'account di archiviazione.

ForceCloseAllHandles(CancellationToken)

L'operazione ForceCloseAllHandles(CancellationToken) chiude tutti gli handle aperti in un file nel servizio.

Questa API deve essere usata insieme GetHandlesAsync(CancellationToken) a per forzare gli handle di chiusura che bloccano le operazioni. Questi handle possono essere stati smarriti o perso traccia da parte dei client SMB. L'API ha un impatto sul lato client sulla chiusura dell'handle, inclusi gli errori visibili dell'utente a causa di tentativi non riusciti di leggere o scrivere file. Questa API non è destinata all'uso come sostituzione o alternativa per la chiusura SMB.

Per ulteriori informazioni, vedere Forza handle di chiusura.

ForceCloseAllHandlesAsync(CancellationToken)

L'operazione ForceCloseAllHandlesAsync(CancellationToken) chiude tutti gli handle aperti in un file nel servizio.

Questa API deve essere usata insieme GetHandlesAsync(CancellationToken) a per forzare gli handle di chiusura che bloccano le operazioni. Questi handle possono essere stati smarriti o perso traccia da parte dei client SMB. L'API ha un impatto sul lato client sulla chiusura dell'handle, inclusi gli errori visibili dell'utente a causa di tentativi non riusciti di leggere o scrivere file. Questa API non è destinata all'uso come sostituzione o alternativa per la chiusura SMB.

Per ulteriori informazioni, vedere Forza handle di chiusura.

ForceCloseHandle(String, CancellationToken)

L'operazione ForceCloseHandle(String, CancellationToken) chiude un handle aperto in un file nel servizio. Supporta la chiusura di un singolo handle specificato da handleId.

Questa API deve essere usata insieme GetHandlesAsync(CancellationToken) a per forzare gli handle di chiusura che bloccano le operazioni. Questi handle possono essere stati smarriti o perso traccia da parte dei client SMB. L'API ha un impatto sul lato client sulla chiusura dell'handle, inclusi gli errori visibili dell'utente a causa di tentativi non riusciti di leggere o scrivere file. Questa API non è destinata all'uso come sostituzione o alternativa per la chiusura SMB.

Per ulteriori informazioni, vedere Forza handle di chiusura.

ForceCloseHandleAsync(String, CancellationToken)

L'operazione ForceCloseHandleAsync(String, CancellationToken) chiude un handle aperto in un file nel servizio. Supporta la chiusura di un singolo handle specificato da handleId.

Questa API deve essere usata insieme GetHandlesAsync(CancellationToken) a per forzare gli handle di chiusura che bloccano le operazioni. Questi handle possono essere stati smarriti o perso traccia da parte dei client SMB. L'API ha un impatto sul lato client sulla chiusura dell'handle, inclusi gli errori visibili dell'utente a causa di tentativi non riusciti di leggere o scrivere file. Questa API non è destinata all'uso come sostituzione o alternativa per la chiusura SMB.

Per ulteriori informazioni, vedere Forza handle di chiusura.

GenerateSasUri(ShareFileSasPermissions, DateTimeOffset)

Restituisce GenerateSasUri(ShareFileSasPermissions, DateTimeOffset) un oggetto Uri che genera un URI di firma di accesso condiviso del servizio file di condivisione in base alle proprietà e ai parametri client passati. La firma di accesso condiviso viene firmata dalla credenziale della chiave condivisa del client.

Per verificare se il client è in grado di firmare una firma sas del servizio, vedere CanGenerateSasUri.

Per ulteriori informazioni, vedere Creazione di una firma di accesso condiviso del servizio.

GenerateSasUri(ShareSasBuilder)

Restituisce GenerateSasUri(ShareSasBuilder) un oggetto Uri che genera un URI di firma di accesso condiviso del servizio file di condivisione in base alle proprietà e ai generatori client. La firma di accesso condiviso viene firmata dalla credenziale della chiave condivisa del client.

Per verificare se il client è in grado di firmare una firma sas del servizio, vedere CanGenerateSasUri.

Per ulteriori informazioni, vedere Creazione di una firma di accesso condiviso del servizio.

GetHandles(CancellationToken)

L'operazione GetHandles(CancellationToken) restituisce una sequenza asincrona degli handle aperti in una directory o in un file. L'enumerazione degli handle può eseguire più richieste al servizio durante il recupero di tutti i valori.

Per ulteriori informazioni, vedere Handle elenco.

GetHandlesAsync(CancellationToken)

L'operazione GetHandlesAsync(CancellationToken) restituisce una sequenza asincrona degli handle aperti in una directory o in un file. L'enumerazione degli handle può eseguire più richieste al servizio durante il recupero di tutti i valori.

Per ulteriori informazioni, vedere Handle elenco.

GetParentShareClientCore()

Creare un nuovo ShareClient oggetto che punta al contenitore padre di questo ShareFileClientoggetto. Il nuovo ShareClient usa la stessa pipeline dei criteri di richiesta di ShareFileClient.

GetParentShareDirectoryClientCore()

Creare un nuovo ShareDirectoryClient oggetto che punta al contenitore padre di questo ShareFileClient. Il nuovo ShareDirectoryClient usa la stessa pipeline dei criteri di richiesta di ShareFileClient.

GetProperties(ShareFileRequestConditions, CancellationToken)

L'operazione GetProperties(ShareFileRequestConditions, CancellationToken) restituisce tutti i metadati definiti dall'utente, le operazioni HTTP standard e le proprietà di sistema per il file. Non restituisce il contenuto del file.

Per ulteriori informazioni, vedere Ottiene le proprietà dei file.

GetPropertiesAsync(ShareFileRequestConditions, CancellationToken)

L'operazione GetPropertiesAsync(ShareFileRequestConditions, CancellationToken) restituisce tutti i metadati definiti dall'utente, le operazioni HTTP standard e le proprietà di sistema per il file. Non restituisce il contenuto del file.

Per ulteriori informazioni, vedere Ottiene le proprietà dei file.

GetRangeList(ShareFileGetRangeListOptions, CancellationToken)

Restituisce l'elenco di intervalli validi per un file.

Per ulteriori informazioni, vedere Intervalli di elenchi.

GetRangeListAsync(ShareFileGetRangeListOptions, CancellationToken)

Restituisce l'elenco di intervalli validi per un file.

Per ulteriori informazioni, vedere Intervalli di elenchi.

GetRangeListDiff(ShareFileGetRangeListDiffOptions, CancellationToken)

Restituisce l'elenco di intervalli modificati nel file dopo l'esecuzione di previousSnapshot.

Per ulteriori informazioni, vedere Intervalli di elenchi.

GetRangeListDiffAsync(ShareFileGetRangeListDiffOptions, CancellationToken)

Restituisce l'elenco di intervalli modificati nel file dopo l'esecuzione di previousSnapshot.

Per ulteriori informazioni, vedere Intervalli di elenchi.

OpenRead(ShareFileOpenReadOptions, CancellationToken)

Apre un flusso per la lettura dal file. Il flusso scaricherà solo il file durante la lettura del flusso.

OpenReadAsync(ShareFileOpenReadOptions, CancellationToken)

Apre un flusso per la lettura dal file. Il flusso scaricherà solo il file durante la lettura del flusso.

OpenWrite(Boolean, Int64, ShareFileOpenWriteOptions, CancellationToken)

Apre un flusso per la scrittura nel file.

OpenWriteAsync(Boolean, Int64, ShareFileOpenWriteOptions, CancellationToken)

Apre un flusso per la scrittura nel file.

Rename(String, ShareFileRenameOptions, CancellationToken)

Rinomina un file. Questa API non supporta la ridenominazione di un file da una condivisione a un'altra o tra gli account di archiviazione.

RenameAsync(String, ShareFileRenameOptions, CancellationToken)

Rinomina un file. Questa API non supporta la ridenominazione di un file da una condivisione a un'altra o tra gli account di archiviazione.

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

L'operazione SetHttpHeaders(Nullable<Int64>, ShareFileHttpHeaders, FileSmbProperties, String, ShareFileRequestConditions, CancellationToken) imposta proprietà di sistema sul file.

Per ulteriori informazioni, vedere Impostare proprietà file.

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

L'operazione SetHttpHeadersAsync(Nullable<Int64>, ShareFileHttpHeaders, FileSmbProperties, String, ShareFileRequestConditions, CancellationToken) imposta proprietà di sistema sul file.

Per ulteriori informazioni, vedere Impostare proprietà file.

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

L'operazione SetMetadata(IDictionary<String,String>, ShareFileRequestConditions, CancellationToken) imposta i metadati definiti dall'utente per il file specificato come una o più coppie nome-valore.

Per ulteriori informazioni, vedere Impostare i metadati del file.

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

L'operazione SetMetadataAsync(IDictionary<String,String>, ShareFileRequestConditions, CancellationToken) imposta i metadati definiti dall'utente per il file specificato come una o più coppie nome-valore.

Per ulteriori informazioni, vedere Impostare i metadati del file.

StartCopy(Uri, ShareFileCopyOptions, CancellationToken)

Copia un BLOB o un file in un file di destinazione all'interno dell'account di archiviazione.

Per ulteriori informazioni, vedere Copia file.

StartCopyAsync(Uri, ShareFileCopyOptions, CancellationToken)

Copia un BLOB o un file in un file di destinazione all'interno dell'account di archiviazione.

Per ulteriori informazioni, vedere Copia file.

Upload(Stream, ShareFileUploadOptions, CancellationToken)

L'operazione Upload(Stream, ShareFileUploadOptions, CancellationToken) scrive options.Stream.Stream in un file.

Per ulteriori informazioni, vedere Inserisci intervallo.

UploadAsync(Stream, ShareFileUploadOptions, CancellationToken)

L'operazione UploadAsync(Stream, ShareFileUploadOptions, CancellationToken) scrive options.Stream.Stream in un file.

Per ulteriori informazioni, vedere Inserisci intervallo.

UploadRange(HttpRange, Stream, ShareFileUploadRangeOptions, CancellationToken)

L'operazione 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) scrive content in un range oggetto di un file.

Per ulteriori informazioni, vedere Inserisci intervallo.

UploadRangeAsync(HttpRange, Stream, ShareFileUploadRangeOptions, CancellationToken)

L'operazione 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) scrive content in un range oggetto di un file.

Per ulteriori informazioni, vedere Inserisci intervallo.

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

L'operazione UploadRangeFromUri(Uri, HttpRange, HttpRange, ShareFileUploadRangeFromUriOptions, CancellationToken) scrive un intervallo da un file di Azure a un altro file di Azure. Questa API è supportata solo per la versione 2019-02-02 e successive.

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

L'operazione Azure.Storage.Files.Shares.ShareFileClient.UploadRangeFromUriAsync(System.Uri,Azure.HttpRange,Azure.HttpRange,Azure.Storage.Files.Shares.Models.ShareFileRequestConditions,System.Threading.CancellationToken) scrive un intervallo da un file di Azure a un altro file di Azure. Questa API è supportata solo per la versione 2019-02-02 e successive.

WithSnapshot(String)

Inizializza una nuova istanza della ShareFileClient classe con un'origine identica Uri ma il timestamp specificato shareSnapshot .

Per ulteriori informazioni, vedere Condivisione snapshot.

Metodi di estensione

GetShareLeaseClient(ShareFileClient, String)

Inizializza una nuova istanza della classe ShareLeaseClient.

GetParentShareClient(ShareFileClient)

Creare un nuovo ShareClient oggetto che punta al contenitore padre di questo ShareFileClient. Il nuovo ShareClient usa la stessa pipeline dei criteri di richiesta di ShareFileClient.

GetParentShareDirectoryClient(ShareFileClient)

Creare un nuovo ShareDirectoryClient oggetto che punta al contenitore padre di questo ShareFileClient. Il nuovo ShareDirectoryClient usa la stessa pipeline dei criteri di richiesta di ShareFileClient.

Si applica a