다음을 통해 공유


ShareFileClient 클래스

정의

ShareFileClient 사용하면 Azure Storage 파일을 조작할 수 있습니다.

public class ShareFileClient
type ShareFileClient = class
Public Class ShareFileClient
상속
ShareFileClient

생성자

ShareFileClient()

모의 클래스의 ShareFileClient 새 instance 초기화합니다.

ShareFileClient(String, String, String)

ShareFileClient 클래스의 새 인스턴스를 초기화합니다.

ShareFileClient(String, String, String, ShareClientOptions)

ShareFileClient 클래스의 새 인스턴스를 초기화합니다.

ShareFileClient(Uri, AzureSasCredential, ShareClientOptions)

ShareFileClient 클래스의 새 인스턴스를 초기화합니다.

ShareFileClient(Uri, ShareClientOptions)

ShareFileClient 클래스의 새 인스턴스를 초기화합니다.

ShareFileClient(Uri, StorageSharedKeyCredential, ShareClientOptions)

ShareFileClient 클래스의 새 인스턴스를 초기화합니다.

ShareFileClient(Uri, TokenCredential, ShareClientOptions)

ShareFileClient 클래스의 새 인스턴스를 초기화합니다.

ShareTokenIntent 현재 토큰 인증에 필요합니다.

속성

AccountName

파일 클라이언트에 해당하는 Storage 계정 이름을 가져옵니다.

CanGenerateSasUri

클라이언트가 SAS를 생성할 수 있는지 여부를 결정합니다. 클라이언트가 로 인증되는 StorageSharedKeyCredential경우

Name

파일 이름을 가져옵니다.

Path

파일의 경로를 가져옵니다.

ShareName

파일 클라이언트에 해당하는 공유 이름을 가져옵니다.

Uri

디렉터리의 기본 엔드포인트를 Uri 가져옵니다.

메서드

AbortCopy(String, ShareFileRequestConditions, CancellationToken)

이전에 시작된 보류 중인 복사본을 취소하려고 시도하고 길이가 0이고 전체 메타데이터가 있는 대상 파일을 남깁니다.

자세한 내용은 파일 복사를 중단합니다.

AbortCopyAsync(String, ShareFileRequestConditions, CancellationToken)

이전에 시작된 보류 중인 복사본을 취소하려고 시도하고 길이가 0이고 전체 메타데이터가 있는 대상 파일을 남깁니다.

자세한 내용은 파일 복사를 중단합니다.

ClearRange(HttpRange, ShareFileRequestConditions, CancellationToken)

작업은 ClearRange(HttpRange, ShareFileRequestConditions, CancellationToken) 파일의 를 range 지웁니다.

자세한 내용은 범위를 배치합니다.

ClearRangeAsync(HttpRange, ShareFileRequestConditions, CancellationToken)

작업은 ClearRangeAsync(HttpRange, ShareFileRequestConditions, CancellationToken) 파일의 를 range 지웁니다.

자세한 내용은 범위를 배치합니다.

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

새 파일을 만들거나 기존 파일을 대체합니다.

자세한 내용은 파일을 만듭니다.

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

새 파일을 만들거나 기존 파일을 대체합니다.

자세한 내용은 파일을 만듭니다.

Delete(ShareFileRequestConditions, CancellationToken)

Delete(ShareFileRequestConditions, CancellationToken) 작업은 저장소 계정에서 파일을 즉시 제거합니다.

자세한 내용은 파일을 삭제합니다.

DeleteAsync(ShareFileRequestConditions, CancellationToken)

DeleteAsync(ShareFileRequestConditions, CancellationToken) 작업은 저장소 계정에서 파일을 즉시 제거합니다.

자세한 내용은 파일을 삭제합니다.

DeleteIfExists(ShareFileRequestConditions, CancellationToken)

작업이 DeleteIfExists(ShareFileRequestConditions, CancellationToken) 있으면 스토리지 계정에서 파일을 즉시 제거합니다.

자세한 내용은 파일을 삭제합니다.

DeleteIfExistsAsync(ShareFileRequestConditions, CancellationToken)

작업이 DeleteIfExists(ShareFileRequestConditions, CancellationToken) 있으면 스토리지 계정에서 파일을 즉시 제거합니다.

자세한 내용은 파일을 삭제합니다.

Download(ShareFileDownloadOptions, CancellationToken)

Download(ShareFileDownloadOptions, CancellationToken) 작업은 메타데이터 및 속성을 포함해서 시스템으로부터 파일을 읽거나 다운로드합니다.

자세한 내용은 파일을 가져옵니다.

DownloadAsync(ShareFileDownloadOptions, CancellationToken)

DownloadAsync(ShareFileDownloadOptions, CancellationToken) 작업은 메타데이터 및 속성을 포함해서 시스템으로부터 파일을 읽거나 다운로드합니다.

자세한 내용은 파일을 가져옵니다.

Exists(CancellationToken)

Exists(CancellationToken) 대해 ShareFileClient 작업을 호출하여 연결된 파일이 스토리지 계정의 공유에 있는지 확인할 수 있습니다.

ExistsAsync(CancellationToken)

Exists(CancellationToken) 대해 ShareFileClient 작업을 호출하여 연결된 파일이 스토리지 계정의 공유에 있는지 확인할 수 있습니다.

ForceCloseAllHandles(CancellationToken)

작업은 ForceCloseAllHandles(CancellationToken) 서비스의 파일에서 열린 모든 핸들을 닫습니다.

이 API는 작업을 차단하는 닫기 핸들을 강제 적용하는 데 함께 GetHandlesAsync(CancellationToken) 사용됩니다. 이러한 핸들은 SMB 클라이언트에 의해 유출되거나 추적이 손실되었을 수 있습니다. API는 파일 읽기 또는 쓰기 시도 실패로 인한 사용자 표시 오류를 포함하여 닫히는 핸들에 클라이언트 쪽 영향을 줍니다. 이 API는 SMB 종가의 대체 또는 대안으로 사용하기 위한 것이 아닙니다.

자세한 내용은 닫기 핸들을 강제로 닫습니다.

ForceCloseAllHandlesAsync(CancellationToken)

작업은 ForceCloseAllHandlesAsync(CancellationToken) 서비스의 파일에서 열린 모든 핸들을 닫습니다.

이 API는 작업을 차단하는 닫기 핸들을 강제 적용하는 데 함께 GetHandlesAsync(CancellationToken) 사용됩니다. 이러한 핸들은 SMB 클라이언트에 의해 유출되거나 추적이 손실되었을 수 있습니다. API는 파일 읽기 또는 쓰기 시도 실패로 인한 사용자 표시 오류를 포함하여 닫히는 핸들에 클라이언트 쪽 영향을 줍니다. 이 API는 SMB 종가의 대체 또는 대안으로 사용하기 위한 것이 아닙니다.

자세한 내용은 닫기 핸들을 강제로 닫습니다.

ForceCloseHandle(String, CancellationToken)

작업은 ForceCloseHandle(String, CancellationToken) 서비스의 파일에서 열린 핸들을 닫습니다. 에서 지정 handleId한 단일 핸들을 닫을 수 있습니다.

이 API는 작업을 차단하는 닫기 핸들을 강제 적용하는 데 함께 GetHandlesAsync(CancellationToken) 사용됩니다. 이러한 핸들은 SMB 클라이언트에 의해 유출되거나 추적이 손실되었을 수 있습니다. API는 파일 읽기 또는 쓰기 시도 실패로 인한 사용자 표시 오류를 포함하여 닫히는 핸들에 클라이언트 쪽 영향을 줍니다. 이 API는 SMB 종가의 대체 또는 대안으로 사용하기 위한 것이 아닙니다.

자세한 내용은 닫기 핸들을 강제로 닫습니다.

ForceCloseHandleAsync(String, CancellationToken)

작업은 ForceCloseHandleAsync(String, CancellationToken) 서비스의 파일에서 열린 핸들을 닫습니다. 에서 지정 handleId한 단일 핸들을 닫을 수 있습니다.

이 API는 작업을 차단하는 닫기 핸들을 강제 적용하는 데 함께 GetHandlesAsync(CancellationToken) 사용됩니다. 이러한 핸들은 SMB 클라이언트에 의해 유출되거나 추적이 손실되었을 수 있습니다. API는 파일 읽기 또는 쓰기 시도 실패로 인한 사용자 표시 오류를 포함하여 닫히는 핸들에 클라이언트 쪽 영향을 줍니다. 이 API는 SMB 종가의 대체 또는 대안으로 사용하기 위한 것이 아닙니다.

자세한 내용은 닫기 핸들을 강제로 닫습니다.

GenerateSasUri(ShareFileSasPermissions, DateTimeOffset)

GenerateSasUri(ShareFileSasPermissions, DateTimeOffset) 전달된 클라이언트 속성 및 매개 변수를 기반으로 SAS(공유 파일 서비스 공유 액세스 서명) Uri를 생성하는 을 반환 Uri 합니다. SAS는 클라이언트의 공유 키 자격 증명으로 서명됩니다.

클라이언트가 서비스 Sas에 서명할 수 있는지 검사 보려면 를 참조하세요CanGenerateSasUri.

자세한 내용은 서비스 SAS를 생성합니다.

GenerateSasUri(ShareSasBuilder)

GenerateSasUri(ShareSasBuilder) 클라이언트 속성 및 작성기를 기반으로 SAS(공유 파일 서비스 공유 액세스 서명) Uri를 생성하는 을 반환 Uri 합니다. SAS는 클라이언트의 공유 키 자격 증명으로 서명됩니다.

클라이언트가 서비스 Sas에 서명할 수 있는지 검사 보려면 를 참조하세요CanGenerateSasUri.

자세한 내용은 서비스 SAS를 생성합니다.

GetHandles(CancellationToken)

작업은 GetHandles(CancellationToken) 디렉터리 또는 파일에서 열린 핸들의 비동기 시퀀스를 반환합니다. 핸들을 열거하면 모든 값을 가져오는 동안 서비스에 여러 요청을 할 수 있습니다.

자세한 내용은 목록 핸들.

GetHandlesAsync(CancellationToken)

작업은 GetHandlesAsync(CancellationToken) 디렉터리 또는 파일에서 열린 핸들의 비동기 시퀀스를 반환합니다. 핸들을 열거하면 모든 값을 가져오는 동안 서비스에 여러 요청을 할 수 있습니다.

자세한 내용은 목록 핸들.

GetParentShareClientCore()

ShareFileClient의 부모 컨테이너를 가리키는 새 ShareClient 를 만듭니다. 새 ShareClient 는 와 동일한 요청 정책 파이프라인을 ShareFileClient사용합니다.

GetParentShareDirectoryClientCore()

ShareFileClient의 부모 컨테이너를 가리키는 새 ShareDirectoryClient 를 만듭니다. 새 ShareDirectoryClient 는 와 동일한 요청 정책 파이프라인을 ShareFileClient사용합니다.

GetProperties(ShareFileRequestConditions, CancellationToken)

GetProperties(ShareFileRequestConditions, CancellationToken) 작업은 파일에 대한 모든 사용자 정의 메타데이터, 표준 HTTP 속성 및 시스템 속성을 반환합니다. 파일의 콘텐츠는 반환하지 않습니다.

자세한 내용은 파일 속성을 가져옵니다.

GetPropertiesAsync(ShareFileRequestConditions, CancellationToken)

GetPropertiesAsync(ShareFileRequestConditions, CancellationToken) 작업은 파일에 대한 모든 사용자 정의 메타데이터, 표준 HTTP 속성 및 시스템 속성을 반환합니다. 파일의 콘텐츠는 반환하지 않습니다.

자세한 내용은 파일 속성을 가져옵니다.

GetRangeList(ShareFileGetRangeListOptions, CancellationToken)

파일의 유효한 범위 목록을 반환합니다.

자세한 내용은 범위 나열.

GetRangeListAsync(ShareFileGetRangeListOptions, CancellationToken)

파일의 유효한 범위 목록을 반환합니다.

자세한 내용은 범위 나열.

GetRangeListDiff(ShareFileGetRangeListDiffOptions, CancellationToken)

previousSnapshot이 수행된 이후 파일에서 변경된 범위 목록을 반환합니다.

자세한 내용은 범위 나열.

GetRangeListDiffAsync(ShareFileGetRangeListDiffOptions, CancellationToken)

previousSnapshot이 수행된 이후 파일에서 변경된 범위 목록을 반환합니다.

자세한 내용은 범위 나열.

OpenRead(ShareFileOpenReadOptions, CancellationToken)

파일에서 읽기 위한 스트림을 엽니다. 스트림은 스트림을 읽을 때만 파일을 다운로드합니다.

OpenReadAsync(ShareFileOpenReadOptions, CancellationToken)

파일에서 읽기 위한 스트림을 엽니다. 스트림은 스트림을 읽을 때만 파일을 다운로드합니다.

OpenWrite(Boolean, Int64, ShareFileOpenWriteOptions, CancellationToken)

파일에 쓰기 위한 스트림을 엽니다.

OpenWriteAsync(Boolean, Int64, ShareFileOpenWriteOptions, CancellationToken)

파일에 쓰기 위한 스트림을 엽니다.

Rename(String, ShareFileRenameOptions, CancellationToken)

파일 이름을 바꿉니다. 이 API는 한 공유에서 다른 공유로 또는 스토리지 계정 간에 파일 이름을 바꾸는 것을 지원하지 않습니다.

RenameAsync(String, ShareFileRenameOptions, CancellationToken)

파일 이름을 바꿉니다. 이 API는 한 공유에서 다른 공유로 또는 스토리지 계정 간에 파일 이름을 바꾸는 것을 지원하지 않습니다.

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

SetHttpHeaders(Nullable<Int64>, ShareFileHttpHeaders, FileSmbProperties, String, ShareFileRequestConditions, CancellationToken) 작업은 파일에 대한 시스템 속성을 설정합니다.

자세한 내용은 파일 속성을 설정합니다.

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

SetHttpHeadersAsync(Nullable<Int64>, ShareFileHttpHeaders, FileSmbProperties, String, ShareFileRequestConditions, CancellationToken) 작업은 파일에 대한 시스템 속성을 설정합니다.

자세한 내용은 파일 속성을 설정합니다.

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

작업은 SetMetadata(IDictionary<String,String>, ShareFileRequestConditions, CancellationToken) 지정된 파일에 대한 사용자 정의 메타데이터를 하나 이상의 이름-값 쌍으로 설정합니다.

자세한 내용은 파일 메타데이터를 설정합니다.

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

작업은 SetMetadataAsync(IDictionary<String,String>, ShareFileRequestConditions, CancellationToken) 지정된 파일에 대한 사용자 정의 메타데이터를 하나 이상의 이름-값 쌍으로 설정합니다.

자세한 내용은 파일 메타데이터를 설정합니다.

StartCopy(Uri, ShareFileCopyOptions, CancellationToken)

Blob 또는 파일을 스토리지 계정 내의 대상 파일에 복사합니다.

자세한 내용은 파일을 복사합니다.

StartCopyAsync(Uri, ShareFileCopyOptions, CancellationToken)

Blob 또는 파일을 스토리지 계정 내의 대상 파일에 복사합니다.

자세한 내용은 파일을 복사합니다.

Upload(Stream, ShareFileUploadOptions, CancellationToken)

작업은 Upload(Stream, ShareFileUploadOptions, CancellationToken) 파일에 씁니다 options.Stream.Stream .

자세한 내용은 범위를 배치합니다.

UploadAsync(Stream, ShareFileUploadOptions, CancellationToken)

작업은 UploadAsync(Stream, ShareFileUploadOptions, CancellationToken) 파일에 씁니다 options.Stream.Stream .

자세한 내용은 범위를 배치합니다.

UploadRange(HttpRange, Stream, ShareFileUploadRangeOptions, CancellationToken)

작업은 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) 파일의 에 range 씁니다content.

자세한 내용은 범위를 배치합니다.

UploadRangeAsync(HttpRange, Stream, ShareFileUploadRangeOptions, CancellationToken)

작업은 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) 파일의 에 range 씁니다content.

자세한 내용은 범위를 배치합니다.

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

작업은 UploadRangeFromUri(Uri, HttpRange, HttpRange, ShareFileUploadRangeFromUriOptions, CancellationToken) Azure 파일에서 다른 Azure 파일로 범위를 씁니다. 이 API는 버전 2019-02-02 이상에서만 지원됩니다.

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

작업은 Azure.Storage.Files.Shares.ShareFileClient.UploadRangeFromUriAsync(System.Uri,Azure.HttpRange,Azure.HttpRange,Azure.Storage.Files.Shares.Models.ShareFileRequestConditions,System.Threading.CancellationToken) Azure 파일에서 다른 Azure 파일로 범위를 씁니다. 이 API는 버전 2019-02-02 이상에서만 지원됩니다.

WithSnapshot(String)

소스가 동일 Uri 하지만 지정된 shareSnapshot 타임스탬프를 사용하여 클래스의 ShareFileClient 새 instance 초기화합니다.

자세한 내용은 스냅샷 공유.

확장 메서드

GetShareLeaseClient(ShareFileClient, String)

ShareLeaseClient 클래스의 새 인스턴스를 초기화합니다.

GetParentShareClient(ShareFileClient)

ShareFileClient의 부모 컨테이너를 가리키는 새 ShareClient 를 만듭니다. 새 ShareClient 는 와 동일한 요청 정책 파이프라인을 ShareFileClient사용합니다.

GetParentShareDirectoryClient(ShareFileClient)

ShareFileClient의 부모 컨테이너를 가리키는 새 ShareDirectoryClient 를 만듭니다. 새 ShareDirectoryClient 는 와 동일한 요청 정책 파이프라인을 ShareFileClient사용합니다.

적용 대상