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

ShareDirectoryClient.CreateFile 方法

定义

命名空间:

Azure.Storage.Files.Shares

程序集:

Azure.Storage.Files.Shares.dll

包:

Azure.Storage.Files.Shares v12.17.1

Source:

ShareDirectoryClient.cs

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

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

public virtual Azure.Response<Azure.Storage.Files.Shares.ShareFileClient> CreateFile (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 CreateFile : 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 -> Azure.Response<Azure.Storage.Files.Shares.ShareFileClient>
override this.CreateFile : 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 -> Azure.Response<Azure.Storage.Files.Shares.ShareFileClient>

Public Overridable Function CreateFile (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 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<ShareFileClient>

引用 Response<T> 文件的 。

注解

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