ShareFileClient Sınıf

Başvuru

Tanım

Ad Alanı:: Azure.Storage.Files.Shares

Bütünleştirilmiş Kod:: Azure.Storage.Files.Shares.dll

Paket:: Azure.Storage.Files.Shares v12.16.0

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

, ShareFileClient Azure Depolama dosyalarını işlemenizi sağlar.

public class ShareFileClient

type ShareFileClient = class

Public Class ShareFileClient

Devralma: Object
ShareFileClient

Oluşturucular

ShareFileClient()	Sahte işlem için sınıfının yeni bir örneğini ShareFileClient başlatır.
ShareFileClient(String, String, String)	ShareFileClient sınıfının yeni bir örneğini başlatır.
ShareFileClient(String, String, String, ShareClientOptions)	ShareFileClient sınıfının yeni bir örneğini başlatır.
ShareFileClient(Uri, AzureSasCredential, ShareClientOptions)	ShareFileClient sınıfının yeni bir örneğini başlatır.
ShareFileClient(Uri, ShareClientOptions)	ShareFileClient sınıfının yeni bir örneğini başlatır.
ShareFileClient(Uri, StorageSharedKeyCredential, ShareClientOptions)	ShareFileClient sınıfının yeni bir örneğini başlatır.
ShareFileClient(Uri, TokenCredential, ShareClientOptions)	ShareFileClient sınıfının yeni bir örneğini başlatır. Şu anda belirteç kimlik doğrulaması için gerekli olduğunu ShareTokenIntent unutmayın.

Özellikler

AccountName	Dosya istemcisine karşılık gelen Depolama hesabı adını alır.
CanGenerateSasUri	İstemcinin sas oluşturup oluşturamayacağını belirler. İstemcinin kimliği bir StorageSharedKeyCredentialile doğrulanmışsa.
Name	Dosyanın adını alır.
Path	Dosyanın yolunu alır.
ShareName	Dosya istemcisine karşılık gelen paylaşım adını alır.
Uri	Dizinin birincil Uri uç noktasını alır.

Yöntemler

AbortCopy(String, ShareFileRequestConditions, CancellationToken)	Daha önce başlatılan ve hedef dosyayı sıfır uzunlukta ve tam meta verilerle bırakan bekleyen bir kopyayı iptal etmeye çalışır. Daha fazla bilgi için bkz. Dosyayı Kopyalamayı Durdur.
AbortCopyAsync(String, ShareFileRequestConditions, CancellationToken)	Daha önce başlatılan ve hedef dosyayı sıfır uzunlukta ve tam meta verilerle bırakan bekleyen bir kopyayı iptal etmeye çalışır. Daha fazla bilgi için bkz. Dosyayı Kopyalamayı Durdur.
ClearRange(HttpRange, ShareFileRequestConditions, CancellationToken)	İşlem bir ClearRange(HttpRange, ShareFileRequestConditions, CancellationToken) dosyanın işaretini `range` temizler. Daha fazla bilgi için bkz. Range'i koy.
ClearRangeAsync(HttpRange, ShareFileRequestConditions, CancellationToken)	İşlem bir ClearRangeAsync(HttpRange, ShareFileRequestConditions, CancellationToken) dosyanın işaretini `range` temizler. Daha fazla bilgi için bkz. Range'i koy.
Create(Int64, ShareFileHttpHeaders, IDictionary<String,String>, FileSmbProperties, String, ShareFileRequestConditions, CancellationToken)	Yeni bir dosya oluşturur veya var olan bir dosyanın yerini alır. Daha fazla bilgi için bkz. Dosya Oluştur'u seçin.
CreateAsync(Int64, ShareFileHttpHeaders, IDictionary<String,String>, FileSmbProperties, String, ShareFileRequestConditions, CancellationToken)	Yeni bir dosya oluşturur veya var olan bir dosyanın yerini alır. Daha fazla bilgi için bkz. Dosya Oluştur'u seçin.
Delete(ShareFileRequestConditions, CancellationToken)	İşlem, Delete(ShareFileRequestConditions, CancellationToken) dosyayı depolama hesabından hemen kaldırır. Daha fazla bilgi için bkz. Dosyayı Sil'i seçin.
DeleteAsync(ShareFileRequestConditions, CancellationToken)	İşlem, DeleteAsync(ShareFileRequestConditions, CancellationToken) dosyayı depolama hesabından hemen kaldırır. Daha fazla bilgi için bkz. Dosyayı Sil'i seçin.
DeleteIfExists(ShareFileRequestConditions, CancellationToken)	İşlem DeleteIfExists(ShareFileRequestConditions, CancellationToken) , varsa dosyayı depolama hesabından hemen kaldırır. Daha fazla bilgi için bkz. Dosyayı Sil'i seçin.
DeleteIfExistsAsync(ShareFileRequestConditions, CancellationToken)	İşlem DeleteIfExists(ShareFileRequestConditions, CancellationToken) , varsa dosyayı depolama hesabından hemen kaldırır. Daha fazla bilgi için bkz. Dosyayı Sil'i seçin.
Download(ShareFileDownloadOptions, CancellationToken)	İşlem, Download(ShareFileDownloadOptions, CancellationToken) meta verileri ve özellikleri de dahil olmak üzere sistemden bir dosyayı okur veya indirir. Daha fazla bilgi için bkz. Dosya Al'ı seçin.
DownloadAsync(ShareFileDownloadOptions, CancellationToken)	İşlem, DownloadAsync(ShareFileDownloadOptions, CancellationToken) meta verileri ve özellikleri de dahil olmak üzere sistemden bir dosyayı okur veya indirir. Daha fazla bilgi için bkz. Dosya Al'ı seçin.
Exists(CancellationToken)	İlişkili Exists(CancellationToken) dosyanın depolama hesabındaki ShareFileClient paylaşımda mevcut olup olmadığını görmek için işlem üzerinde çağrılabilir.
ExistsAsync(CancellationToken)	İlişkili Exists(CancellationToken) dosyanın depolama hesabındaki ShareFileClient paylaşımda mevcut olup olmadığını görmek için işlem üzerinde çağrılabilir.
ForceCloseAllHandles(CancellationToken)	İşlem, ForceCloseAllHandles(CancellationToken) hizmette bir dosyada açılan tüm tanıtıcıları kapatır. Bu API' nin, işlemleri engelleyen tanıtıcıları kapatmaya zorlamak için birlikte GetHandlesAsync(CancellationToken) kullanılması amaçlanmıştır. Bu tanıtıcılar SMB istemcileri tarafından sızdırılmış veya izlenmiş olabilir. API' nin kapatılan tanıtıcı üzerinde istemci tarafı etkisi vardır ve dosya okuma veya yazma girişimlerinin başarısız olması nedeniyle kullanıcı görünür hataları da buna dahildir. Bu API, SMB kapatma işlemi yerine veya alternatif olarak kullanılmak üzere tasarlanmamıştır. Daha fazla bilgi için bkz. Tutamaçları Kapatmaya Zorla.
ForceCloseAllHandlesAsync(CancellationToken)	İşlem, ForceCloseAllHandlesAsync(CancellationToken) hizmette bir dosyada açılan tüm tanıtıcıları kapatır. Bu API' nin, işlemleri engelleyen tanıtıcıları kapatmaya zorlamak için birlikte GetHandlesAsync(CancellationToken) kullanılması amaçlanmıştır. Bu tanıtıcılar SMB istemcileri tarafından sızdırılmış veya izlenmiş olabilir. API' nin kapatılan tanıtıcı üzerinde istemci tarafı etkisi vardır ve dosya okuma veya yazma girişimlerinin başarısız olması nedeniyle kullanıcı görünür hataları da buna dahildir. Bu API, SMB kapatma işlemi yerine veya alternatif olarak kullanılmak üzere tasarlanmamıştır. Daha fazla bilgi için bkz. Tutamaçları Kapatmaya Zorla.
ForceCloseHandle(String, CancellationToken)	İşlem, ForceCloseHandle(String, CancellationToken) hizmette bir dosyada açılan tanıtıcıyı kapatır. tarafından `handleId`belirtilen tek bir tanıtıcının kapatılmasını destekler. Bu API' nin, işlemleri engelleyen tanıtıcıları kapatmaya zorlamak için birlikte GetHandlesAsync(CancellationToken) kullanılması amaçlanmıştır. Bu tanıtıcılar SMB istemcileri tarafından sızdırılmış veya izlenmiş olabilir. API' nin kapatılan tanıtıcı üzerinde istemci tarafı etkisi vardır ve dosya okuma veya yazma girişimlerinin başarısız olması nedeniyle kullanıcı görünür hataları da buna dahildir. Bu API, SMB kapatma işlemi yerine veya alternatif olarak kullanılmak üzere tasarlanmamıştır. Daha fazla bilgi için bkz. Tutamaçları Kapatmaya Zorla.
ForceCloseHandleAsync(String, CancellationToken)	İşlem, ForceCloseHandleAsync(String, CancellationToken) hizmette bir dosyada açılan tanıtıcıyı kapatır. tarafından `handleId`belirtilen tek bir tanıtıcının kapatılmasını destekler. Bu API' nin, işlemleri engelleyen tanıtıcıları kapatmaya zorlamak için birlikte GetHandlesAsync(CancellationToken) kullanılması amaçlanmıştır. Bu tanıtıcılar SMB istemcileri tarafından sızdırılmış veya izlenmiş olabilir. API' nin kapatılan tanıtıcı üzerinde istemci tarafı etkisi vardır ve dosya okuma veya yazma girişimlerinin başarısız olması nedeniyle kullanıcı görünür hataları da buna dahildir. Bu API, SMB kapatma işlemi yerine veya alternatif olarak kullanılmak üzere tasarlanmamıştır. Daha fazla bilgi için bkz. Tutamaçları Kapatmaya Zorla.
GenerateSasUri(ShareFileSasPermissions, DateTimeOffset)	, GenerateSasUri(ShareFileSasPermissions, DateTimeOffset) geçirilen İstemci özelliklerine ve parametrelerine göre Bir Paylaşım Dosya Hizmeti Paylaşılan Erişim İmzası (SAS) Uri'sini oluşturan bir Uri döndürür. SAS, istemcinin paylaşılan anahtar kimlik bilgileriyle imzalanır. İstemcinin bir Hizmet Sas'i imzalayıp imzalayamadığını denetlemek için bkz CanGenerateSasUri. . Daha fazla bilgi için bkz. Hizmet SAS'si oluşturma.
GenerateSasUri(ShareSasBuilder)	, GenerateSasUri(ShareSasBuilder) İstemci özelliklerine ve oluşturucuya göre Bir Paylaşım Dosya Hizmeti Paylaşılan Erişim İmzası (SAS) Uri'sini oluşturan bir Uri döndürür. SAS, istemcinin paylaşılan anahtar kimlik bilgileriyle imzalanır. İstemcinin bir Hizmet Sas'i imzalayıp imzalayamadığını denetlemek için bkz CanGenerateSasUri. . Daha fazla bilgi için bkz. Hizmet SAS'si oluşturma.
GetHandles(CancellationToken)	İşlem, GetHandles(CancellationToken) bir dizin veya dosyadaki açık tanıtıcıların zaman uyumsuz dizisini döndürür. Tanıtıcıların numaralandırılması, tüm değerleri getirirken hizmete birden çok istekte bulunabilir. Daha fazla bilgi için bkz. Liste Tanıtıcıları.
GetHandlesAsync(CancellationToken)	İşlem, GetHandlesAsync(CancellationToken) bir dizin veya dosyadaki açık tanıtıcıların zaman uyumsuz dizisini döndürür. Tanıtıcıların numaralandırılması, tüm değerleri getirirken hizmete birden çok istekte bulunabilir. Daha fazla bilgi için bkz. Liste Tanıtıcıları.
GetParentShareClientCore()	Bu ShareFileClient'nin üst kapsayıcısına işaret eden yeni ShareClient bir oluşturun. Yeni ShareClient , ile aynı istek ilkesi işlem hattını ShareFileClientkullanır.
GetParentShareDirectoryClientCore()	Bu ShareFileClient'nin üst kapsayıcısına işaret eden yeni ShareDirectoryClient bir oluşturun. Yeni ShareDirectoryClient , ile aynı istek ilkesi işlem hattını ShareFileClientkullanır.
GetProperties(ShareFileRequestConditions, CancellationToken)	İşlem, GetProperties(ShareFileRequestConditions, CancellationToken) dosya için tüm kullanıcı tanımlı meta verileri, standart HTTP özelliklerini ve sistem özelliklerini döndürür. Dosyanın içeriğini döndürmez. Daha fazla bilgi için bkz. Dosya Özelliklerini Alma.
GetPropertiesAsync(ShareFileRequestConditions, CancellationToken)	İşlem, GetPropertiesAsync(ShareFileRequestConditions, CancellationToken) dosya için tüm kullanıcı tanımlı meta verileri, standart HTTP özelliklerini ve sistem özelliklerini döndürür. Dosyanın içeriğini döndürmez. Daha fazla bilgi için bkz. Dosya Özelliklerini Alma.
GetRangeList(ShareFileGetRangeListOptions, CancellationToken)	Bir dosya için geçerli aralıkların listesini döndürür. Daha fazla bilgi için bkz. Liste Aralıkları.
GetRangeListAsync(ShareFileGetRangeListOptions, CancellationToken)	Bir dosya için geçerli aralıkların listesini döndürür. Daha fazla bilgi için bkz. Liste Aralıkları.
GetRangeListDiff(ShareFileGetRangeListDiffOptions, CancellationToken)	ÖncekiSnapshot alındıktan sonra dosyada değiştirilen aralıkların listesini döndürür. Daha fazla bilgi için bkz. Liste Aralıkları.
GetRangeListDiffAsync(ShareFileGetRangeListDiffOptions, CancellationToken)	ÖncekiSnapshot alındıktan sonra dosyada değiştirilen aralıkların listesini döndürür. Daha fazla bilgi için bkz. Liste Aralıkları.
OpenRead(ShareFileOpenReadOptions, CancellationToken)	Dosyadan okumak için bir akış açar. Akış yalnızca akış okundukça dosyayı indirir.
OpenReadAsync(ShareFileOpenReadOptions, CancellationToken)	Dosyadan okumak için bir akış açar. Akış yalnızca akış okundukça dosyayı indirir.
OpenWrite(Boolean, Int64, ShareFileOpenWriteOptions, CancellationToken)	Dosyaya yazmak için bir akış açar.
OpenWriteAsync(Boolean, Int64, ShareFileOpenWriteOptions, CancellationToken)	Dosyaya yazmak için bir akış açar.
Rename(String, ShareFileRenameOptions, CancellationToken)	Dosyayı yeniden adlandırır. Bu API, bir dosyayı bir paylaşımdan diğerine veya depolama hesapları arasında yeniden adlandırmayı desteklemez.
RenameAsync(String, ShareFileRenameOptions, CancellationToken)	Dosyayı yeniden adlandırır. Bu API, bir dosyayı bir paylaşımdan diğerine veya depolama hesapları arasında yeniden adlandırmayı desteklemez.
SetHttpHeaders(Nullable<Int64>, ShareFileHttpHeaders, FileSmbProperties, String, ShareFileRequestConditions, CancellationToken)	İşlem, SetHttpHeaders(Nullable<Int64>, ShareFileHttpHeaders, FileSmbProperties, String, ShareFileRequestConditions, CancellationToken) dosyadaki sistem özelliklerini ayarlar. Daha fazla bilgi için bkz. Dosya Özellikleri'ni ayarlayın.
SetHttpHeadersAsync(Nullable<Int64>, ShareFileHttpHeaders, FileSmbProperties, String, ShareFileRequestConditions, CancellationToken)	İşlem, SetHttpHeadersAsync(Nullable<Int64>, ShareFileHttpHeaders, FileSmbProperties, String, ShareFileRequestConditions, CancellationToken) dosyadaki sistem özelliklerini ayarlar. Daha fazla bilgi için bkz. Dosya Özellikleri'ni ayarlayın.
SetMetadata(IDictionary<String,String>, ShareFileRequestConditions, CancellationToken)	İşlem, SetMetadata(IDictionary<String,String>, ShareFileRequestConditions, CancellationToken) belirtilen dosya için kullanıcı tanımlı meta verileri bir veya daha fazla ad-değer çifti olarak ayarlar. Daha fazla bilgi için bkz. Dosya Meta Verilerini Ayarla'yı seçin.
SetMetadataAsync(IDictionary<String,String>, ShareFileRequestConditions, CancellationToken)	İşlem, SetMetadataAsync(IDictionary<String,String>, ShareFileRequestConditions, CancellationToken) belirtilen dosya için kullanıcı tanımlı meta verileri bir veya daha fazla ad-değer çifti olarak ayarlar. Daha fazla bilgi için bkz. Dosya Meta Verilerini Ayarla'yı seçin.
StartCopy(Uri, ShareFileCopyOptions, CancellationToken)	Blobu veya dosyayı depolama hesabındaki bir hedef dosyaya kopyalar. Daha fazla bilgi için bkz. Dosyayı Kopyala'yı seçin.
StartCopyAsync(Uri, ShareFileCopyOptions, CancellationToken)	Blobu veya dosyayı depolama hesabındaki bir hedef dosyaya kopyalar. Daha fazla bilgi için bkz. Dosyayı Kopyala'yı seçin.
Upload(Stream, ShareFileUploadOptions, CancellationToken)	İşlem Upload(Stream, ShareFileUploadOptions, CancellationToken) bir dosyaya yazar `options.Stream.Stream` . Daha fazla bilgi için bkz. Aralığı koy.
UploadAsync(Stream, ShareFileUploadOptions, CancellationToken)	İşlem UploadAsync(Stream, ShareFileUploadOptions, CancellationToken) bir dosyaya yazar `options.Stream.Stream` . Daha fazla bilgi için bkz. Aralığı koy.
UploadRange(HttpRange, Stream, ShareFileUploadRangeOptions, CancellationToken)	İşlem 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) bir `range` dosyaya yazar`content`. Daha fazla bilgi için bkz. Aralığı koy.
UploadRangeAsync(HttpRange, Stream, ShareFileUploadRangeOptions, CancellationToken)	İşlem 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) bir `range` dosyaya yazar`content`. Daha fazla bilgi için bkz. Aralığı koy.
UploadRangeFromUri(Uri, HttpRange, HttpRange, ShareFileUploadRangeFromUriOptions, CancellationToken)	İşlem, UploadRangeFromUri(Uri, HttpRange, HttpRange, ShareFileUploadRangeFromUriOptions, CancellationToken) bir Azure Dosyasından başka bir Azure dosyasına bir aralık yazar. Bu API yalnızca sürüm 2019-02-02 ve üzeri için desteklenir.
UploadRangeFromUriAsync(Uri, HttpRange, HttpRange, ShareFileUploadRangeFromUriOptions, CancellationToken)	İşlem, Azure.Storage.Files.Shares.ShareFileClient.UploadRangeFromUriAsync(System.Uri,Azure.HttpRange,Azure.HttpRange,Azure.Storage.Files.Shares.Models.ShareFileRequestConditions,System.Threading.CancellationToken) bir Azure Dosyasından başka bir Azure dosyasına bir aralık yazar. Bu API yalnızca sürüm 2019-02-02 ve üzeri için desteklenir.
WithSnapshot(String)	Aynı Uri kaynağa ancak belirtilen `shareSnapshot` zaman damgasına ShareFileClient sahip sınıfın yeni bir örneğini başlatır. Daha fazla bilgi için bkz. Anlık Görüntü Paylaşımı.

Uzantı Metotları

GetShareLeaseClient(ShareFileClient, String)	ShareLeaseClient sınıfının yeni bir örneğini başlatır.
GetParentShareClient(ShareFileClient)	Bu ShareFileClient'nin üst kapsayıcısına işaret eden yeni ShareClient bir oluşturun. Yeni ShareClient , ile aynı istek ilkesi işlem hattını ShareFileClientkullanır.
GetParentShareDirectoryClient(ShareFileClient)	Bu ShareFileClient'nin üst kapsayıcısına işaret eden yeni ShareDirectoryClient bir oluşturun. Yeni ShareDirectoryClient , ile aynı istek ilkesi işlem hattını ShareFileClientkullanır.

Şunlara uygulanır