کار با پیوندها و مراجع

کار با پیوندها و مراجع

بررسی کلی

کدهای فیلد پیوند و ارجاع متقاطع 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 (به راهنمای فیلدها) قبل از به‌روزرسانی سندی که شامل FieldAsk or FieldFillIn فیلدها در یک خط لوله بدون نظارت.
  • 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

کلاستوضیح
FieldHyperlinkHYPERLINK فیلد؛ Address, SubAddress, ScreenTip, OpenInNewWindow
FieldRef / FieldPageRef / FieldNoteRefREF / 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 / FieldGlossaryAUTOTEXT / AUTOTEXTLIST / GLOSSARY فیلدها؛ ارجاع به ورودی‌های بلوک‌ساز
FieldCitation / FieldBibliographyCITATION / BIBLIOGRAPHY فیلدها؛ رندر داده‌های منبع کتاب‌نامه
FieldQuote / FieldShapeQUOTE / SHAPE فیلدها؛ متن صریح فیلد
DocumentBuilder.InsertHyperlinkمیانبر درج پیوند سطح بالا
DocumentBuilder.StartBookmark / EndBookmark / MoveToBookmarkایجاد نشانک و ناوبری برای اهداف مرجع

همچنین ببینید:

 فارسی