你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

ShareDirectoryClient.CreateFileAsync 方法

定义

创建新文件或替换现有文件。

有关详细信息,请参阅 创建文件

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Files.Shares.ShareFileClient>> CreateFileAsync (string fileName, long maxSize, Azure.Storage.Files.Shares.Models.ShareFileHttpHeaders httpHeaders = default, System.Collections.Generic.IDictionary<string,string> metadata = default, Azure.Storage.Files.Shares.Models.FileSmbProperties smbProperties = default, string filePermission = default, Azure.Storage.Files.Shares.Models.ShareFileRequestConditions conditions = default, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateFileAsync : string * int64 * Azure.Storage.Files.Shares.Models.ShareFileHttpHeaders * System.Collections.Generic.IDictionary<string, string> * Azure.Storage.Files.Shares.Models.FileSmbProperties * string * Azure.Storage.Files.Shares.Models.ShareFileRequestConditions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Files.Shares.ShareFileClient>>
override this.CreateFileAsync : string * int64 * Azure.Storage.Files.Shares.Models.ShareFileHttpHeaders * System.Collections.Generic.IDictionary<string, string> * Azure.Storage.Files.Shares.Models.FileSmbProperties * string * Azure.Storage.Files.Shares.Models.ShareFileRequestConditions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Storage.Files.Shares.ShareFileClient>>
Public Overridable Function CreateFileAsync (fileName As String, maxSize As Long, Optional httpHeaders As ShareFileHttpHeaders = Nothing, Optional metadata As IDictionary(Of String, String) = Nothing, Optional smbProperties As FileSmbProperties = Nothing, Optional filePermission As String = Nothing, Optional conditions As ShareFileRequestConditions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of ShareFileClient))

参数

fileName
String

文件的名称。

maxSize
Int64

必需。 指定文件的最大大小。

httpHeaders
ShareFileHttpHeaders

可为文件设置的可选标准 HTTP 标头属性。

metadata
IDictionary<String,String>

要为文件设置的可选自定义元数据。

smbProperties
FileSmbProperties

要为文件设置的可选 SMB 属性。

filePermission
String

要为文件设置的可选文件权限。

conditions
ShareFileRequestConditions

可选 ShareFileRequestConditions ,用于添加创建文件时的条件。

cancellationToken
CancellationToken

可选 CancellationToken ,用于传播应取消操作的通知。

返回

引用 Response<T> 文件的 。

注解

此方法仅初始化文件。 若要添加内容,请使用 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)

适用于