کار با پیوندها و مراجع
بررسی کلی
کدهای فیلد پیوند و ارجاع متقاطع Word – HYPERLINK, REF, PAGEREF, NOTEREF, STYLEREF, SET, ASK, FILLIN, CITATION, BIBLIOGRAPHY, و موارد دیگر – هر یک بهصورت یک اختصاصی Field زیرکلاس در Aspose.Words FOSS برای .NET. تمام این کلاسها در Aspose.Words.Fields فضاینام همراه با هر نوع فیلد دیگر؛ این صفحه کلاسهایی را که بهطور خاص به پیوندها، ارجاعات متقاطع، مقادیر درخواستشده و ارجاعات مربوط میشوند، گروهبندی میکند و آنچه هر یک از آنها ارائه میدهد را پوشش میدهد.
Hyperlinks
FieldHyperlink نمایانگر فیلد HYPERLINK است: Address و SubAddress URL هدف یا مکان درون-سندی را نگه میدارند، ScreenTip ابزار راهنمای نمایش-به-منزلق را تنظیم میکند، OpenInNewWindow و IsImageMap پرچمهای نمایش هستند، و Target یک قاب مرورگر را نامگذاری میکند. برای موارد ساده، DocumentBuilder.InsertHyperlink() فیلد هایپرلینک را بهصورت مستقیم بدون ساختن شیء Field بهدست میسازد.
ارجاعات متقاطع به نشانکها
FieldRef (فیلد REF)، FieldPageRef (PAGEREF) و FieldNoteRef (NOTEREF) هر کدام به محتوای موجود در یک نشانک نامگذاریشده از طریق ویژگی BookmarkName خود ارجاع میدهند، بهطوری که InsertHyperlink و InsertRelativePosition کنترل میکنند آیا ارجاع قابل کلیک باشد و آیا موقعیت نسبی («بالا» / «پایین») را گزارش دهد. FieldRef گزینههای شمارهگذاری پاراگراف را اضافه میکند (InsertParagraphNumber، InsertParagraphNumberInFullContext، InsertParagraphNumberInRelativeContext، NumberSeparator) و IncludeNoteOrComment. FieldStyleRef (STYLEREF) بهجای آن به نزدیکترین پاراگرافی که با StyleName مشخص شده قالببندی شده است ارجاع میدهد، با SearchFromBottom برای جستجوی معکوس از موقعیت فیلد. نشانکهایی که این فیلدها به آنها هدف میگیرند با استفاده از DocumentBuilder.StartBookmark() و EndBookmark() ایجاد میشوند و میتوان با MoveToBookmark() به آنها پیمایش کرد. FieldSet (SET) مقدار متنی نشانکگذاریشدهای را تعریف میکند — BookmarkName و BookmarkText — که یک فیلد REF در جای دیگر میتواند آن را بازیابی کند.
فیلدهای مقدار درخواستشده
FieldAsk (ASK) و FieldFillIn (FILLIN) مقدار را از هر کسی که فیلد را بهروزرسانی میکند درخواست میکند: PromptText به کاربر نمایش داده میشود، DefaultResponse یک گزینهی جایگزین فراهم میکند، و PromptOnceOnMailMerge تکرار درخواستها را در هنگام ادغام ایمیل محدود میکند. FieldAsk علاوه بر این، پاسخ خود را در BookmarkName برای ارجاع سایر فیلدها. ببینید راهنمای فیلدها for IFieldUserPromptRespondent, فراخوانی که پاسخها را بهصورت برنامهنویسی به این فیلدها میدهد بهجای درخواست تعاملی.
محتوای خارجی و پیوندی
FieldDde (DDE) و FieldDdeAuto (DDEAUTO) به محتوایی در برنامهای دیگر از طریق ProgId، SourceFullName و SourceItem پیوند میدهند، بهطوری که InsertAsText، InsertAsHtml، InsertAsPicture، InsertAsRtf، InsertAsUnicode و InsertAsBitmap نمای وارد شده را انتخاب میکنند، و AutoUpdate / IsLinked رفتار بهروزرسانی را کنترل میکنند. FieldLink (LINK) معادل OLE-link است و FormatUpdateType را اضافه میکند. FieldImport (IMPORT) و FieldIncludePicture (INCLUDEPICTURE) گرافیک خارجی را از طریق SourceFullName و GraphicFilter میکشند. FieldInclude (INCLUDE) و FieldIncludeText (INCLUDETEXT) محتویات سند خارجی را وارد میکنند، بههمراه BookmarkName برای تعیین دامنه بازهٔ گنجاندهشده و LockFields برای جلوگیری از بهروزرسانی آن؛ FieldIncludeText علاوه بر این، منابع XML را از طریق Encoding، MimeType، NamespaceMappings، XPath و XslTransformation پشتیبانی میکند.
AutoText و مراجع واژهنامه
FieldAutoText (AUTOTEXT)، FieldAutoTextList (AUTOTEXTLIST) و FieldGlossary (GLOSSARY) همگی از طریق EntryName به یک ورودی بلاک-ساز نامگذاریشده ارجاع میدهند؛ FieldAutoTextList برای نمایش بهصورت لیست، ListStyle و ScreenTip را اضافه میکند.
فیلدهای استناد و کتابشناسی
FieldCitation (CITATION) و FieldBibliography (BIBLIOGRAPHY) محتوایی را که از دادههای کتابنامهای سند بهدست آمده رندر میکند. FieldCitation.SourceTag (و جایگزین AnotherSourceTag) شناسایی میکند که کدام منبع را مینقلد، با Prefix, Suffix, PageNumber, VolumeNumber, و Suppress* پرچمها (SuppressAuthor, SuppressTitle, SuppressYear) که نحوه قالببندی ارجاع را کنترل میکند. FieldBibliography.SourceTag, FilterLanguageId, و FormatLanguageId کنترل میکند که کدام منابع در کتابنامه تولید شده ظاهر شوند و به چه زبانی. منبع زیرین این فیلدها را رندر میکند – Source, Contributor, Person – در راهنمای کتابنامه.
فیلدهای متن نقلقول و شکل
FieldQuote (QUOTE) و FieldShape (SHAPE) هر دو یک ویژگی Text را ارائه میدهند که متن صریح فیلد را نگه میدارد – FieldQuote آن را بهصورت مستقیم در موقعیت فیلد وارد میکند، در حالی که FieldShape آن را با کد فیلد متنی شکل رسم مرتبط میسازد.
نکات و بهترین شیوهها
- بهجای
DocumentBuilder.InsertHyperlink()برای افزودن لینک ساده ترجیح دهید؛ فقط زمانی که به ویژگیهایی مانندScreenTipیاIsImageMapنیاز دارید که میانبر سازنده آنها را نشان نمیدهد، به ساخت مستقیم یکFieldHyperlinkبروید. FieldRef،FieldPageRef،FieldNoteRefوFieldSetهمه از طریقBookmarkNameهماهنگ میشوند – اطمینان حاصل کنید که نشانک هدف وجود دارد (از طریقDocumentBuilder.StartBookmark()/EndBookmark()) پیش از اینکه فیلدی که به آن ارجاع میدهد بهروز شود.- تنظیم
FieldOptions.UserPromptRespondent(به راهنمای فیلدها) قبل از بهروزرسانی سندی که شاملFieldAskorFieldFillInفیلدها در یک خط لوله بدون نظارت. FieldDdeوFieldDdeAutoیک مکانیزم لینکگذاری قدیمی OLE ویندوز را مدل میکنند –AutoUpdateوIsLinkedرا بهعنوان اطلاعاتی در نظر بگیرید هنگام پردازش اسناد خارج از ویندوز، چون برنامه خارجی که معمولاً از آن تازهسازی میشود در دسترس نیست.- فیلدهای استناد و کتابشناسی تنها زمانی بهدرستی رندر میشوند که زیرساخت سند
Sourceوجود داشته باشند – ببینید راهنمای کتابشناسی برای ساختن آنها.
مشکلات رایج
| مسئله | دلیل | رفع |
|---|---|---|
فیلد REF / PAGEREF / NOTEREF نتیجهای خطا نشان میدهد | BookmarkName که هدف آن است در سند وجود ندارد | نشانهگذاری را با DocumentBuilder.StartBookmark() / EndBookmark() قبل از بهروزرسانی فیلد ایجاد کنید |
فیلد ASK / FILLIN مانع بهروزرسانی خودکار میشود | هیچ IFieldUserPromptRespondentی اختصاص داده نشده است | FieldOptions.UserPromptRespondent را اختصاص دهید، یا DefaultResponse را روی فیلد تنظیم کنید |
فیلد CITATION یا BIBLIOGRAPHY خالی نمایش داده میشود | SourceTag با هیچ Sourceی در دادههای کتابشناسی سند مطابقت ندارد | مطابقت را اضافه کنید Source – ببینید راهنمای کتابشناسی |
DDE / DDEAUTO / LINK فیلد تازه نمیشود | اینها به منبع خارجی OLE ارجاع میدهند که در محیط فعلی در دسترس نیست | منتظر میشود خارج از زمینه اصلی Windows/OLE باشد – Result ذخیرهشده را به عنوان آخرین مقدار شناختهشده در نظر بگیرید |
FAQ
تفاوت FieldRef و FieldStyleRef چیست؟
FieldRef به محتوایی در یک نشانگر نامگذاریشده (BookmarkName) ارجاع میدهد؛ FieldStyleRef به جای آن به نزدیکترین پاراگرافی که با StyleName قالببندی شده است، مستقل از نشانگرها، ارجاع میکند.
چگونه میتوانم یک پیوند ساده را بدون ساختن دستی Field وارد کنم؟
فراخوانی DocumentBuilder.InsertHyperlink().
آیا این کلاسهای فیلد پیوند و مرجع در فضای نامی جداگانهای نسبت به سایر فیلدها قرار دارند؟
خیر – FieldHyperlink, FieldRef, FieldCitation، و بقیه کلاسهای این صفحه عادی هستند Field زیرکلاسها در Aspose.Words.Fields فضاینام، همان فضاینامی که در راهنمای فیلدها.
فیلدهای استنادی چگونه به مدل دادهای کتابشناسی مرتبط میشوند؟
FieldCitation and FieldBibliography محتوا را با جستجو render کنید SourceTag در برابر Source رکوردهای توصیف شده در راهنمای کتابشناسی – کلاسهای فیلد رندرینگ را مدیریت میکنند، و Source / Contributor کلاسها دادههای زیرین را نگهداری میکنند.
خلاصه API Reference
| کلاس | توضیح |
|---|---|
FieldHyperlink | HYPERLINK فیلد؛ Address, SubAddress, ScreenTip, OpenInNewWindow |
FieldRef / FieldPageRef / FieldNoteRef | REF / PAGEREF / NOTEREF فیلدها؛ محتوا را در BookmarkName حل کنید |
FieldStyleRef | فیلد STYLEREF؛ به نزدیکترین پاراگراف در یک سبک دادهشده حل میشود |
FieldSet | فیلد SET؛ مقدار متنی نشانکگذاریشدهای را برای REF تعریف میکند تا حل شود |
FieldAsk / FieldFillIn | فیلدهای ASK / FILLIN؛ هنگام بهروزرسانی برای مقدار درخواست میکند |
FieldDde / FieldDdeAuto / FieldLink | فیلدهای DDE / DDEAUTO / LINK؛ محتوای خارجی لینکدار OLE قدیمی |
FieldImport / FieldIncludePicture | فیلدهای IMPORT / INCLUDEPICTURE؛ محتوای گرافیکی خارجی |
FieldInclude / FieldIncludeText | فیلدهای INCLUDE / INCLUDETEXT؛ سند خارجی یا محتوای XML |
FieldAutoText / FieldAutoTextList / FieldGlossary | AUTOTEXT / AUTOTEXTLIST / GLOSSARY فیلدها؛ ارجاع به ورودیهای بلوکساز |
FieldCitation / FieldBibliography | CITATION / BIBLIOGRAPHY فیلدها؛ رندر دادههای منبع کتابنامه |
FieldQuote / FieldShape | QUOTE / SHAPE فیلدها؛ متن صریح فیلد |
DocumentBuilder.InsertHyperlink | میانبر درج پیوند سطح بالا |
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmark | ایجاد نشانک و ناوبری برای اهداف مرجع |