تصفية الكائنات أثناء تحميل المصنف أو ورقة العمل

سيناريوهات الاستخدام المحتملة

يرجى استخدام خاصية LoadOptions.LoadFilter أثناء تصفية البيانات من دفتر العمل. ولكن إذا كنت ترغب في تصفية البيانات من أوراق العمل الفردية، فسيتعين عليك تجاوز الطريقة LoadFilter.StartSheet. يرجى توفير قيمة مناسبة من تعداد LoadDataFilterOptions أثناء إنشاء أو العمل مع LoadFilter.

تحتوي تعداد LoadDataFilterOptions على القيم الممكنة التالية.

• الكل
• إعدادات الكتاب
• خلية فارغة
• خلية مع تخطيط
• بيانات الخلية
• خطأ الخلية
• رقم الخليّة
• سلسلة الخليّة
• قيمة الخلية
• Chart
• تنسيق شرطي
• التحقق من البيانات
• الأسماء المعرفة
• خصائص المستند
• صيغة
• الروابط الفائقة
• منطقة مدمجة
• الجدول المحوري
• الإعدادات
• الشكل
• بيانات الورقة
• إعدادات الورقة
• البنية
• النمط
• الجدول
• VBA
• خريطة Xml

تصفية الكائنات أثناء تحميل دفتر العمل

يوضح الكود المصدري التالي كيفية تصفية الرسوم البيانية من دفتر العمل. يرجى التحقق من ملف الإكسل العيني المستخدم في هذا الكود و ملف PDF الناتج الذي تم إنشاؤه بواسطته. كما يمكنك رؤية في ملف PDF الناتج، تم تصفية جميع الرسوم البيانية من دفتر العمل.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Create directory if it is not already present.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);

// Filter charts from the workbook.
LoadOptions lOptions = new LoadOptions();
lOptions.LoadFilter = new LoadFilter(LoadDataFilterOptions.All & ~LoadDataFilterOptions.Chart);

// Load the workbook with above filter.
Workbook workbook = new Workbook(dataDir + "sampleFilterCharts.xlsx", lOptions);

// Save worksheet to a single PDF page.
PdfSaveOptions pOptions = new PdfSaveOptions();
pOptions.OnePagePerSheet = true;

// Save the workbook in PDF format.
workbook.Save(dataDir + "sampleFilterCharts.pdf", pOptions);

تصفية الكائنات أثناء تحميل ورقة العمل

يقوم الكود المصدري التالي بتحميل ملف الإكسل الأصلي ويقوم بتصفية البيانات التالية من ورقات العمل باستخدام تصفية مخصصة.

• يتم تصفية الرسوم البيانية من ورقة العمل التي تحمل اسم لا توجد فيها رسوم بيانية.
• يتم تصفية الأشكال من ورقة العمل التي تحمل اسم لا توجد فيها أشكال.
• يتم تصفية التنسيق الشرطي من ورقة العمل التي تحمل اسم لا توجد فيها تنسيق شرطي.

يقوم بتحميل ملف Excel المصدر (5115255.xlsx) بتصفية مخصصة، ثم يأخذ صور جميع ورقات العمل بشكل تتابع. إليك صور الإخراج للإشارة. كما يمكنك أن ترى، الصورة الأولى ليست تحتوي على رسوم بيانية، الصورة الثانية ليست تحتوي على أشكال، والصورة الثالثة ليست تحتوي على تنسيق شرطي.

• NoCharts.png
• NoShapes.png
• NoConditionalFormatting.png

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
public class CustomLoadFilter : LoadFilter
{
    public override void StartSheet(Worksheet sheet)
    {
        if (sheet.Name == "NoCharts")
        {
            //Load everything and filter charts
            this.LoadDataFilterOptions = LoadDataFilterOptions.All & ~LoadDataFilterOptions.Chart;
        }

        if (sheet.Name == "NoShapes")
        {
            //Load everything and filter shapes
            this.LoadDataFilterOptions = LoadDataFilterOptions.All & ~LoadDataFilterOptions.Drawing;
        }

        if (sheet.Name == "NoConditionalFormatting)")
        {
            //Load everything and filter conditional formatting
            this.LoadDataFilterOptions = LoadDataFilterOptions.All & ~LoadDataFilterOptions.ConditionalFormatting;
        }
    }
}

هكذا تستخدم فئة CustomLoadFilter حسب أسماء ورقة العمل.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
public static void Run()
{
    //Source directory
    string sourceDir = RunExamples.Get_SourceDirectory();

    //Output directory
    string outputDir = RunExamples.Get_OutputDirectory();

    // Filter worksheets using CustomLoadFilter class
    LoadOptions loadOpts = new LoadOptions();
    loadOpts.LoadFilter = new CustomLoadFilter();

    // Load the workbook with filter defined in CustomLoadFilter class
    Workbook workbook = new Workbook(sourceDir + "sampleCustomFilteringPerWorksheet.xlsx", loadOpts);

    // Take the image of all worksheets one by one
    for (int i = 0; i < workbook.Worksheets.Count; i++)
    {
        // Access worksheet at index i
        Worksheet worksheet = workbook.Worksheets[i];

        // Create an instance of ImageOrPrintOptions
        // Render entire worksheet to image
        ImageOrPrintOptions imageOpts = new ImageOrPrintOptions();
        imageOpts.OnePagePerSheet = true;
        imageOpts.ImageType = Drawing.ImageType.Png;

        // Convert worksheet to image
        SheetRender render = new SheetRender(worksheet, imageOpts);
        render.ToImage(0, outputDir + "outputCustomFilteringPerWorksheet_" + worksheet.Name + ".png");
    }
}