FileExtensionsCreateFileAsync(IFileSource, String, IFileType, IFileCategory, FuncCancellationToken, ValueTaskIFileContent, IUser, FuncIFileCreationToken, CancellationToken, ValueTask, FuncIFileVersionCreationToken, CancellationToken, ValueTask, CancellationToken) - метод
Создаёт файл с указанными параметрами и единственной версией.
Это вспомогательный метод, который нельзя переопределить.
Возвращает созданный файл или null, если создать файл не удалось.
Пространство имён: Tessa.FilesСборка: Tessa (в Tessa.dll) Версия: 3.6.0.22
public static ValueTask<(IFile file, ValidationResult result)> CreateFileAsync(
this IFileSource source,
string name,
IFileType type,
IFileCategory category,
Func<CancellationToken, ValueTask<IFileContent>> createContentFuncAsync,
IUser user = null,
Func<IFileCreationToken, CancellationToken, ValueTask> modifyFileTokenActionAsync = null,
Func<IFileVersionCreationToken, CancellationToken, ValueTask> modifyVersionTokenActionAsync = null,
CancellationToken cancellationToken = default
)
<ExtensionAttribute>
Public Shared Function CreateFileAsync (
source As IFileSource,
name As String,
type As IFileType,
category As IFileCategory,
createContentFuncAsync As Func(Of CancellationToken, ValueTask(Of IFileContent)),
Optional user As IUser = Nothing,
Optional modifyFileTokenActionAsync As Func(Of IFileCreationToken, CancellationToken, ValueTask) = Nothing,
Optional modifyVersionTokenActionAsync As Func(Of IFileVersionCreationToken, CancellationToken, ValueTask) = Nothing,
Optional cancellationToken As CancellationToken = Nothing
) As ValueTask(Of (file As IFile, result As ValidationResult))
public:
[ExtensionAttribute]
static ValueTask<ValueTuple<IFile^, ValidationResult^>> CreateFileAsync(
IFileSource^ source,
String^ name,
IFileType^ type,
IFileCategory^ category,
Func<CancellationToken, ValueTask<IFileContent^>>^ createContentFuncAsync,
IUser^ user = nullptr,
Func<IFileCreationToken^, CancellationToken, ValueTask>^ modifyFileTokenActionAsync = nullptr,
Func<IFileVersionCreationToken^, CancellationToken, ValueTask>^ modifyVersionTokenActionAsync = nullptr,
CancellationToken cancellationToken = CancellationToken()
)
[<ExtensionAttribute>]
static member CreateFileAsync :
source : IFileSource *
name : string *
type : IFileType *
category : IFileCategory *
createContentFuncAsync : Func<CancellationToken, ValueTask<IFileContent>> *
?user : IUser *
?modifyFileTokenActionAsync : Func<IFileCreationToken, CancellationToken, ValueTask> *
?modifyVersionTokenActionAsync : Func<IFileVersionCreationToken, CancellationToken, ValueTask> *
?cancellationToken : CancellationToken
(* Defaults:
let _user = defaultArg user null
let _modifyFileTokenActionAsync = defaultArg modifyFileTokenActionAsync null
let _modifyVersionTokenActionAsync = defaultArg modifyVersionTokenActionAsync null
let _cancellationToken = defaultArg cancellationToken new CancellationToken()
*)
-> ValueTask<ValueTuple<IFile, ValidationResult>>
- source IFileSource
- Источник создаваемого файла.
- name String
- Имя создаваемого файла.
- type IFileType
-
Тип создаваемого файла или null, если будет использовать тип по умолчанию при его наличии.
- category IFileCategory
-
Категория создаваемого файла или null, если файл создаётся без категории.
- createContentFuncAsync FuncCancellationToken, ValueTaskIFileContent
-
Функция, создающая контент файла, или null, если создаётся обычный контент в локальном кэше.
Если функция возвращает null, то контент также будет создан в локальном кэше.
Рекомендуется задавать функцию для создания контента, доступного удалённо и не сохраняемого в кэше.
- user IUser (Optional)
-
Пользователь, от имени которого создаётся файл,
или null, если используется текущий пользователь.
- modifyFileTokenActionAsync FuncIFileCreationToken, CancellationToken, ValueTask (Optional)
-
- modifyVersionTokenActionAsync FuncIFileVersionCreationToken, CancellationToken, ValueTask (Optional)
-
- cancellationToken CancellationToken (Optional)
- Объект, посредством которого можно отменить асинхронную задачу.
ValueTaskValueTupleIFile,
ValidationResultРезультат создания файла.В Visual Basic и C# этот метод можно вызывать как метод экземпляра для любого объекта типа
IFileSource. При вызове метода для экземпляра следует опускать первый параметр. Дополнительные сведения см. в разделе
Методы расширения (Visual Basic) или
Методы расширения (Руководство по программированию в C#).