Delen via


DataLakeDirectoryClient.CreateFile Method

Definition

The CreateFile(String, DataLakePathCreateOptions, CancellationToken) operation creates a file in this directory. If the file already exists, it will be overwritten. If you don't intent to overwrite an existing file, consider using the CreateIfNotExistsAsync(DataLakePathCreateOptions, CancellationToken) API.

For more information, see https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create.

public virtual Azure.Response<Azure.Storage.Files.DataLake.DataLakeFileClient> CreateFile (string fileName, Azure.Storage.Files.DataLake.Models.DataLakePathCreateOptions options = default, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateFile : string * Azure.Storage.Files.DataLake.Models.DataLakePathCreateOptions * System.Threading.CancellationToken -> Azure.Response<Azure.Storage.Files.DataLake.DataLakeFileClient>
override this.CreateFile : string * Azure.Storage.Files.DataLake.Models.DataLakePathCreateOptions * System.Threading.CancellationToken -> Azure.Response<Azure.Storage.Files.DataLake.DataLakeFileClient>
Public Overridable Function CreateFile (fileName As String, Optional options As DataLakePathCreateOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Response(Of DataLakeFileClient)

Parameters

fileName
String

The name of the file to create.

options
DataLakePathCreateOptions

Optional parameters.

cancellationToken
CancellationToken

Optional CancellationToken to propagate notifications that the operation should be cancelled.

Returns

A Response<T> for the newly created file.

Remarks

A RequestFailedException will be thrown if a failure occurs.

Applies to