ShareFileClient.Create Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Creates a new file or replaces an existing file.
For more information, see Create File.
public virtual Azure.Response<Azure.Storage.Files.Shares.Models.ShareFileInfo> Create (long maxSize, Azure.Storage.Files.Shares.Models.ShareFileCreateOptions options = default, Azure.Storage.Files.Shares.Models.ShareFileRequestConditions conditions = default, System.Threading.CancellationToken cancellationToken = default);
abstract member Create : int64 * Azure.Storage.Files.Shares.Models.ShareFileCreateOptions * Azure.Storage.Files.Shares.Models.ShareFileRequestConditions * System.Threading.CancellationToken -> Azure.Response<Azure.Storage.Files.Shares.Models.ShareFileInfo>
override this.Create : int64 * Azure.Storage.Files.Shares.Models.ShareFileCreateOptions * Azure.Storage.Files.Shares.Models.ShareFileRequestConditions * System.Threading.CancellationToken -> Azure.Response<Azure.Storage.Files.Shares.Models.ShareFileInfo>
Public Overridable Function Create (maxSize As Long, Optional options As ShareFileCreateOptions = Nothing, Optional conditions As ShareFileRequestConditions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Response(Of ShareFileInfo)
Parameters
- maxSize
- Int64
Required. Specifies the maximum size for the file in bytes. The max supported file size is 4 TiB.
- options
- ShareFileCreateOptions
Optional parameters.
- conditions
- ShareFileRequestConditions
Optional ShareFileRequestConditions to add conditions on creating the file.
- cancellationToken
- CancellationToken
Optional CancellationToken to propagate notifications that the operation should be cancelled.
Returns
A Response<T> describing the state of the file.
Remarks
This method only initializes the file. To add content, use 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).