UploadAsyncSettingsBuilder

Methods

AutoUpload(System.Boolean)

Sets a value indicating whether to start the upload immediately after selecting a file

Parameters

value - System.Boolean

true if the upload should start immediately after selecting a file, false otherwise; true by default

Example

            @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                            .Save("Save", "Home")
                            .AutoUpload(false)
                        )
            )

Batch(System.Boolean)

Sets a value indicating whether to upload selected files in one batch (request)

Parameters

value - System.Boolean

true if the files should be uploaded in a single request, false otherwise; false by default

Example

            @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                            .Save("Save", "Home")
                            .Batch(true)
                        )
            )

ChunkSize(System.Double)

When the property is set the selected files will be uploaded chunk by chunk with the declared size. Each request sends a separate file blob and additional string metadata to the server. This metadata is a stringified JSON and contains chunkIndex, contentType, totalFileSize, totalChunks, uploadUid properties that allow validating and combining the file on the server side. The response also returns a JSON object with uploaded and fileUid properties that notifies the client which should be the next chunk.

Parameters

value - System.Double

The value for ChunkSize

Example

            @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                           .Save("Chunk_Upload_Save", "Home")
                           .Remove("Chunk_Upload_Remove", "Home")
                           .ChunkSize(11000)
                        )
            )

Concurrent(System.Boolean)

By default the selected files are uploaded one after another. When set to 'true' all the selected files start uploading simultaneously. (The property is available when the async.chunkSize is set.)

Parameters

value - System.Boolean

The value for Concurrent

Example

            @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                           .Save("Chunk_Upload_Save", "Home")
                           .ChunkSize(11000)
                           .Concurrent(true)
                        )
            )

Concurrent()

By default the selected files are uploaded one after another. When set to 'true' all the selected files start uploading simultaneously. (The property is available when the async.chunkSize is set.)

Example

            @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                           .Save("Chunk_Upload_Save", "Home")
                           .ChunkSize(11000)
                           .Concurrent(true)
                        )
            )

MaxAutoRetries(System.Double)

It sets the number of attempts that will be performed if an upload is failing. The property is only used when the async.autoRetryAfter property is also defined.

Parameters

value - System.Double

The value for MaxAutoRetries

Example

            @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                           .Save("Save", "Home")
                           .AutoRetryAfter(300)
                           .MaxAutoRetries(4)
                        )
            )

AutoRetryAfter(System.Double)

If the property is set the failed upload request will be repeated after the declared amount of ticks.

Parameters

value - System.Double

The value for AutoRetryAfter

Example

            @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                           .Save("Save", "Home")
                           .AutoRetryAfter(300)
                        )
            )

Save(System.String,System.String,System.Web.Routing.RouteValueDictionary)

Sets the action, controller and route values for the save operation

Parameters

actionName - System.String

Name of the action.

controllerName - System.String

Name of the controller.

routeValues - System.Web.Routing.RouteValueDictionary

The route values.

Example

             @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                            .Save("Save", "Home", new RouteValueDictionary{ {"id", 1} })
                        )
            )

Save(System.String,System.String,System.Object)

Sets the action, controller and route values for the save operation

Parameters

actionName - System.String

Name of the action.

controllerName - System.String

Name of the controller.

routeValues - System.Object

The route values.

Example

             @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                            .Save("Save", "Home", new { id = 1 })
                        )
            )

Save(System.String,System.String)

Sets the action and controller for the save operation

Parameters

actionName - System.String

Name of the action.

controllerName - System.String

Name of the controller.

Example

             @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                            .Save("Save", "Home")
                        )
            )

Save(System.String)

Sets the route name for the save operation

Parameters

routeName - System.String

Name of the route.

Example

             @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                            .Save("Default")
                        )
            )

Save(System.Web.Routing.RouteValueDictionary)

Sets the route values for the save operation

Parameters

routeValues - System.Web.Routing.RouteValueDictionary

The route values of the action method.

Example

             @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                            .Save(MVC.Home.Save(1).GetRouteValueDictionary())
                        )
            )

Save(System.String,System.Web.Routing.RouteValueDictionary)

Sets the route and values for the save operation

Parameters

routeName - System.String

Name of the route.

routeValues - System.Web.Routing.RouteValueDictionary

The route values.

Example

             @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                            .Save("Default", new RouteValueDictionary{ {"id", 1} })
                        )
            )

Save(System.String,System.Object)

Sets the route and values for the save operation

Parameters

routeName - System.String

Name of the route.

routeValues - System.Object

The route values.

Example

             @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                            .Save("Default", new { id = 1 })
                        )
            )

Save(System.Linq.Expressions.Expression)

Sets the action for the save operation

Parameters

controllerAction - System.Linq.Expressions.Expression<Action>

The action.

Example

             @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                            .Save<HomeController>(controller => controller.Save())
                        )
            )

SaveField(System.String)

Sets the field name for the save operation

Parameters

fieldName - System.String

The form field name to use for submiting the files. The Upload name is used if not set.

Example

             @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                            .SaveField("attachment")
                        )
            )

SaveUrl(System.String)

Sets an absolute or relative Save action URL. Note that the URL must be in the same domain for the upload to succeed.

Parameters

url - System.String

The Save action URL.

Example

             @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                            .SaveUrl("/save")
                        )
            )

Remove(System.String,System.String,System.Web.Routing.RouteValueDictionary)

Sets the action, controller and route values for the remove operation

Parameters

actionName - System.String

Name of the action.

controllerName - System.String

Name of the controller.

routeValues - System.Web.Routing.RouteValueDictionary

The route values.

Example

             @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                            .Remove("Remove", "Home", new RouteValueDictionary{ {"id", 1} })
                        )
            )

Remove(System.String,System.String,System.Object)

Sets the action, controller and route values for the remove operation

Parameters

actionName - System.String

Name of the action.

controllerName - System.String

Name of the controller.

routeValues - System.Object

The route values.

Example

             @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                            .Remove("Remove", "Home", new { id = 1 })
                        )
            )

Remove(System.String,System.String)

Sets the action and controller for the remove operation

Parameters

actionName - System.String

Name of the action.

controllerName - System.String

Name of the controller.

Example

             @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                            .Remove("Remove", "Home")
                        )
            )

Remove(System.String)

Sets the route name for the remove operation

Parameters

routeName - System.String

Name of the route.

Example

             @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                            .Remove("Default")
                        )
            )

Remove(System.Web.Routing.RouteValueDictionary)

Sets the route values for the remove operation

Parameters

routeValues - System.Web.Routing.RouteValueDictionary

The route values of the action method.

Example

             @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                            .Remove(MVC.Home.Remove(1).GetRouteValueDictionary())
                        )
            )

Remove(System.String,System.Web.Routing.RouteValueDictionary)

Sets the route and values for the remove operation

Parameters

routeName - System.String

Name of the route.

routeValues - System.Web.Routing.RouteValueDictionary

The route values.

Example

             @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                            .Remove("Default", new RouteValueDictionary{ {"id", 1} })
                        )
            )

Remove(System.String,System.Object)

Sets the route and values for the remove operation

Parameters

routeName - System.String

Name of the route.

routeValues - System.Object

The route values.

Example

             @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                            .Remove("Default", new { id = 1 })
                        )
            )

Remove(System.Linq.Expressions.Expression)

Sets the action for the remove operation

Parameters

controllerAction - System.Linq.Expressions.Expression<Action>

The action.

Example

             @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                            .Remove<HomeController>(controller => controller.Remove())
                        )
            )

RemoveUrl(System.String)

Sets an absolute or relative Remove action URL. Note that the URL must be in the same domain for the operation to succeed.

Parameters

url - System.String

The Remove action URL.

Example

             @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                            .RemoveUrl("/remove")
                        )
            )

RemoveField(System.String)

Sets the field name for the remove operation

Parameters

fieldName - System.String

The form field name to use for submiting the files. "fileNames" is used if not set.

Example

             @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                            .RemoveField("attachments")
                        )
            )

UseArrayBuffer(System.Boolean)

By default, the files are uploaded as filedata. When set to true, the files are read as file buffer by using FileReader and this buffer is send in the request body.

Parameters

useArrayBuffer - System.Boolean

true if arrayBuffer should be send; false by default

Example

             @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                           .Save("Save", "Home")
                           .UseArrayBuffer(true)
                        )
            )

WithCredentials(System.Boolean)

Sets a value indicating whether to send credentials (cookies, headers) for cross-site requests.

Parameters

withCredentials - System.Boolean

true if credentials should be sent, false otherwise; true by default

Example

             @( Html.Kendo().Upload()
                        .Name("Upload")
                        .Async(async => async
                           .WithCredentials(false)
                        )
            )