
Microsoft Office Excel به شما امکان می دهد داده های متنی خود را در قالب صفحه گسترده یا کتاب کار چیدمان کنید. شما میتوانید اطلاعات و دادهها را از فایلها و مکانهای مختلف به یک مقصد بیاورید تا آنها در یک فایل فشرده و تجزیه و تحلیل شوند. برای برجسته کردن داده های مهم، سایه های رنگی مختلف، پررنگ، مورب را در کاربرگ اکسل تعریف کنید. می توانید یک طرح رنگ آمیزی مناسب برای تجزیه و تحلیل سریع انتخاب کنید. موارد زیر کاربردهای رایج فایل های اکسل است
- ورود و ذخیره سازی داده ها
- جمع آوری و تأیید داده های تجاری
- وظایف اداری و مدیریتی
- حسابداری و بودجه
- تجزیه و تحلیل داده ها
- گزارش + تجسم
- پیش بینی
قالب بندی شرطی
قالب بندی شرطی یک ویژگی در بسیاری از برنامه های صفحه گسترده است. این به شما امکان می دهد قالب بندی خاصی را برای سلول هایی اعمال کنید که معیارهای خاصی را دارند. اغلب به عنوان قالب بندی مبتنی بر رنگ برای برجسته کردن، تأکید یا تمایز بین داده ها و اطلاعات ذخیره شده در یک صفحه گسترده استفاده می شود. اگر شرایط نادرست باشد، محدوده سلولی قالب بندی نمی شود. به عنوان مثال، می توانید اعداد زیر هزار را با رنگ قرمز و اعداد بالای هزار را با رنگ آبی داشته باشید.
در زیر، تجسمهای قالببندی شرطی محبوب موجود است
- سایه رنگی پس زمینه (سلول ها)
- سایه رنگی پیش زمینه (فونت ها)
- نوارهای داده
- آیکون ها (که دارای 4 نوع تصویر مختلف هستند)
- ارزش ها
موضوعات مشخص شده در زیر با جزئیات بیشتر توضیح داده شده است
- قالب بندی مشروط کاربرگ را دریافت کنید
- قالب بندی شرطی را اضافه کنید
- تمام قالب بندی های شرطی را پاک کنید
- قالب بندی شرطی را برای منطقه خاصی حذف کنید
قالب بندی مشروط کاربرگ را دریافت کنید
Aspose.Cells Cloud قابلیت خواندن اطلاعات قالب بندی شرطی را از کاربرگ های اکسل فراهم می کند. روش GetWorksheetConditionalFormattings در API به شما امکان می دهد جزئیات قالب بندی را از کاربرگ اکسل بخوانید. اولین قدم این است که یک توکن JWT بر اساس Client ID شخصی و Client Secret ایجاد کنید. برای اطلاعات بیشتر، لطفاً به [How to Obtain JWT Token with a Client ID and Client Secret key] مراجعه کنید (https://blog.aspose.cloud/fa/total/how-to-obtain-jwt-token-using-a-client-id-and-client-secret-key/)
دستور cURL در زیر نشان داده شده است که به خواندن جزئیات قالب بندی از یک کاربرگ اکسل کمک می کند
curl -X GET "https://api.aspose.cloud/v3.0/cells/conditional.xlsx/worksheets/Sheet1/conditionalFormattings" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"
سی شارپ دات نت
// برای نمونه های کامل و فایل های داده، لطفاً به https://github.com/aspose-cells-cloud/aspose-cells-cloud-dotnet/ مراجعه کنید.
CellsApi instance = new CellsApi(clientId, clientSecret, apiVersion, testbaseurl);
string name = BOOK1;
string sheetName = SHEET1;
string folder = TEMPFOLDER;
instance.UploadFile(folder + @"\" + name, File.Open( @"C:\TestData\" +name));
var response = instance.CellsConditionalFormattingsGetWorksheetConditionalFormattings(name, sheetName, folder);
Assert.IsInstanceOf<ConditionalFormattingsResponse>(response, "response is ConditionalFormattingsResponse");
Assert.AreEqual(response.Code, 200);
قالب بندی شرطی را اضافه کنید
مایکروسافت اکسل سه پیشتنظیم برای قالببندی شرطی، نوار داده، مقیاسهای رنگی و مجموعه آیکونها ارائه میکند و Aspose.Cells Cloud API از همه این انواع پشتیبانی میکند. پارامترهای مختلف شرایط از جمله نوع، اپراتور، سبک، ناحیه سلول و غیره را مشخص کنید.
دستور cURL
curl -X PUT "https://api.aspose.cloud/v3.0/cells/conditional.xlsx/worksheets/Sheet1/conditionalFormattings?cellArea=C4%3AC6" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>" \
-H "Content-Type: application/json" \
-d "{ \"link\": { \"Href\": \"string\", \"Rel\": \"string\", \"Title\": \"string\", \"Type\": \"string\" }, \"Priority\": 2, \"Type\": \"CellValue\", \"StopIfTrue\": true, \"AboveAverage\": { \"IsAboveAverage\": true, \"IsEqualAverage\": true, \"StdDev\": 0 }, \"ColorScale\": { \"MaxCfvo\": { \"IsGTE\": true, \"Type\": \"string\" }, \"MaxColor\": { \"A\": 100, \"R\": 200, \"G\": 200, \"B\": 0 }, \"MidCfvo\": { \"IsGTE\": true, \"Type\": \"string\" }, \"MidColor\": { \"A\": 0, \"R\": 0, \"G\": 0, \"B\": 0 }, \"MinCfvo\": { \"IsGTE\": true, \"Type\": \"string\" }, \"MinColor\": { \"A\": 0, \"R\": 0, \"G\": 0, \"B\": 0 } }, \"DataBar\": { \"AxisColor\": { \"A\": 0, \"R\": 0, \"G\": 0, \"B\": 0 }, \"AxisPosition\": \"string\", \"BarBorder\": { \"Color\": { \"A\": 0, \"R\": 0, \"G\": 0, \"B\": 0 }, \"Type\": \"string\" }, \"BarFillType\": \"string\", \"Color\": { \"A\": 0, \"R\": 0, \"G\": 0, \"B\": 0 }, \"Direction\": \"string\", \"MaxCfvo\": { \"IsGTE\": true, \"Type\": \"string\" }, \"MaxLength\": 0, \"MinCfvo\": { \"IsGTE\": true, \"Type\": \"string\" }, \"MinLength\": 0, \"NegativeBarFormat\": { \"BorderColor\": { \"A\": 0, \"R\": 0, \"G\": 0, \"B\": 0 }, \"BorderColorType\": \"string\", \"Color\": { \"A\": 0, \"R\": 0, \"G\": 0, \"B\": 0 }, \"ColorType\": \"string\" }, \"ShowValue\": true }, \"Formula1\": \"string\", \"Formula2\": \"string\", \"IconSet\": { \"CfIcons\": [ { \"ImageData\": \"string\", \"Index\": 0, \"Type\": \"string\" } ], \"Cfvos\": [ { \"IsGTE\": true, \"Type\": \"string\" } ], \"IsCustom\": true, \"Reverse\": true, \"ShowValue\": true, \"IconSetType\": \"string\" }, \"Operator\": \"string\", \"Style\": { \"link\": { \"Href\": \"string\", \"Rel\": \"string\", \"Title\": \"string\", \"Type\": \"string\" }, \"Font\": { \"Color\": { \"A\": 0, \"R\": 0, \"G\": 0, \"B\": 0 }, \"DoubleSize\": 0, \"IsBold\": true, \"IsItalic\": true, \"IsStrikeout\": true, \"IsSubscript\": true, \"IsSuperscript\": true, \"Name\": \"string\", \"Size\": 0, \"Underline\": \"string\" }, \"Name\": \"string\", \"CultureCustom\": \"string\", \"Custom\": \"string\", \"BackgroundColor\": { \"A\": 220, \"R\": 10, \"G\": 120, \"B\": 0 }, \"ForegroundColor\": { \"A\": 0, \"R\": 0, \"G\": 0, \"B\": 0 }, \"IsFormulaHidden\": true, \"IsDateTime\": true, \"IsTextWrapped\": true, \"IsGradient\": true, \"IsLocked\": true, \"IsPercent\": true, \"ShrinkToFit\": true, \"IndentLevel\": 0, \"Number\": 0, \"RotationAngle\": 0, \"Pattern\": \"None\", \"TextDirection\": \"Context\", \"VerticalAlignment\": \"Center\", \"HorizontalAlignment\": \"General\", \"BorderCollection\": [ { \"LineStyle\": \"string\", \"Color\": { \"A\": 120, \"R\": 0, \"G\": 0, \"B\": 0 }, \"BorderType\": \"BottomBorder\", \"ThemeColor\": { \"ColorType\": \"string\", \"Tint\": 0 }, \"ArgbColor\": -16777216 } ], \"BackgroundThemeColor\": { \"ColorType\": \"string\", \"Tint\": 0 }, \"ForegroundThemeColor\": { \"ColorType\": \"string\", \"Tint\": 0 } }, \"Text\": \"string\", \"TimePeriod\": \"string\", \"Top10\": { \"IsBottom\": true, \"IsPercent\": true, \"Rank\": 0 }}"
با توجه به قطعه کد C# در زیر، قالب بندی شرطی را در کاربرگ اکسل اضافه می کند:
سی شارپ دات نت
// AppKey و AppSID را از https://dashboard.aspose.cloud/ دریافت کنید
// Nuget Package Aspose.Cells-Cloud را نصب کنید
// برای نمونههای کامل و فایلهای داده، لطفاً به https://github.com/aspose-cells-cloud/aspose-cells-cloud-dotnet بروید
CellsApi cellsApi = new CellsApi(AppKey, AppSid);
string name = "BOOK1.xlsx";
string sheetName = "SHEET1";
string cellArea = "A1:C10";
FormatCondition formatcondition = new FormatCondition();
formatcondition.Type = "CellValue";
formatcondition.Operator = "Between";
formatcondition.Formula1 = "10";
formatcondition.Formula2 = "20";
var color = new Color();
color.A = 1;
color.R = 132;
color.G = 157;
color.B = 204;
Style style = new Style();
style.BackgroundColor = color;
formatcondition.Style = style;
string folder = "TEMPFOLDER";
var response = cellsApi.CellsConditionalFormattingsPutWorksheetConditionalFormatting(name, sheetName, cellArea, formatcondition, folder);
تمام قالب بندی های شرطی را پاک کنید
Aspose.Cells Cloud به شما این امکان را می دهد که قالب بندی را از قالب بندی شرطی پاک کنید. روش DeleteWorksheetConditionalFormattings اهرمی را برای پاک کردن قالب بندی شرطی از صفحه گسترده اکسل در اختیار شما قرار می دهد. دستور cURL زیر را می توان برای انجام این نیاز استفاده کرد
دستور cURL
curl -X DELETE "https://api.aspose.cloud/v3.0/cells/conditional.xlsx/worksheets/Sheet1/conditionalFormattings" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"
سی شارپ دات نت
// برای نمونههای کامل و فایلهای داده، لطفاً به https://github.com/aspose-cells-cloud/aspose-cells-cloud-dotnet/ مراجعه کنید.
CellsApi instance = new CellsApi(clientId, clientSecret, apiVersion, testbaseurl);
string name = BOOK1;
string sheetName = SHEET1;
string folder = TEMPFOLDER;
instance.UploadFile(folder + @"\" + name, File.Open( @"C:\TestData\" +name));
var response = instance.CellsConditionalFormattingsDeleteWorksheetConditionalFormattings(name, sheetName, folder);
Assert.IsInstanceOf<CellsCloudResponse>(response, "response is CellsCloudResponse");
Assert.AreEqual(response.Code, 200);
روش بالا تمام قالب بندی های مشروط را حذف می کند و اگر می خواهید هر قالب بندی خاصی را حذف کنید، لطفاً از روش DeleteWorksheetConditionalFormatting استفاده کنید. این روش شماره فهرست را برای شرایط قالب بندی در صفحه گسترده اکسل می پذیرد.
دستور زیر قالب بندی شرطی را در شاخص 1 حذف می کند (جایی که مقدار شاخص از 0 شروع می شود).
دستور cURL
curl -X DELETE "https://api.aspose.cloud/v3.0/cells/conditional.xlsx/worksheets/Sheet1/conditionalFormattings/1" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"

تصویر 1: - قالب بندی از کاربرگ اکسل حذف شد.
قالب بندی شرطی را برای ناحیه خاصی حذف کنید
اگر نیاز به حذف قالب بندی شرطی از یک منطقه خاص دارید، لطفاً از روش DeleteWorksheetConditionalFormattingArea استفاده کنید. ما باید اطلاعات startRow، startColumn، totalRows و totalColumns را برای انجام الزامات مشخص کنیم. لطفاً توجه داشته باشید که نمایه های سطر و ستون با 0 شروع می شوند.
دستور cURL
curl -X DELETE "https://api.aspose.cloud/v3.0/cells/conditional.xlsx/worksheets/Sheet1/conditionalFormattings/area?startRow=4&startColumn=1&totalRows=3&totalColumns=1" \
-H "accept: application/json" \
-H "authorization: Bearer <JWT Token>"
نتیجه گیری
Aspose.Cells Cloud API یک محصول شگفتانگیز است و قابلیتهایی را برای ایجاد، دستکاری و تبدیل فایلهای MS Excel و OpenOffice Sheet به فرمتهای دیگر پشتیبانی میکند. نیازی به نصب محصول نیست
برای اطلاعات بیشتر، لطفاً از صفحه اصلی Aspose.Cells Cloud دیدن کنید. و برای اطلاعات در مورد نصب و پیکربندی SDK های مخصوص زبان برنامه نویسی، لطفاً به [نحوه نصب Aspose.Cloud SDK] مراجعه کنید.