Bağlantılar ve Referanslarla Çalışma

Bağlantılar ve Referanslarla Çalışma

Word’ün bağlantı ve çapraz referans alan kodları – HYPERLINK, REF, PAGEREF, NOTEREF, STYLEREF, SET, ASK, FILLIN, CITATION, BIBLIOGRAPHY, ve daha fazlası – her biri ayrı bir Field alt sınıf içinde Aspose.Words FOSS için .NET. Bu sınıfların tümü şurada bulunur Aspose.Words.Fields ad alanında diğer tüm alan türleriyle birlikte; bu sayfa özellikle bağlantılar, çapraz referanslar, istenen değerler ve atıflarla ilgili olanları gruplar ve her birinin ne sunduğunu açıklar.

Hyperlinks

FieldHyperlink, HYPERLINK alanını temsil eder: Address ve SubAddress hedef URL’yi veya belgedeki konumu tutar, ScreenTip üzerine gelindiğinde gösterilen ipucu metnini ayarlar, OpenInNewWindow ve IsImageMap görüntüleme bayraklarıdır ve Target bir tarayıcı çerçevesinin adını belirtir. Basit durumlarda, DocumentBuilder.InsertHyperlink() bir köprü alanını doğrudan ekler ve Field nesnesini elle oluşturmaya gerek kalmaz.

Yer İşaretlerine Çapraz Referanslar

FieldRef (REF alanı), FieldPageRef (PAGEREF) ve FieldNoteRef (NOTEREF) her biri, BookmarkName özelliği aracılığıyla isimlendirilmiş bir yer işaretindeki içeriğe çözülür; InsertHyperlink ve InsertRelativePosition referansın tıklanabilir olup olmadığını ve göreceli bir konumu (“yukarı” / “aşağı”) raporlayıp raporlamadığını kontrol eder. FieldRef, paragraf numaralandırma seçeneklerini (InsertParagraphNumber, InsertParagraphNumberInFullContext, InsertParagraphNumberInRelativeContext, NumberSeparator) ve IncludeNoteOrComment ekler. FieldStyleRef (STYLEREF) ise, verilen bir StyleName ile biçimlendirilmiş en yakın paragrafı çözer; SearchFromBottom alanın konumundan geriye doğru arama yapar. Bu alanların hedeflediği yer işaretleri DocumentBuilder.StartBookmark() ve EndBookmark() ile oluşturulur ve MoveToBookmark() ile gezilebilir. FieldSet (SET) yer işaretli bir metin değerini tanımlar – BookmarkName ve BookmarkText – ki başka bir yerdeki bir REF alanı bunu çözebilir.

İstenen Değer Alanları

FieldAsk (ASK) ve FieldFillIn (FILLIN) alanı güncelleyen kişiden bir değer talep eder: PromptText kullanıcıya gösterilir, DefaultResponse yedek bir seçenek sağlar ve PromptOnceOnMailMerge posta birleştirme sırasında yinelenen istemleri sınırlar. FieldAsk ek olarak yanıtını şu adreste saklar BookmarkName diğer alanların referans alması için. Bakınız alanlar rehberi for IFieldUserPromptRespondent, bu alanlara yanıtları etkileşimli olarak istemek yerine programlı olarak sağlayan geri çağırma.

Harici ve Bağlantılı İçerik

FieldDde (DDE) ve FieldDdeAuto (DDEAUTO) ProgId, SourceFullName ve SourceItem aracılığıyla başka bir uygulamadaki içeriğe bağlanır, InsertAsText, InsertAsHtml, InsertAsPicture, InsertAsRtf, InsertAsUnicode ve InsertAsBitmap eklenen temsili seçerken, AutoUpdate / IsLinked yenileme davranışını kontrol eder. FieldLink (LINK) OLE-bağlantı eşdeğeridir ve FormatUpdateType ekler. FieldImport (IMPORT) ve FieldIncludePicture (INCLUDEPICTURE) SourceFullName ve GraphicFilter aracılığıyla harici bir grafik çeker. FieldInclude (INCLUDE) ve FieldIncludeText (INCLUDETEXT) harici belge içeriğini çeker, BookmarkName eklenen aralığı sınırlamak için ve LockFields yenilenmesini önlemek için kullanılır; FieldIncludeText ayrıca XML kaynaklarını Encoding, MimeType, NamespaceMappings, XPath ve XslTransformation aracılığıyla destekler.

AutoText ve Sözlük Referansları

FieldAutoText (AUTOTEXT), FieldAutoTextList (AUTOTEXTLIST) ve FieldGlossary (GLOSSARY) hepsi EntryName aracılığıyla adlandırılmış bir yapı-bloğu girişine referans verir; FieldAutoTextList liste-stili sunumu için ListStyle ve ScreenTip ekler.

Alıntı ve Bibliyografi Alanları

FieldCitation (CITATION) ve FieldBibliography (BIBLIOGRAPHY) belge bibliyografya verilerinden alınan içeriği render eder. FieldCitation.SourceTag (ve alternatif AnotherSourceTag) hangi kaynağa atıfta bulunduğunu belirler, ile Prefix, Suffix, PageNumber, VolumeNumber, ve Suppress* bayraklar (SuppressAuthor, SuppressTitle, SuppressYear) atıfın nasıl biçimlendirileceğini kontrol eder. FieldBibliography.SourceTag, FilterLanguageId, ve FormatLanguageId hangi kaynakların render edilmiş bibliyografyada görüneceğini ve hangi dilde olacağını kontrol eder. Temel kaynak bu alanları render eder – Source, Contributor, Person – şunlarda ele alınmıştır bibliyografya rehberi.

Alıntı ve Şekil Metin Alanları

FieldQuote (QUOTE) ve FieldShape (SHAPE) her ikisi de gerçek alan metnini tutan bir Text özelliği ortaya çıkarır — FieldQuote bunu doğrudan alanın konumuna ekler, FieldShape ise bir çizim şeklinin metin taşıyan alan kodu ile ilişkilendirir.

İpuçları ve En İyi Uygulamalar

• DocumentBuilder.InsertHyperlink()‘ı doğrudan bir köprü eklemek için tercih edin; FieldHyperlink‘ı yalnızca ScreenTip veya IsImageMap gibi, oluşturucu kısayolunun sunmadığı özelliklere ihtiyaç duyduğunuzda doğrudan oluşturun.
• FieldRef, FieldPageRef, FieldNoteRef ve FieldSet hepsi BookmarkName aracılığıyla koordine olur — alanın referans verdiği hedef yer iminin (DocumentBuilder.StartBookmark() / EndBookmark() ile) güncellenmeden önce var olduğundan emin olun.
• Ayar FieldOptions.UserPromptRespondent (bkz. alanlar rehberi) güncellemeden önce belge içeren FieldAsk or FieldFillIn alanları denetimsiz bir işlem hattında.
• FieldDde ve FieldDdeAuto, eski bir Windows OLE bağlama mekanizmasını modellemiştir — AutoUpdate ve IsLinked‘ü, dış uygulamanın mevcut olmaması nedeniyle Windows dışı belge işleme sırasında yalnızca bilgilendirici olarak ele alın.
• Alıntı ve bibliyografya alanları yalnızca belgenin temel Source kayıtlar mevcut – bakınız bibliyografya kılavuzu bunları oluşturmak için.

Yaygın Sorunlar

FAQ

FieldRef ile FieldStyleRef arasındaki fark nedir?

FieldRef, adlandırılmış bir yer imindeki içeriğe karşılık gelir (BookmarkName); FieldStyleRef ise yer imlerinden bağımsız olarak verilen StyleName ile biçimlendirilmiş en yakın paragrafı hedef alır.

Bir Field elle oluşturmadan basit bir hiperlinki nasıl eklerim?

DocumentBuilder.InsertHyperlink()‘ı çağırın.

Bu bağlantı ve referans alan sınıfları diğer alanlardan ayrı bir ad alanında mı?

Hayır – FieldHyperlink, FieldRef, FieldCitation, ve bu sayfadaki sınıfların geri kalanı sıradan Field alt sınıflar Aspose.Words.Fields ad alanı, aynı ad alanı şurada ele alınan alanlar rehberi.

Atıf alanları bibliyografi veri modeliyle nasıl ilişkilidir?

FieldCitation and FieldBibliography içeriği, arama yaparak render et SourceTag karşı Source kayıtlar açıklanmıştır bibliyografya rehberi – alan sınıfları renderlemeyi yönetir ve Source / Contributor sınıflar temel verileri tutar.

API Reference Özeti

Ayrıca Bakınız

• Aspose.Words for .NET — Enterprise Documentation