## FieldRef class REF alanını uygular. Daha fazla bilgi edinmek için şu adresi ziyaret edin:[Alanlarla Çalışma](https://docs.aspose.com/words/net/working-with-fields/) belgeleme makalesi. ```csharp public class FieldRef : Field ``` ## yapıcılar | İsim | Tanım | | --- | --- | | [FieldRef](fieldref/)() | Default_Constructor | ## Özellikleri | İsim | Tanım | | --- | --- | | [BookmarkName](../../aspose.words.fields/fieldref/bookmarkname/) { get; set; } | Başvurulan yer iminin adını alır veya ayarlar. | | [DisplayResult](../../aspose.words.fields/field/displayresult/) { get; } | Görüntülenen alan sonucunu temsil eden metni alır. | | [End](../../aspose.words.fields/field/end/) { get; } | Alan sonunu temsil eden düğümü alır. | | [Format](../../aspose.words.fields/field/format/) { get; } | Bir tane alır[`FieldFormat`](../fieldformat/)alanın biçimlendirmesine yazılmış erişim sağlayan nesne. | | [IncludeNoteOrComment](../../aspose.words.fields/fieldref/includenoteorcomment/) { get; set; } | Yer imi tarafından işaretlenen dipnot, sonnot ve açıklama numaralarının artırılıp artırılmayacağını alır veya ayarlar ve karşılık gelen dipnot, sonnot ve yorum metnini ekler. | | [InsertHyperlink](../../aspose.words.fields/fieldref/inserthyperlink/) { get; set; } | Yer imlerine eklenen paragrafa bir köprü metni oluşturulup oluşturulmayacağını alır veya ayarlar. | | [InsertParagraphNumber](../../aspose.words.fields/fieldref/insertparagraphnumber/) { get; set; } | Başvurulan paragrafın paragraf numarasının belgede göründüğü gibi eklenip eklenmeyeceğini alır veya ayarlar. | | [InsertParagraphNumberInFullContext](../../aspose.words.fields/fieldref/insertparagraphnumberinfullcontext/) { get; set; } | Başvurulan paragrafın paragraf numarasının tam bağlamda eklenip eklenmeyeceğini alır veya ayarlar. | | [InsertParagraphNumberInRelativeContext](../../aspose.words.fields/fieldref/insertparagraphnumberinrelativecontext/) { get; set; } | Başvurulan paragrafın paragraf numarasının bağıl bağlamda eklenip eklenmeyeceğini alır veya ayarlar. | | [InsertRelativePosition](../../aspose.words.fields/fieldref/insertrelativeposition/) { get; set; } | Başvurulan paragrafın göreli konumunun eklenip eklenmeyeceğini alır veya ayarlar. | | [IsDirty](../../aspose.words.fields/field/isdirty/) { get; set; } | Belgede yapılan diğer değişiklikler nedeniyle alanın geçerli sonucunun artık doğru (eski) olup olmadığını alır veya ayarlar. | | [IsLocked](../../aspose.words.fields/field/islocked/) { get; set; } | Alanın kilitli olup olmadığını alır veya ayarlar (sonucunu yeniden hesaplamamalıdır). | | [LocaleId](../../aspose.words.fields/field/localeid/) { get; set; } | Alanın LCID'sini alır veya ayarlar. | | [NumberSeparator](../../aspose.words.fields/fieldref/numberseparator/) { get; set; } | Sıra numaralarını ve sayfa numaralarını ayırmak için kullanılan karakter dizisini alır veya ayarlar. | | [Result](../../aspose.words.fields/field/result/) { get; set; } | Alan ayırıcısı ile alan sonu arasındaki metni alır veya ayarlar. | | [Separator](../../aspose.words.fields/field/separator/) { get; } | Alan ayırıcısını temsil eden düğümü alır.`hükümsüz` . | | [Start](../../aspose.words.fields/field/start/) { get; } | Alanın başlangıcını temsil eden düğümü alır. | | [SuppressNonDelimiters](../../aspose.words.fields/fieldref/suppressnondelimiters/) { get; set; } | Ayırıcı olmayan karakterlerin bastırılıp bastırılmayacağını alır veya ayarlar. | | virtual [Type](../../aspose.words.fields/field/type/) { get; } | Microsoft Word alan türünü alır. | ## yöntemler | İsim | Tanım | | --- | --- | | [GetFieldCode](../../aspose.words.fields/field/getfieldcode/)() | Alan başlangıcı ile alan ayırıcısı (veya ayırıcı yoksa alan sonu) arasındaki metni döndürür. Hem alan kodu hem de alt alanların alan sonucu dahil edilir. | | [GetFieldCode](../../aspose.words.fields/field/getfieldcode/)(*bool*) | Alan başlangıcı ile alan ayırıcısı (veya ayırıcı yoksa alan sonu) arasındaki metni döndürür. | | [Remove](../../aspose.words.fields/field/remove/)() | Alanı belgeden kaldırır. Alanın hemen ardından bir düğüm döndürür. Alanın sonu, üst düğümünün son alt 'siyse, üst paragrafını döndürür. Alan zaten kaldırılmışsa, şunu döndürür`hükümsüz` . | | [Unlink](../../aspose.words.fields/field/unlink/)() | Alan bağlantısını kaldırma işlemini gerçekleştirir. | | [Update](../../aspose.words.fields/field/update/)() | Alan güncellemesini gerçekleştirir. Alan zaten güncelleniyorsa fırlatır. | | [Update](../../aspose.words.fields/field/update/)(*bool*) | Bir alan güncellemesi gerçekleştirir. Alan zaten güncelleniyorsa fırlatır. | ## Notlar Belirtilen yer imi tarafından temsil edilen metni veya grafikleri ekler. ## Örnekler SET alanıyla yer imli metnin nasıl oluşturulacağını ve ardından REF alanı kullanılarak belgede nasıl görüntüleneceğini gösterir. ```csharp Document doc = new Document(); DocumentBuilder builder = new DocumentBuilder(doc); // SET alanı ile yer imli metni adlandırın. // Bu alan, metin içerisinde görünen bir yer imi yapısına değil, adlandırılmış bir değişkene atıfta bulunur. FieldSet fieldSet = (FieldSet)builder.InsertField(FieldType.FieldSet, false); fieldSet.BookmarkName = "MyBookmark"; fieldSet.BookmarkText = "Hello world!"; fieldSet.Update(); Assert.AreEqual(" SET MyBookmark \"Hello world!\"", fieldSet.GetFieldCode()); // REF alanında yer imine adıyla başvur ve içeriğini görüntüle. FieldRef fieldRef = (FieldRef)builder.InsertField(FieldType.FieldRef, true); fieldRef.BookmarkName = "MyBookmark"; fieldRef.Update(); Assert.AreEqual(" REF MyBookmark", fieldRef.GetFieldCode()); Assert.AreEqual("Hello world!", fieldRef.Result); doc.Save(ArtifactsDir + "Field.SET.REF.docx"); ``` Yer imlerine referans vermek için REF alanlarının nasıl ekleneceğini gösterir. ```csharp public void FieldRef() { Document doc = new Document(); DocumentBuilder builder = new DocumentBuilder(doc); builder.StartBookmark("MyBookmark"); builder.InsertFootnote(FootnoteType.Footnote, "MyBookmark footnote #1"); builder.Write("Text that will appear in REF field"); builder.InsertFootnote(FootnoteType.Footnote, "MyBookmark footnote #2"); builder.EndBookmark("MyBookmark"); builder.MoveToDocumentStart(); // Şu anda hangi liste seviyesinde olduğumuzu gösteren açılı parantez miktarının bulunduğu özel bir liste biçimi uygulayacağız. builder.ListFormat.ApplyNumberDefault(); builder.ListFormat.ListLevel.NumberFormat = "> \x0000"; // Yer imimizin içindeki metni içerecek, köprü metni görevi görecek ve yer iminin dipnotlarını kopyalayacak bir REF alanı ekleyin. FieldRef field = InsertFieldRef(builder, "MyBookmark", "", "\n"); field.IncludeNoteOrComment = true; field.InsertHyperlink = true; Assert.AreEqual(" REF MyBookmark \\f \\h", field.GetFieldCode()); // Bir REF alanı ekle ve başvurulan yer iminin onun üstünde mi yoksa altında mı olduğunu görüntüle. field = InsertFieldRef(builder, "MyBookmark", "The referenced paragraph is ", " this field.\n"); field.InsertRelativePosition = true; Assert.AreEqual(" REF MyBookmark \\p", field.GetFieldCode()); // Yer iminin liste numarasını belgede göründüğü gibi görüntüle. field = InsertFieldRef(builder, "MyBookmark", "The bookmark's paragraph number is ", "\n"); field.InsertParagraphNumber = true; Assert.AreEqual(" REF MyBookmark \\n", field.GetFieldCode()); // Yer iminin liste numarasını görüntüler, ancak açılı parantezler gibi sınırlayıcı olmayan karakterleri atlar. field = InsertFieldRef(builder, "MyBookmark", "The bookmark's paragraph number, non-delimiters suppressed, is ", "\n"); field.InsertParagraphNumber = true; field.SuppressNonDelimiters = true; Assert.AreEqual(" REF MyBookmark \\n \\t", field.GetFieldCode()); // Bir liste düzeyi aşağı in. builder.ListFormat.ListLevelNumber++; builder.ListFormat.ListLevel.NumberFormat = ">> \x0001"; // Yer iminin liste numarasını ve üstündeki tüm liste seviyelerinin numaralarını görüntüle. field = InsertFieldRef(builder, "MyBookmark", "The bookmark's full context paragraph number is ", "\n"); field.InsertParagraphNumberInFullContext = true; Assert.AreEqual(" REF MyBookmark \\w", field.GetFieldCode()); builder.InsertBreak(BreakType.PageBreak); // Bu REF alanı ile referans aldığı yer imi arasındaki liste düzeyi numaralarını görüntüle. field = InsertFieldRef(builder, "MyBookmark", "The bookmark's relative paragraph number is ", "\n"); field.InsertParagraphNumberInRelativeContext = true; Assert.AreEqual(" REF MyBookmark \\r", field.GetFieldCode()); // Belgenin sonunda yer imi burada bir liste öğesi olarak gösterilecektir. builder.Writeln("List level above bookmark"); builder.ListFormat.ListLevelNumber++; builder.ListFormat.ListLevel.NumberFormat = ">>> \x0002"; doc.UpdateFields(); doc.Save(ArtifactsDir + "Field.REF.docx"); } /// /// Belge oluşturucusunun bir REF alanı eklemesini, bununla bir yer imine referans vermesini ve önüne ve arkasına metin eklemesini sağlayın. /// private static FieldRef InsertFieldRef(DocumentBuilder builder, string bookmarkName, string textBefore, string textAfter) { builder.Write(textBefore); FieldRef field = (FieldRef)builder.InsertField(FieldType.FieldRef, true); field.BookmarkName = bookmarkName; builder.Write(textAfter); return field; } ``` ### Ayrıca bakınız * class [Field](../field/) * ad alanı [Aspose.Words.Fields](../../aspose.words.fields/) * toplantı [Aspose.Words](../../)