آپلود و مدیریت فایل ها در Asp.Net MVC با کلاس کلاس TIT_File

کلاس TIT_File توسط تیم تهران آی تی جهت راحت تر شدن کار برنامه نویسان جهت آپلود و مدیریت فایل ها در Asp.Net MVC  ایجاد شده و دارای قابلیت های زیر است.

• آپلود انواع فایل
• ایجاد محدودیت در نوع فایل
• ایجاد محدودیت در حجم فایل
• مشخص کردن مکان آپلود فایل
• حذف فایل
• برسی موجود بودن یک فایل در سرور

افزودن کلاس TIT_File به پروژه

بعد از دانلود کلاس، در پروژه خود پوشه ای به نام Class یا هر نامی که دوست دارید ایجاد کرده و کلاس TIT_File را داخل آن قرار دهید. فقط توجه داشته باشید که namespace موجود در کلاس را تغییر دهید و به جای ProjectName نام پروژه خود را قرار دهید.

namespace ProjectName.Class

حال در کنترلر خود ابتدا کلاس را Using کنید

using ProjectName.Class;

کلاس خود را New کنید

TIT_File File = new TIT_File();

متد های کلاس TIT_File

این کلاس ۳ متد اصلی دارد که به شرح ذیل است :

• Upload برای آپلود فایل.
• Remove برای حذف فایل.
• Exist برای برسی این که آیا فایل مشخص شده در سرور وجود دارد یا خیر.

ورودی های متد Upload

این کلاس ۴ ورودی میگیرد که به ترتیب به شرح ذیل است :

• فایلی که قرار است آپلود شود از جنس HttpPostedFileBase.
• محدودیت حجم به مکابایت از جنس int.
• لیستی از فرمت های مجاز به آپلود از جنس []string.
• مکان یا نام پوسه ای که باید فایل در آن آپلود شود از جنس string.

[HttpPost]
public ActionResult Upload(HttpPostedFileBase MYFile)
{
    TIT_File File = new TIT_File();
    string[] format = { "jpg", "png" };
    bool upload = File.Upload(MYFile, 3, format, "upload");
    return View();
}

خروجی های متد Upload

این کلاس ۵ خروجی دارد که به ترتیب به شرح ذیل است :

• وضعیت آپلود
• پیام آپلود
• آدرس فایل
• فرمت فایل
• حجم فایل

خود کلاس یک مقدار bool بر میگرداند. اگر true بود یعنی عملیات آپلود فایل با موفقیت انجام شده و اگر false بود یعنی آپلود فایل با مشکل روبرو شده.

bool upload = File.Upload(MYFile, 3, format, "upload");

متد File.Message از این متد چه زمانی که آپلود فایل  موفق باشد جه زمانی که موفق نباشد میتوان استفاده کرد و پیام موفقیت یا نوع خطا را بر میگرداند.

ViewBag.Message = File.Message;

File.Address در زمانی که آپلود فایل  موفق باشد، آدرس فایل را برمیگرداند.

ViewBag.Address = File.Address;

File.Format در زمانی که آپلود فایل  موفق باشد، فرمت فایل را برمیگرداند.

ViewBag.Format = File.Format;

File.ContentLength در زمانی که آپلود فایل  موفق باشد، حجم فایل را برمیگرداند.

ViewBag.ContentLength = File.ContentLength;

نمونه کد برای آپلود فایل

[HttpPost]
public ActionResult Upload(HttpPostedFileBase MYFile)
{
    TIT_File File = new TIT_File();
    string[] format = { "jpg", "png" };
    bool upload = File.Upload(MYFile, 3, format, "upload");
    if (upload)
    {
        ViewBag.Message = File.Message;
        ViewBag.Address = File.Address;
        ViewBag.Format = File.Format;
        ViewBag.ContentLength = File.ContentLength;
        return View("Index");
    }
    else
    {
        ViewBag.Message = File.Message;
        return View("Index");
    }
}

حذف فایل ها با متد Remove

این متد برای حذف فایل از سرور مورد استفاده قرار میگیرد. یک ورودی و یک خروجی دارد، ورودی آدرس فایل مورد نظر ماست که میخواهیم حذف شود و خروجی مقدار True به معنی موفقیت در حذف فایل  و False به معنی عدم موفقیت در حذف فایل است.

public ActionResult Remove(string address)
{
    TIT_File File = new TIT_File();
    bool remove = File.Remove(address);
    ViewBag.Remove = remove;
    return View("Index");
}

برسی وجود فایل با متد Exist

این متد برای برسی این که آیا فایل مورد نظر ما در سرور وجود دارد یا خیر  به کار میرود. یک ورودی و یک خروجی دارد، ورودی آدرس فایل مورد نظر ماست و خروجی مقدار True به معنی وجود داشتن فایل در سرور و False به معنی عدم وجود فایل در سرور است.

public ActionResult Exist(string address)
{
    TIT_File File = new TIT_File();
    bool exist = File.Exist(address);
    ViewBag.Exist = exist;
    return View();
}

رفع ارور های احتمالی

ارور هایی ممکن است با آن مواجه شوید، آنها را رفع کنید.

• ارور شماره یک : The request filtering module is configured to deny a request that exceeds the request content length.

برای رفع این ارور به فایل web.config مراجعه کرده و کد زیر را داخل تگ configuration اضافه کنید.

<system.webServer>
    <security>
        <requestFiltering>
            <requestLimits maxAllowedContentLength="1073741824" />
        </requestFiltering>
    </security>
</system.webServer>

• ارور شماره دو : Maximum request length exceeded.

برای رفع این ارور به فایل web.config مراجعه کرده و به تگ httpRuntime اتربیوت maxRequestLength=”1048576″ را اضافه کنید.

<system.web>
    <compilation debug="true" targetFramework="4.7.2"/>
    <httpRuntime targetFramework="4.7.2" maxRequestLength="1048576"/>
</system.web>