Easp.Upload.AllowMaxSize - EasyASP API 文档

## Easp.Upload.AllowMaxSize
属性，设置允许上传的总大小
<h4 class="font-thin"><label class="label bg-info text-white"><i class="fa fa-code"></i> 语法</label></h4>

```asp
Easp.Upload.AllowMaxSize = sizeStr
```
<h4 class="font-thin"><label class="label bg-info text-white"><i class="fa fa-cogs"></i> 参数</label></h4>

|参数|类型|说明
| ------------ | ------------ |
|sizeStr|String(字符串)|允许上传的总大小，默认为-1，无限制
允许的写法：
`10gb` `10mb` `10kb`
也可以直接写数字，那么单位就是 `b`
<h4 class="font-thin"><label class="label bg-info text-white"><i class="fa fa-reply"></i> 返回值</label></h4>

无返回值
<h4 class="font-thin"><label class="label bg-info text-white"><i class="fa fa-info-circle"></i> 说明</label></h4>

本属性限制了每次上传的所有文件的总大小，善用此功能，在多文件批量上传环境下，可以确保服务器的负载安全，又能兼顾单个文件上传尺寸的灵活设置。
<h4 class="font-thin"><label class="label bg-info text-white"><i class="fa fa-plug"></i> 示例</label></h4>

```asp
Easp.Upload.AllowMaxSize = "1gb"
Easp.Upload.AllowMaxSize = "1024mb"
Easp.Upload.AllowMaxSize = "1024kb"
Easp.Upload.AllowMaxSize = -1
Easp.Upload.AllowMaxSize = 102400000
```
以上写法根据需要任选一种。
<h4 class="font-thin"><label class="label bg-info text-white"><i class="fa fa-tag"></i> 应用场景 & 使用心得</label></h4>

上传多个文件时如果需要限制总大小，就需要设置该属性。
<h4 class="font-thin"><label class="label bg-info text-white"><i class="fa fa-terminal"></i> 源码解析</label></h4>

core/easp.upload.asp第18行：
```asp
Public Property Let AllowMaxSize(ByVal value)
	vMaxSize = Value
End Property
```
另外在上传时用了一个内部方法处理单位，core/easp.upload.asp第113行：
```asp
Private Function ParseSizeLimit(byval SizeLimit)
	dim unit,value,multiplier,limit
	If Not isnumeric(SizeLimit) Then
		multiplier = 1
		SizeLimit = ReplaceEx(lcase(SizeLimit),"\s","")
		value = replaceex(SizeLimit,"[^\d]+","")
		if isnumeric(value) then
			value = clng(value)
			if right(SizeLimit,2)="gb" then multiplier = 1073741824
			if right(SizeLimit,2)="mb" then multiplier = 1048576
			if right(SizeLimit,2)="kb" then multiplier = 1024
			limit = value * multiplier
		else
			limit=-1
		end If
	else
		limit = SizeLimit
	End If  
	if limit<-1 then limit=-1
	ParseSizeLimit = limit
End Function
```