پیدا کنید و جایگزین کنید

شما به راحتی می توانید با استفاده از صفحه کلید و ماوس در سند خود حرکت کنید، اما اگر صفحات زیادی برای پیمایش دارید، یافتن متن خاصی در یک سند طولانی مدت زمان زیادی طول می کشد. زمانی که بخواهید نویسه‌ها یا کلمات خاصی را که در سند خود استفاده کرده‌اید جایگزین کنید زمان‌برتر خواهد بود. عملکرد “یافتن و جایگزینی” به شما امکان می دهد دنباله ای از کاراکترها را در یک سند پیدا کنید و آن را با دنباله دیگری از کاراکترها جایگزین کنید.

Aspose.Words به شما این امکان را می دهد که یک رشته خاص یا الگوی عبارت منظم را در سند خود پیدا کنید و بدون نصب و استفاده از برنامه های کاربردی اضافی مانند Microsoft Word آن را با یک جایگزین جایگزین کنید. این کار بسیاری از کارهای تایپ و قالب بندی را سرعت می بخشد و به طور بالقوه باعث صرفه جویی در ساعات کار شما می شود.

این مقاله نحوه اعمال جایگزینی رشته و عبارات منظم با پشتیبانی از متاکراکترها را توضیح می دهد.

راه هایی برای یافتن و جایگزینی

Aspose.Words با استفاده از موارد زیر دو راه را برای اعمال عملیات Find and جایگزین ارائه می دهد:

1. تعویض رشته ساده – برای یافتن و جایگزینی یک رشته خاص با رشته دیگر، باید یک رشته جستجو (کاراکترهای الفبایی) را مشخص کنید که قرار است با توجه به همه موارد با یک رشته جایگزین مشخص شده دیگر جایگزین شود. هر دو رشته نباید دارای علامت باشند. در نظر بگیرید که مقایسه رشته می تواند به حروف کوچک و بزرگ حساس باشد، یا ممکن است از املای آن مطمئن نباشید یا چندین املای مشابه داشته باشید.
2. عبارات منظم – برای تعیین یک عبارت منظم برای یافتن رشته های دقیق مطابق و جایگزینی آنها با توجه به عبارت منظم شما. توجه داشته باشید که یک کلمه به این صورت تعریف می شود که فقط از کاراکترهای الفبایی ساخته شده باشد. اگر جایگزینی فقط با کل کلمات مطابقت داده شود و رشته ورودی حاوی نمادها باشد، هیچ عبارتی پیدا نخواهد شد.

علاوه بر این، می‌توانید از متاکاراکترهای ویژه با جایگزینی رشته‌های ساده و عبارات منظم برای مشخص کردن شکست‌ها در عملیات find و جایگزین استفاده کنید.

Aspose.Words قابلیت یافتن و جایگزینی را با فضای نام Aspose.Words.Replacing ارائه می دهد. با استفاده از کلاس FindReplaceOptions می‌توانید با گزینه‌های زیادی در طول فرآیند Find and جایگزینی کار کنید.

یافتن و جایگزینی متن با استفاده از جایگزین رشته ساده

می‌توانید از یکی از روش‌های Replace برای یافتن یا جایگزینی یک رشته خاص استفاده کنید و تعداد جایگزین‌های انجام شده را برگردانید. در این مورد، می‌توانید رشته‌ای را برای جایگزینی تعیین کنید، رشته‌ای که جایگزین همه موارد آن می‌شود، اینکه آیا جایگزینی به حروف بزرگ و کوچک حساس است یا نه و آیا فقط کلمات مستقل تحت تأثیر قرار می‌گیرند.

مثال کد زیر نشان می دهد که چگونه می توان رشته “CustomerName” را پیدا کرد و آن را با رشته “James Bond” جایگزین کرد:

می توانید قبل از اعمال جایگزینی ساده رشته، تفاوت بین سند را متوجه شوید:

و پس از اعمال جایگزینی ساده رشته:

یافتن و جایگزینی متن با استفاده از عبارات منظم

یک عبارت منظم (regex) الگویی است که دنباله خاصی از متن را توصیف می کند. فرض کنید می خواهید همه تکرارهای یک کلمه را با یک کلمه واحد جایگزین کنید. سپس می توانید عبارت منظم زیر را برای تعیین الگوی دو کلمه ای اعمال کنید: ([a-zA-Z]+) \1.

از روش دیگر Replace برای جستجو و جایگزینی ترکیبات کاراکترهای خاص با تنظیم پارامتر Regex به عنوان الگوی عبارت منظم برای یافتن موارد منطبق استفاده کنید.

مثال کد زیر نشان می دهد که چگونه رشته هایی را که با یک الگوی عبارت منظم مطابقت دارند با یک رشته جایگزین مشخص جایگزین کنید:

می توانید قبل از اعمال جایگزینی رشته با عبارات منظم، تفاوت بین سند را متوجه شوید:

و پس از اعمال جایگزینی رشته با عبارات منظم:

یافتن و جایگزینی رشته با استفاده از متاکاراکترهای

اگر متن یا عبارت خاصی از چند پاراگراف، بخش یا صفحه تشکیل شده باشد، می‌توانید از متاکاراکترها در رشته جستجو یا رشته جایگزین استفاده کنید. برخی از متاکاراکترها عبارتند از &پ برای شکست پاراگراف، &b برای شکست بخش، &m برای شکست صفحه و &l برای شکست خط.

توجه داشته باشید که متاکاراکتر && برابر با & است. به عنوان مثال، اگر شما نیاز به یافتن متنی برای &پ دارید که یک پاراگراف نیست، می توانید از &&پ استفاده کنید.

مثال کد زیر نحوه جایگزینی متن با پاراگراف و صفحه شکست را نشان می دهد:

یافتن و جایگزینی رشته در سربرگ/پانویس یک سند

می‌توانید با استفاده از کلاس HeaderFooter، متنی را در قسمت سرصفحه/پانویس یک سند Word پیدا کرده و جایگزین کنید.

مثال کد زیر نشان می دهد که چگونه متن قسمت هدر را در سند خود جایگزین کنید:

قبل از اعمال جایگزینی رشته هدر می توانید تفاوت بین سند را مشاهده کنید:

و پس از اعمال جایگزینی رشته هدر:

مثال کد برای جایگزینی متن بخش فوتر در سند شما بسیار شبیه به مثال کد سرصفحه قبلی است. تنها کاری که باید انجام دهید این است که دو خط زیر را جایگزین کنید:

HeaderFooter header = headersFooters[HeaderFooterType.HeaderPrimary];
header.Range.Replace("Aspose.Words", "Remove", options);

با موارد زیر:

HeaderFooter footer = headersFooters[HeaderFooterType.FooterPrimary];
int currentYear = System.DateTime.Now.Year;
footer.Range.Replace("(C) 2006 Aspose Pty Ltd.", $"Copyright (C) {currentYear} by Aspose Pty Ltd.", options);

قبل از اعمال جایگزینی رشته پاورقی، می توانید تفاوت بین سند را متوجه شوید:

و پس از اعمال جایگزینی رشته فوتر:

در حین یافتن و جایگزینی {#ignore-text-during-find-and-replace}، متن را نادیده بگیرید

در حین اعمال عملیات یافتن و جایگزینی، می توانید بخش های خاصی از متن را نادیده بگیرید. بنابراین، بخش‌های خاصی از متن را می‌توان از جستجو حذف کرد و یافتن و جایگزینی را می‌توان فقط برای قسمت‌های باقی‌مانده اعمال کرد.

Aspose.Words بسیاری از ویژگی‌های یافتن و جایگزینی را برای نادیده گرفتن متن مانند IgnoreDeleted، IgnoreFieldCodes، IgnoreFields، IgnoreFootnotes و IgnoreInserted ارائه می‌کند.

مثال کد زیر نحوه نادیده گرفتن متن داخل ویرایش های حذف را نشان می دهد:

یافتن و جایگزینی عملیات {#customize-find-and-replace-operation} را سفارشی کنید

Aspose.Words بسیاری از properties های مختلف را برای یافتن و جایگزینی متن ارائه می دهد، مانند اعمال فرمت خاص با ویژگی های ApplyFont و ApplyParagraphFormats، استفاده از جایگزینی در الگوهای جایگزین با ویژگی UseSubstitutions و موارد دیگر.

مثال کد زیر نشان می دهد که چگونه یک کلمه خاص را در سند خود برجسته کنید:

Aspose.Words به شما امکان می دهد از رابط IReplacingCallback برای ایجاد و فراخوانی یک روش سفارشی در طول عملیات جایگزینی استفاده کنید. ممکن است موارد استفاده ای داشته باشید که در آنها نیاز به سفارشی کردن عملیات یافتن و جایگزینی داشته باشید، مانند جایگزین کردن متن مشخص شده با یک عبارت معمولی با تگ های HTML، بنابراین اساساً جایگزین را با درج HTML اعمال خواهید کرد.

اگر می‌خواهید یک رشته را با یک تگ HTML جایگزین کنید، رابط IReplacingCallback را برای سفارشی‌سازی عملیات یافتن و جایگزینی اعمال کنید تا مطابقت در ابتدای اجرا با گره مطابقت سند شما شروع شود. اجازه دهید چندین مثال از استفاده از IReplacingCallback ارائه دهیم.

مثال کد زیر نحوه جایگزینی متن مشخص شده با HTML را نشان می دهد:

مثال کد زیر نحوه برجسته کردن اعداد مثبت با رنگ سبز و اعداد منفی با رنگ قرمز را نشان می دهد:

مثال کد زیر نحوه اضافه کردن یک شماره خط به هر خط را نشان می دهد: